I’m using the Tiled Map Editor for a while, I even wrote that tutorial about it. It’s a general purpose tile map editor, written in Java but now migrating to C++ with Qt, that can be easily used with my set of free pixelart tiles.

A map done with Tiled is stored in a file with TMX extension. It’s just a XML file, easy to understand.
As I’m creating a map loader for my owns purposes, the procedure I’m doing here works we need some simplifications. I’m handling orthogonal maps only. I’m not supporting tile properties as well. I also don’t want to handle base64 and zlib encoding in this version, so in the Tiled editor, go at the menu Edit → Preferences and in the Saving tab unmark the options “Use binary encoding” and “Compress Layer Data (gzip)”, like this:
When saving a map it will produce a TMX file like this:
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE map SYSTEM "http://mapeditor.org/dtd/1.0/map.dtd"> <map version="1.0" orientation="orthogonal" width="10" height="10" tilewidth="32" tileheight="32"> <properties> <property name="Author" value="Silveira Neto"/> <property name="Year" value="2009"/> </properties> <tileset name="mytiles" firstgid="1" tilewidth="32" tileheight="32"> <image source="free_tileset_version_10.png"/> </tileset> <layer name="grass" width="10" height="10"> <data> <tile gid="261"/> <tile gid="260"/> ... <tile gid="160"/> <tile gid="0"/> </data> </layer> </map> |
For processing it on Python I’m using the event oriented SAX approach for XML. So I create a ContentHandler that handles events the start and end of XML elements. In the first element, map, I know enough to create a Pygame surface with the correct size. I’m also storing the map properties so I can use it later for add some logics or effects on the map. After that we create a instance of the Tileset class from where we will get the each tile by an gid number. Each layer has it’s a bunch of gids in the correct order. So it’s enough information to mount and draw a map.
# Author: Silveira Neto # License: GPLv3 import sys, pygame from pygame.locals import * from pygame import Rect from xml import sax class Tileset: def __init__(self, file, tile_width, tile_height): image = pygame.image.load(file).convert_alpha() if not image: print "Error creating new Tileset: file %s not found" % file self.tile_width = tile_width self.tile_height = tile_height self.tiles = [] for line in xrange(image.get_height()/self.tile_height): for column in xrange(image.get_width()/self.tile_width): pos = Rect( column*self.tile_width, line*self.tile_height, self.tile_width, self.tile_height ) self.tiles.append(image.subsurface(pos)) def get_tile(self, gid): return self.tiles[gid] class TMXHandler(sax.ContentHandler): def __init__(self): self.width = 0 self.height = 0 self.tile_width = 0 self.tile_height = 0 self.columns = 0 self.lines = 0 self.properties = {} self.image = None self.tileset = None def startElement(self, name, attrs): # get most general map informations and create a surface if name == 'map': self.columns = int(attrs.get('width', None)) self.lines = int(attrs.get('height', None)) self.tile_width = int(attrs.get('tilewidth', None)) self.tile_height = int(attrs.get('tileheight', None)) self.width = self.columns * self.tile_width self.height = self.lines * self.tile_height self.image = pygame.Surface([self.width, self.height]).convert() # create a tileset elif name=="image": source = attrs.get('source', None) self.tileset = Tileset(source, self.tile_width, self.tile_height) # store additional properties. elif name == 'property': self.properties[attrs.get('name', None)] = attrs.get('value', None) # starting counting elif name == 'layer': self.line = 0 self.column = 0 # get information of each tile and put on the surface using the tileset elif name == 'tile': gid = int(attrs.get('gid', None)) - 1 if gid <0: gid = 0 tile = self.tileset.get_tile(gid) pos = (self.column*self.tile_width, self.line*self.tile_height) self.image.blit(tile, pos) self.column += 1 if(self.column>=self.columns): self.column = 0 self.line += 1 # just for debugging def endDocument(self): print self.width, self.height, self.tile_width, self.tile_height print self.properties print self.image def main(): if(len(sys.argv)!=2): print 'Usage:\n\t{0} filename'.format(sys.argv[0]) sys.exit(2) pygame.init() screen = pygame.display.set_mode((800, 480)) parser = sax.make_parser() tmxhandler = TMXHandler() parser.setContentHandler(tmxhandler) parser.parse(sys.argv[1]) while 1: for event in pygame.event.get(): if event.type == QUIT: return elif event.type == KEYDOWN and event.key == K_ESCAPE: return screen.fill((255,255,255)) screen.blit(tmxhandler.image, (0,0)) pygame.display.flip() pygame.time.delay(1000/60) if __name__ == "__main__": main() |
Here is the result for opening a four layers map file:

That’s it. You can get this code and adapt for your game because next versions will be a lot more coupled for my own purposes and not so general.
Download:maploader.tar.bz2 It’s the Netbeans 6.7 (Python EA 2) project file but that can be opened or used with another IDE or without one. Also contains the village.tmx map and the tileset.
[…] was extending xml.sax.ContentHandler class in a example to decode maps for a Pygame application when my connection went down and I noticed that the program stop working raising a exception […]
Thank you very much for your tutorial!
Thanks a lot, your tutorial really helped me get started.
I’ve just written a simple prototype which loads tmx files with base64 encoding for the map data. You can download it here: http://usefulgamedev.weebly.com/c-tiled-map-loader.html
This is great! But what exactly do i need to do to see the map on the background?
I just ran the code but got an error..
Traceback (most recent call last):
File “/Users/chris/Downloads/maploader/src/maploader.py”, line 32, in
if __name__ == “__main__”: main()
File “/Users/chris/Downloads/maploader/src/maploader.py”, line 14, in main
sys.exit(2)
SystemExit: 2
I don’t really know what to do. I’m a complete noob. I just started messing with Python/Pygame. I really want to get this working!
It’s so hard to get backlinks these days, honestly i need a backlink by comments on your blog / forums or guestbook to make my website appear in search engine. I am getting desperate Now! I know you’ll laugh while reading this comment !!! Here is my website download youtube videos I know my comments do not relate to the topic, but PLEASE HELP ME!! APPROVING MY COMMENT!
Regards: PoormanBH2011
Hello everybody, how do you do
My big cheese’s Pigeon Johnny
LA symph’s the band
I know what you’re philosophical
Who is this dumb-bell
My hero’s Pigeon Johnny
I type the ladies drool
Not really but it sounds cool yet