• Announcements

    • khawk

      Download the Game Design and Indie Game Marketing Freebook   07/19/17

      GameDev.net and CRC Press have teamed up to bring a free ebook of content curated from top titles published by CRC Press. The freebook, Practices of Game Design & Indie Game Marketing, includes chapters from The Art of Game Design: A Book of Lenses, A Practical Guide to Indie Game Marketing, and An Architectural Approach to Level Design. The GameDev.net FreeBook is relevant to game designers, developers, and those interested in learning more about the challenges in game development. We know game development can be a tough discipline and business, so we picked several chapters from CRC Press titles that we thought would be of interest to you, the GameDev.net audience, in your journey to design, develop, and market your next game. The free ebook is available through CRC Press by clicking here. The Curated Books The Art of Game Design: A Book of Lenses, Second Edition, by Jesse Schell Presents 100+ sets of questions, or different lenses, for viewing a game’s design, encompassing diverse fields such as psychology, architecture, music, film, software engineering, theme park design, mathematics, anthropology, and more. Written by one of the world's top game designers, this book describes the deepest and most fundamental principles of game design, demonstrating how tactics used in board, card, and athletic games also work in video games. It provides practical instruction on creating world-class games that will be played again and again. View it here. A Practical Guide to Indie Game Marketing, by Joel Dreskin Marketing is an essential but too frequently overlooked or minimized component of the release plan for indie games. A Practical Guide to Indie Game Marketing provides you with the tools needed to build visibility and sell your indie games. With special focus on those developers with small budgets and limited staff and resources, this book is packed with tangible recommendations and techniques that you can put to use immediately. As a seasoned professional of the indie game arena, author Joel Dreskin gives you insight into practical, real-world experiences of marketing numerous successful games and also provides stories of the failures. View it here. An Architectural Approach to Level Design This is one of the first books to integrate architectural and spatial design theory with the field of level design. The book presents architectural techniques and theories for level designers to use in their own work. It connects architecture and level design in different ways that address the practical elements of how designers construct space and the experiential elements of how and why humans interact with this space. Throughout the text, readers learn skills for spatial layout, evoking emotion through gamespaces, and creating better levels through architectural theory. View it here. Learn more and download the ebook by clicking here. Did you know? GameDev.net and CRC Press also recently teamed up to bring GDNet+ Members up to a 20% discount on all CRC Press books. Learn more about this and other benefits here.
  • entries
  • comments
  • views

Isometric Map in SFML



In my ever-so-humble opinion, "traditional" 2D isometric games (ie, games implemented using only 2D techniques to fake an isometric viewpoint) are as dead as last week's meatloaf. Traditional techniques present a number of problems that are solved by hacks and kludges, but which are solved much more elegantly via a 3D approach. Nevertheless, when someone is just starting out with game programming, 3D can be intimidating. Also, maybe you're looking to go retro, and while 3D can benefit even a retro style, still it might be more feasible to implement a traditional 2D system. I personally rarely use traditional 2D in my own projects anymore, but I found this on my hard-drive and updated it. The system is based on the original 2D system upon which I built my older game, Golem, albeit modified to work with SFML.

Presented here is an example of how you might go about implementing a traditional 2D isometric map using SFML. I chuckle as I write this, since SFML is just a 2D front-end sitting on top of OpenGL which is, of course, a 3D API. Nevertheless, SFML is implemented to be a 2D library, and so it might be nice to have an isometric map system that works with SFML without having to delve into OpenGL.

At the end of this article, we will have a working 2D isometric map of arbitrary size, with a basic tile-based lighting scheme, suitable for some sort of graphical roguelike or other 2D RPG-type game. I will provide all of the code, and a working demo. I will discuss the structure of the map, the organization of the lighting scheme, how it all fits together with SFML. I will also touch on a few of the issues and caveats that crop up when using an old-school 2D system, and why using 3D makes things so much easier.

To see what we are shooting for, here are a couple screenshots of the final product:


Now, I explain in the remainder of this post how the system works. If you don't care, already know enough about isometric maps, etc... and just want to get to the code, here is the archive:


Included is all the source, including source to bind SFML to Lua, the isometric map code presented here, and a small sample Lua application demonstrating the system. Tinker to your heart's content. Be warned, though, that this has been sitting on my harddrive mostly untouched for a couple years now, and there might be bugs a-lurking. Since it's not code I commonly use, it hasn't been very thoroughly tested.

The Map, Basics

First of all, this isn't really isometric. See (Axonometric Projections) for an explanation of the various types of projections that are collectively referred to as "isometric" when talking about games. The scheme I prefer is the dimetric projection with an azimuth angle of 30 degrees.


This results in tiles that are twice as wide as they are tall on screen, and is the "typical" axonometric projection used in games such as Diablo and Diablo 2. The 2:1 tile ratio size makes creating artwork for the game a bit more convenient, and the math for dealing with this type of projection is very simple. The camera is also rotated around the Up Axis by 45 degrees. When viewed from this angle, here is what a cube looks like:


You can see how the top of the cube forms a diamond. This diamond is exactly twice as wide as it is tall. This is our 2:1 projection. Of course, when using pure 2D techniques, we don't worry about rotating the camera at all. 2D "fakes" this perspective using specially-crafted graphics and a layering system. You merely are drawing 2D images directly on-screen in a fashion that mimics a 3D view.

With questions of view angle out of the way, we can get down to the map. The map is going to be a simple 2D array of cells, where each cell is a box. The box can have a floor, a roof, and 2 walls along the front edges of the cell. It can also contain some set of objects, possibly dynamic. The cube in the previous image is a good representation of this. The top diamond is the roof, the floor (which is blocked by the walls) is also a diamond, and the left and right walls can be seen connecting the roof to the floor. The map will be a whole array of these boxes. Some boxes won't have any walls or roofs, and will be floor only, plus any objects. Others may have only walls, with no need of a roof. Still others may be roof only. Boxes also act as containers for objects that can move around.

When a map is created, the size of the boxes must be specified, especially the X and Y sizes (width and length), as these determine the size of the world space. Since we are using cells that are equally sized along X and Y, we will denote the cell dimensions as NodeSize. One node is NodeSize units wide, NodeSize units deep, and an arbitrary number of units tall. (Height of a box does play a part in rendering, but less of an important part than width and depth).

Now, since this system is based on SFML, it makes sense to make each of our various drawable types (walls, floor, roof, objects) to be of type sf::Sprite. A Sprite associates an image to draw with a set of data describing where to draw it, how large to draw it, etc... However, the position, orientation, and so forth, of the sprite is interpreted as the on-screen position/orientation in which to draw the sprite. A Sprite doesn't have any knowledge of world coordinates, just screen coordinates.

In this kind of isometric view, world coordinates are different than screen coordinates. Screen coordinates are used only for drawing on the screen, and they represent a modified form of the world coordinates; a projection of the world coordinates onto the screen, so to speak. World coordinates represent a given object's location in the world, and operate within the grid of boxes that comprise the map. These coordinates are actually 3-dimensional, since an object can be located above the ground. So each object in the world actually has 2 sets of coordinates that must be tracked, and since a Sprite can only have a single position (the screen coordinates) we need to extend sf::Sprite to incorporate a world position. This is pretty simple:


class IsometricMapSprite : public sf::Sprite
IsometricMapSprite(const sf::Image &image, const sf::Vector2f &position=sf::Vector2f(0,0),
const sf::Vector2f &scale=sf::Vector2f(1,1), float rotation=0.f, const sf::Color &color=sf::Color(255,255,255,255));

void SetWorldPosition(float x, float y);
void SetWorldPosition(const sf::Vector2f &position);
sf::Vector2f GetWorldPosition() const;

void SetWorldZ(float z);
float GetWorldZ(){return m_z;}

void setUseLighting(bool use){m_uselighting=use;}
bool getUseLighting(){return m_uselighting;}

sf::Vector2f m_worldpos;
float m_z;
bool m_uselighting;


The IsometricMapSprite directly inherits from sf::Sprite, and adds a few members and methods for maintaining a world position and Z-height above the ground. (There is also a member, m_uselighting, which I will get to in a bit, in the section on lighting). The interesting parts of the class are SetWorldPosition and SetWorldZ. These methods will set the world coordinates of the object, and will calculate the on-screen coordinates for the sprite for later rendering.

Converting From Screen to World and World to Screen

Since we have two different coordinate spaces, we need to be able to convert a point from one to the other. Screen space is the 2D rectangular view-space of the screen. When a window's default View is set, Screen(0,0) is located at the upper left hand corner of the screen, Screen(W,H) is located at the lower right corner and is dependent, of course, on the size of the viewport. The view is actually just a rather small window into screen space, which is theoretically infinite; using the sf::View:SetCenter method, you can move the view rectangle around to view different parts of screen space. The World Space is different. World(0,0) is located in the very upper-left corner of of the world cell whose map index is [0][0], World(NodeSize,NodeSize) is located in the world cell whose map index is [1][1], and so forth. The World space is the space in which gameplay mechanics, object movement and interaction, and so forth take place. World Space is bounded by the dimensions of the map in cells (the size of the map array) multipled by the NodeSize parameter. So a map with (128,128) cells and a NodeSize of 32 has a World Space of (4096,4096). All objects in the world must have coordinates within the range (0,0)-(4096,4096) or they will lie beyond the edges of the map.

The equations to convert between World and Screen spaces are actually fairly simple:

// Function to convert a world position to a screen (view) position
// ScreenX = 2*WorldX - 2*WorldY
// ScreenY = WorldX + WorldY
sf::Vector2f WorldToScreen(sf::Vector2f v)
return sf::Vector2f(2.0f*v.x - 2.0f*v.y, v.x + v.y);

// Function to convert a screen (view) position to a world position
// WorldX = (ScreenX + 2*ScreenY)/4
// WorldY = (2*ScreenY - ScreenX)/4
sf::Vector2f ScreenToWorld(sf::Vector2f v)
return sf::Vector2f((v.x+2.0f*v.y)/4.0f, (2.0f*v.y-v.x)/4.0f);

By these equations, we can easily convert a world coordinate to a screen coordinate. We can use WorldToScreen to automatically set a Sprite's screen coordinates whenever the object's world position is modified via SetWorldPosition and SetWorldZ:


void IsometricMapSprite::SetWorldPosition(const sf::Vector2f &position)
sf::Vector2f screenpos=WorldToScreen(m_worldpos);
screenpos.y -= m_z;

void IsometricMapSprite::SetWorldZ(float z)
sf::Vector2f screenpos=WorldToScreen(m_worldpos);
screenpos.y -= m_z;


Note the special handling for an object's World Z coordinate. Moving up on the conceptual Z axis in World space translates directly to moving up on the Y axis in screen space. Here, I am moving up Screen Y on a 1:1 basis with World Z, simply by subtracting World Z from Screen Y. This is a bit disingenuous, since in a true 3D projection, the Up axis in world space is foreshortened a bit (in point of fact, an object 1 unit tall in world space would be cos(30) or ~0.866 units tall in Screen Space, given our 30 degree azimuth angle.). However, since we are faking it, we can make 1 Z unit in World Space == 1 Y unit in Screen Space. This simplifies the math a bit. If it bugs you, just multiply m_z by 0.866 before subtracting from Screen Y.

Now, when we call a Sprite's SetWorldPosition() method, the screen coordinates of the Sprite are automatically calculated. Thus, we never call SetPosition() on a Sprite directly; only SetWorldPosition. This way, we can perform AI and movement, logic, etc... on world position, and let the system itself worry about where on screen to draw it.

Implementing the Map

In order to implement a map, we need to clarify what exactly a map cell or box is. The map itself is very simple, just a 2D allocated array of map cells. Outside of rendering the map, the map cells do most of the work of storing objects, etc... Here is the map cell format we are going to use:


class IsometricMapNode

void drawFloors(sf::RenderWindow *win, sf::Color &color);
void drawObjects(sf::RenderWindow *win, sf::Color &color);
void drawWalls(sf::RenderWindow *win, sf::Color &color);
void drawRoofs(sf::RenderWindow *win, sf::Color &color);

void addFloor(IsometricMapSprite *s);
void addWall(IsometricMapSprite *s);
void addRoof(IsometricMapSprite *s);

void insertSprite(IsometricMapSprite *s);
void removeSprite(IsometricMapSprite *s);
void clear();


std::list m_floors, m_walls, m_roofs, m_objects;


As you can see here, a map cell is merely a set of lists of things to draw. These lists hold pointers to IsometricMapSprites (the actual instances need to be kept elsewhere; the map is just an aid to rendering, not an object management device, although we will "cheat" with some objects, as you'll see in a bit.) You might be wondering why I have a list for things like floor, walls and roof. This is to give us flexibility in decorating a map. You can add as many floor graphics, wall graphics or roof graphics to a cell as you want, and the graphics will be layered in a First-In-First-Out manner. In this way, graphics can be layered using alpha-blending to apply decorations. You can set a floor graphic of a plain dungeon stone floor, then add an alpha blended smear of blood on top of it. Same with walls. You can draw a plain-Jane wall, then add a torch in a sconce as an overlay.

In a way, this kind of layered decoration is a bit simpler in a pure 2D system than in a 3D system, since in true 3D you often need to worry about Z-fighting artifacts when rendering multiple images onto the same plane. In 2D, since we don't check depth, it's not an issue. Just be sure that you add graphics in the order in which they are to be drawn, and all should be well.

You can also use the layered floors to implement transitions between terrain types. I talk about this more in the section on creating artwork.


NodeSize, or size of a cell, has direct bearing upon the isometric view. NodeSize determines the image dimensions of the graphic files that are drawn for the roof, floor and walls sections. The dimensions of a floor or roof image are equal to (4*NodeSize, 2*Nodesize). A wall piece isn't bounded in height, but the image width is equal to (2*NodeSize). So if you set NodeSize to 32, then your diamond floor tiles will be sized (128,64). If you set NodeSize to 64, your floor tiles will be (256,128). Thus, you must find a balance. Larger tiles allow greater detail and help to reduce the appearance of repetition in the tiles, since fewer tiles are visible onscreen at one time. However, this comes with the tradeoff of inflated memory usage. I usually use a NodeSize of either 32 or 64. Smaller than 32, the tiles tend to be very small and repetition is very obvious; larger than 64, the tiles tend to use a lot of memory. Also, NodeSize should be limited to powers-of-2 to ensure that the images used are powers of 2, unless you can be sure that the hardware allows non-power-of-2 textures. SFML will upload images to texture memory, and I believe it will resize textures to the nearest power of 2 greater than the image dimensions, so you can reduce texture wastage by using power-of-2 images to start.

Map Cell Coordinates

It is necessary to be able to find which cell a given World(x,y) lies within. This is done by simply taking the floor of the coordinate divided by NodeSize.

cellx = math.floor(worldx/NodeSize)
celly = math.floor(worldy/NodeSize)

The map uses a bucketing system, where dynamic objects are added to the map and placed into buckets. The object world location is used to calculate which cell bucket, or list, the object should be placed in, so that when the map is drawn, only the objects residing in visible cells are drawn. The cell coordinate space is referred to as Cell(x,y).

Drawing Order

2D isometric games come with some oft-times tricky layering problems, since the lack of depth information can make sorting properly a tad difficult. Some of the problems are circumvented via the drawing order. The drawing order I use is this:

1) Draw all floors of all visible cells
2) Iterate the cells from top of screen to bottom (more on this in a bit) and for each cell draw Objects followed by Roofs, followed by Walls

This order has some requirements. When a dynamic object is bucketed into a cell's object list, it needs to be sorted into the list so that the list is ordered back-to-front. The value used for comparison to perform this sorting is obtained by: WorldPosition.X + WorldPosition.Y + WorldPosition.Z. This value is consistent with the depth of the various coordinates within a cell relative to the conceptual camera; nevertheless, there are still constraints placed upon objects. Objects should be no larger than a cell in size; larger objects should be broken up into cell-sized chunks. This pertains to walls as well as to dynamic objects. Isometric systems traditionally do not like objects that cover more than one cell; all manner of posts in the Isometric Games forum attempt to deal with this problem, which becomes somewhat less of a problem if the objects are broken up. Breaking them up will also help with graphic reuse; you can reduce memory footprint by using large structures built up out of reusable smaller pieces, rather than having lots of special use large structures.

Drawing The Map

This part is where the magic happens. The brain-dead solution of course is to just iterate the entire 2D map array and draw each cell, and let the hardware cull non-visible objects, but this can be bad performance-wise if you have a large map with lots of objects. A better plan is to just figure out which parts of the map are visible and draw only those cells. In a traditional top-down tile game, where the camera is not rotated around the Up Axis by 45 degrees, this task is trivial, since the visible area will just be a sub-rectangle of the world cell array. In an isometric game, though, the visible shape is different. The following graphic shows a map with a possible visible area highlighted.


In this graphic, the rectangle of the screen view is represented by the grey rectangle; all cells that the view rectangle intersects are highlighted in blue. You can see that the pattern is not a regular rectangle, but a much more complex shape. In order to render back to front, we need to render this complex shape row by row. Here is a graphic showing rendering order:


Here you can see some of the squares numbered. This is the drawing order. (The numbering should continue down the whole sequence, but I'm lazy.) If drawn in this order the cells should be drawn with basically correct overlap, as long as the constraints of the system are maintained, as far as object sorting, etc... There are probably going to still be a few edge-cases; this comes with the territory, and most of those can be handled through the collision system, by keeping objects far enough from walls and other solid things so that weird overlap doesn't occur.

Despite the seeming complexity of drawing rows like this, it's actually pretty easy. You can calculate the coordinates of the upper left corner of the chunk by reverse-projecting the upper-left corner of the viewport into World Space. You can calculate the number of columns and rows to draw similarly by dividing the size of the viewport by the on-screen size of a cell. Here, the Height of a cell comes into play, since you need to extend the viewport down to accommodate. You need to draw an arbitrary number of rows below the bottom edge of the viewport, to account for tall objects that might be visible on-screen even though the floor of the cell they lie in might not be. You also need to pad the top and sides by one cell in each direction to account for partially visible cells. But once you have constructed your suitably padded bounds, it becomes a simple matter of iterating the rows.

You start from the top row, which is an Even row. If the number of Nodes you need to draw across the screen (Screen Width / (NodeSize*4)) is NumNodes, then on Even rows you need to draw NumNodes+1 nodes, whereas on odd rows you draw NumNodes cells. (You can see in the image that the rows alternate in length). To advance along a row by one cell, you add 1 to cellx and subtract 1 from cell y. To advance to the next row from an even row, you add 1 to x; to advance to the next row from an odd row, you add 1 to y. And that's basically it. Here is an excerpt from the IsometricMap::draw() method, the part that renders all of the floors:


void IsometricMap::draw(sf::RenderWindow *win)
// Set view
sf::View view=win->GetView();
// Reverse project center
sf::Vector2f center=WorldToScreen(sf::Vector2f(m_centerx,m_centery));

// Reverse-project top-left corner
sf::Vector2f viewsize=view.GetSize();
sf::Vector2f topleft=ScreenToWorld(sf::Vector2f(center.x-viewsize.x/2.0f, center.y-viewsize.y/2.0f));
int sx=(int)(topleft.x/(float)m_nodesize);
int sy=(int)(topleft.y/(float)m_nodesize);

// Move start location up and left two nodes to get a little padding. (subtract 2 from sx

// Calculate how many nodes across to draw
// A node's total width on-screen is calculated as 4*nodesize
int num_nodes_across=(int)viewsize.x / (m_nodesize*4) + 4; // Pad out the end by drawing 4 extra nodes

// Calculate how many rows to draw
// A node's total height on screen is calculated as 2*nodesize. Also, need to fudge it
// a little bit by adding a value that approximates the maximum cell height to the size of the
// viewport.
int num_rows=(((int)viewsize.y+512) / (m_nodesize*2))*2;

// Update lighting

// Drawing proceeds as thus:
// We begin at some starting node and proceed across the row. At each step, we increment x and decrement y
// to move to the next node.
// When a row is done, we move to the next row. This is done by:
// If the current row is "even", then we move to the next row by incrementing x. If the current row is odd, we
// move to the next row by incrementing y instead.
// On even rows, we draw num_nodes+1 nodes, else we draw num_nodes nodes.
int rowincx=1, rowincy=0;
int drawnodes=num_nodes_across+1;

int nodex=sx, nodey=sy;
for(int row=0; row {
if (row & 1)
// Odd row

for(int node=0; node {
// Calculate cell coords
int cellx=nodex+node;
int celly=nodey-node;
if(cellx>=0 && cellx=0 && celly {
sf::Color color=m_lightmap.getLightValue(cellx,celly);



This excerpt does a number of things besides just drawing. A map has a specific center specified as an (x,y) coordinate. The center of the map corresponds to the point, in World Space, that aligns with the center of the screen. By changing the center, you can scroll the map. The drawing code presented takes the current View of the passed RenderWindow and uses the dimensions of it, as well as the map center, to calculate all of the parameters necessary for drawing. It also calculates the new Screen Space view necessary to draw the requisite piece of map, centering it upon the map center point. Once the view is set, the rows and columns of nodes in the visible chunk are iterated as described above. This iteration process is actually performed 2 times: once for the floor lists, and once for objects, roofs and walls. A variation of it is also performed before the drawing calls, in order to update the lighting of the visible region. And while we are on the topic of lighting...

Lighting the World
Isometric games quite frequenly come in RPG varieties, and RPGs like to have lots of caves and dungeons full of darkness and death to play in. So in order to simulate these dark environments we need a lighting system. Presented here is a very simple grid-based lighting system. This system calculates light values per-cell, so the lighting is blocky and very, very retro. The system can be modified fairly easily enough to light the corners of cells, rather than the centers, and by assigning a color value per cell corner, you can achieve smoother lighting across cells; however, SFML as of the latest snapshot still doesn't allow more than a single color per Sprite; perhaps that will change in future iterations of the library. But for now, without performing heavy modifications of the library or without stepping outside of SFML and into OpenGL, we are kind of stuck with one color per sprite, and that means retro lighting.

(Note: SFML does provide a Shader class, that could be leveraged to implement better lighting. I'm working on a system for that even as we speak, though I probably won't discuss it in this article. Maybe in another. The thing is, sf::Shader has higher base requirements, including fragment shader support. But if you want to support it, coolio. You can do some cool stuff with shader-based lighting in a 2D.)

The lighting in this system is simple. It supports static lighting (light that doesn't change, you can set it during map construction and forget about it) and dynamic lighting (lights that move, more expensive than static, but can change position). Two buffers are allocated, one to hold static lighting information, and one to hold the final calculated lights. Also, the light map class maintains an std::list of dynamic lights. Lights are requested and released from the light map class by objects that require them. Here is the lightmap class:


struct DynamicLight
DynamicLight() : m_position(0,0), m_color(0,0,0), m_radius(0){}

void setColor(float r, float g, float b){m_color=sf::Vector3f(r,g,b);}
void setRadius(float rad){m_radius=rad;}
void setPosition(float x, float y){m_position=sf::Vector2f(x,y);}

bool operator==(const DynamicLight &rhs) const
if(this == &rhs) return true;
return false;

sf::Vector2f m_position;
sf::Vector3f m_color;
float m_radius;

class LightMap
LightMap(int w, int h, int nodesize);

void resize(int w, int h);
void clearStatic();
void clearDynamic();
void updateRegion(int sx, int sy, int num_nodes, int num_rows);
DynamicLight *requestLight();
void releaseLight(DynamicLight *light);
sf::Color getLightValue(int x, int y);
void setAmbient(float r, float g, float b);

void addStaticLightCell(int x, int y, float r, float g, float b);
void addStaticLightRadius(float x, float y, float r, float g, float b, float radius);

std::vector m_static;
std::vector m_final;
std::list m_lights;
sf::Vector3f m_ambient;
int m_width, m_height, m_nodesize;


As you can see, a DynamicLight is simply a struct containing a position, a radius, and a color. The static light buffer and final light buffer are both std::vectors of sf::Vector3. You'll notice I use Vector3f instead of sf::Color. I have a very good reason for this.

By using Vector3f, I can have negative light. Negative light is useful for creating things like Spells of Darkness, magically darkened areas, etc... By setting a light pool with negative values, light is actually subtracted from the scene. The method getLightValue will obtain a sf::Color for a given cell; in this case, all the ambient, static and dynamic values for the cell are summed, then clamped to [0,1] before conversion to sf::Color. This type of lighting can be very useful. Your player read a scroll of Permanent Darkness? Simply have it call addStaticLightRadius with a negative color to subtract light from the scene centered at the casting point.

In the inner loop of the map draw routine, the light map is called to obtain a Color for each cell, and the color is passed to the cell drawing routines. The objects that are drawn use this light value to color themselves. And here is where we find the use of the m_uselighting parameter we inserted into the IsometricMapSprite class. Some objects are shaded according to the light value of the cell, while others (luminescent objects, particles, etc...) are not. This flag can be set or cleared to enable or disable use of lighting on a per-sprite basis. Sprites that do not use lighting can be colored using Sprite::SetColor, whereas sprites that do use lighting are colored by the cell lighting instead.

Now, this lighting system is very simple, and doesn't take into account things that block light and cast shadows.

Now, that was a pretty rough overview of how the system works, so let's talk a little about map management and the responsibilities of code that uses this system.

Isometric Map Management

Here is the class declaration for IsometricMap:


class IsometricMap
IsometricMap(int w, int h, int nodesize);

void resize(int w, int h);
void clear();

void insertSprite(IsometricMapSprite *s);
void removeSprite(IsometricMapSprite *s);
void draw(sf::RenderWindow *win);

sf::Vector2f projectMouseCoords(int mx, int my, sf::RenderWindow *win);

void addLeftWall(int x, int y, std::string &name); // Set a left wall piece
void addRightWall(int x, int y, std::string &name);
void addFloor(int x, int y, std::string &name);
void addRoof(int x, int y, std::string &name, float height);

void setCenter(float x, float y) {m_centerx=x; m_centery=y;}

LightMap *getLightMap(){return &m_lightmap;}

std::vector m_nodes;
int m_width, m_height;
int m_nodesize;
float m_centerx, m_centery;
std::list m_mappieces;
ImageManager m_mapimages;
LightMap m_lightmap;



A couple things of interest here. First of all, in the protected section of the class declaration, you can see the line ImageManager m_mapimages. This is a simple class that tracks sf::Images. You can request an image by filename from the manager, and if the image is already loaded it will merely return a pointer to the existing instance of the image, rather than allowing multiple copies of the same image to bloat memory usage. There is also a list of IsometricMapSprites called m_mappieces. This is a convenient means of providing a container to own specific instances of IsometricMapSprites that are used solely by the map: namely, wall, floor and roof pieces.

The class provides methods for resizing, clearing, drawing, etc... There is a method to set the center point, a method to get a pointer to the intrinsic lightmap, in order to effect lighting processes. There is a function, projectMouseCoords, that will take a set of mouse coordinates and convert them into World Space. Note that this method projects Screen Space coords onto the Z=0 plane of World Space; other math would be necessary if you require projection onto other planes of World Space.

Now, of particular interest here are the methods addLeftWall, addRightWall, addFloor, addRoof. These methods are given a coordinate pair (in cell coordinates, not world coords) and the name of the graphic file to load. addRoof also takes a height parameter, used to set how high above ground level the roof should be placed. These functions will instance an IsometricMapSprite and insert it into the m_mappieces list, then request the specified Image from the image manager. Various data are set, including origin points for the Sprite (see sf::Sprite::SetOrigin) and World Space coordinates, then the sprite is added to the appropriate cell. An entire map can be built (well, the static geometry, at least) via these calls. Clearing the map will delete these instanced lists.

Another item of interest are the insertSprite and removeSprite calls. These are of importance for dynamic objects that move around, inserting and removing them from their appropriate cell buckets. It is important to call removeSprite before a sprite's position is updated, then call insertSprite again to insert it at the new position. This sort of micromanagement could be handled more automatically with a little work, but I don't really find it necessary. Just remember to remove and insert any time you update an object's position, and things should be groovy.

With a bit of extra work, you could tweak the system to allow multiple maps, managed by a MapChunk type of interface, in order to implement a dynamic streaming system, wherein map chunks are streamed in and out of memory as the center moves. There are a couple sticky spots in this case (the lighting system being one of them; lights would have a tendency to not cross chunk boundaries, without additional code being written) but with some elbow grease they could be ironed out. The map drawing and light updating would have to be moved out of the IsometricMap and into the interface that handles multiple maps.

I was going to go into an explanation of creating artwork for a game like this, but this beast is long enough as it is. Maybe in another post. If you are curious as to the manner and layout of the graphics, all of the graphics for the demo are included in the project archive as .TGA format images. Open them up to see how they are constructed as far as layouts, alpha channels, etc... Also,the code for generating the map is included in the project so you can examine it to see how the map is built up. The avatar sprite is just a single animation frame taken from one of the enemies in my current game, Goblinson Crusoe. In reality, he would be an animated sprite with different facing directions. But that, too, is a topic for another day.

Good luck, and have fun.



Hardcore. Cheers. Interesting read. I totally agree that it would be preferrable these days to just do this in 3D, but I've found most iso-tutorials to be horribly overcomplex so this is a great addition to teh interwebz anyway.

Share this comment

Link to comment
SFML is good stuff! but yeah, traditional 2D Iso has gone the way of the dodo for all but niche, edutainment and very casual type applications.

Share this comment

Link to comment
This is really great. I dont use SFML, I use Java and Slick2d/LWJGL.. but since thats all build on openGL,..I should be able to apply some of this stuff directly. I really want to try out a simple lighting system like youve done. WE NEED MORE ARTICLES LIKE THIS!

Share this comment

Link to comment
Im not sure what you(and comments) mean by going 3D preferably..Its not a question of programming choice, but art style choice you know..
Unless you mean something like Disgaea, with 2D sprites on top of a 3D environment, but if you want 2D environment, 2D tile'ing' on top of 3D..Is it even possible?(probaly even more complicated)
A good exemple of 2D iso game is the mmorpg Dofus, the art is just awsome, and its not an old school game.

That comes of the top of my head, cause Im a fan of iso games, and I plan to make my iso cubic engine someday.

Good article, thanks for sharing.

Share this comment

Link to comment

Hello, nice tutorial, thank you!
But please, could you, or someone else, explain with more details the equation to convert world space to screen space?
I'm failing to understand it. if world x equals world y then screen x will always be zero? Why is that? Also the last point in world space, as in your example (4096,4096) would be (0, 8192)? i don't get it... 


Share this comment

Link to comment

Consider this isometric tile:


The green lines indicate the X and Y axes of the screen coordinate system. The origin of the screen system is at 0, where the green axes cross. The X coordinate increases to the right, the Y increases up. Overlaid on this grid is an isometric tile. In the isometric system, the X axis increases up and right, the Y axis increases up and left. The tile represents a square cell 16x16 units in size, as you can see by the alternating color patterns. The black and blue areas represent grid lines, the red areas are "in between" areas. The blue lines run on the X=0, X=3, X=7, etc.. and Y=0, Y=3, Y=7 etc... coordinates.

The system I uses overlays the isometric grid onto the screen grid with corresponding origins. That is, the origin of the isometric world, (0,0), corresponds with the origin of the screen plane, ie (0,0). On this overlay, you can see that on the tile, as the X coordinate increases (up and rightward) the corresponding screen coordinate increases +2 in the screen X direction and +1 on the screen Y direction. As the Y coordinate increases, the screen X decreases by -2 in the screen X direction, and +1 in the screen Y direction. So by this token, if isometric X==16, corresponding to the right-hand corner of the diamond tile, the screen coordinates will be equal to X=32, Y=16. Now, if you increase isometric Y from that point, you will begin decreasing screen X and continue increasing screen Y, so that at Y==16 the screen X coordinate will be reduced back to 0, the screen Y coordinate will now be at 32. And this spot corresponds to the location (16,16) on the isometric tile, or the top point of the diamond. You can see that indeed any isometric coordinate where X==Y will, in fact, lie along the screen X=0 axis.

Share this comment

Link to comment

Create an account or sign in to comment

You need to be a member in order to leave a comment

Create an account

Sign up for a new account in our community. It's easy!

Register a new account

Sign in

Already have an account? Sign in here.

Sign In Now