Rendering sprites from spritesheet with OpenGL?

6
votes

Imagine the following scenario: you have a set of RPG character spritesheets in PNG format and you want to use them in an OpenGL application.

The separate characters are (usually) 16 by 24 pixels in size (that is, 24 pixels tall) and may be at any width and height without leaving padding. Kinda like this:

Terra, from Final Fantasy VI
(source: kafuka.org)

I already have the code to determine an integer-based clipping rectangle given a frame index and size:

int framesPerRow = sheet.Width / cellWidth;
int framesPerColumn = sheet.Height / cellHeight;
framesTotal = framesPerRow * framesPerColumn;
int left = frameIndex % framesPerRow;
int top = frameIndex / framesPerRow;
//Clipping rect's width and height are obviously cellWidth and cellHeight.

Running this code with frameIndex = 11, cellWidth = 16, cellHeight = 24 would return a cliprect (32, 24)-(48, 48) assuming it's Right/Bottom opposed to Width/Height.

The actual question

Now, given a clipping rectangle and an X/Y coordinate to place the sprite on, how do I draw this in OpenGL? Having the zero coordinate in the top left is preferred.

4
openglsprite
Is your question asking how to extract and render a particular sprite? It's unclear what you mean by draw. - Dana the Sane
If you are doing this on a phone you might be limited to an opengl where textures have to be a power of 2. You might also want to save space by having a separate top/bottom half of each character image - it looks like you have a lot of poses where only the head/legs differ. - Martin Beckett
Dana: pretty much that, yeah. mgb: I'm not doing this on a phone. - Kawa
Fun fact for mgb: the original FF6 sprite data was indeed compacted in such a way. But since such a size difference is hardly an issue here... - Kawa

4 Answers

8
votes

You have to start thinking in "texture space" where the coordinates are in the range [0, 1].

So if you have a sprite sheet:

class SpriteSheet {
    int spriteWidth, spriteHeight;
    int texWidth, texHeight;

    int tex;

public:
    SpriteSheet(int t, int tW, int tH, int sW, int sH)
    : tex(t), texWidth(tW), texHeight(tH), spriteWidth(sW), spriteHeight(sH)
    {}

    void drawSprite(float posX, float posY, int frameIndex);
};

All you have to do is submit both vertices and texture vertices to OpenGL:

    void SpriteSheet::drawSprite(float posX, float posY, int frameIndex) {
        const float verts[] = {
            posX, posY,
            posX + spriteWidth, posY,
            posX + spriteWidth, posY + spriteHeight,
            posX, posY + spriteHeight
        };
        const float tw = float(spriteWidth) / texWidth;
        const float th = float(spriteHeight) / texHeight;
        const int numPerRow = texWidth / spriteWidth;
        const float tx = (frameIndex % numPerRow) * tw;
        const float ty = (frameIndex / numPerRow + 1) * th;
        const float texVerts[] = {
            tx, ty,
            tx + tw, ty,
            tx + tw, ty + th,
            tx, ty + th
        };

        // ... Bind the texture, enable the proper arrays

        glVertexPointer(2, GL_FLOAT, verts);
        glTexCoordPointer(2, GL_FLOAT, texVerts);
        glDrawArrays(GL_TRI_STRIP, 0, 4);
    }

};
7
votes

Franks solution is already very good.

Just a (very important) sidenote, since some of the comments suggested otherwise.

Please don't ever use glBegin/glEnd. Don't ever tell someone to use it.

The only time it is OK to use glBegin/glEnd is in your very first OpenGL program.

Arrays are not much harder to handle, but...

  • ... they are faster.
  • ... they will still work with newer OpenGL versions.
  • ... they will work with GLES.
  • ... loading them from files is much easier.
0
votes

I'm assuming you're learning OpenGL and only needs to get this to work somehow. If you need raw speed, there's shaders and vertex buffers and all sorts of both neat and complicated things.

The simplest way is to load the PNG into a texture (assuming you have the ability to load images into memory, you do need htat), then draw it with a quad setting appropriate texture coordinates (they go from 0 to 1 with floating point coordinates, so you need to divide by texture width or height accordingly).

Use glBegin(GL_QUADS), glTexcoord2f(), glVertex2f(), glEnd() for the simplest (but not fastest) way to draw this.

For making zero top left, either use gluOrtho() to set up the view matrix differently from normal GL (look up the docs for that function, set top to 0 and bottom to 1 or screen_height if you want integer coords) or just make change your drawing loop and just do glVertex2f(x/screen_width, 1-y/screen_height).

There are better and faster ways to do this, but this is probably one of the easiest if you're learning raw OpenGL from scratch.

0
votes

A suggestion, if I may. I use SDL to load my textures, so what I did is : 1. I loaded the texture 2. I determined how to separate the spritesheet into separate sprites. 3. I split them into separate surfaces 4. I make a texture for each one (I have a sprite class to manage them). 5. Free the surfaces. This takes more time (obviously) on loading, but pays of later. This way it's a lot easier (and faster), as you only have to calculate the index of the texture you want to display, and then display it. Then, you can scale/translate it as you like and call a display list to render it to whatever you want. Or, you could do it in immediate mode, either works :)