Skip to content
Samuel Nicholas edited this page Feb 6, 2016 · 4 revisions

About

what is this project for?

SpringRTS uses custom file formats for its environment, these formats require some tool to produce, these are some tools to produce the files.

Spring Map File(SMF)

Some metadata about the map and raw data used to modify the path grid, roam terrain, and various other graphical elements like diffuse texture, minimap, grass etc. A full breakdown is at [https://springrts.com/wiki/Mapdev:SMF_format]

Spring TileFile(SMT)

Acts as a catalogue of image tiles, inside the SMF there is a map for which tiles to place where to generate larger images. A full breakdown is at [https://springrts.com/wiki/Mapdev:SMT_format]

How do I use it?

The basic gist is that there is a tile file(SMT) and a map file(SMF) contained in the map file is a tilemap which defines what tiles to use in what position. The way the community builds things so far is that you take the finished image rendered with some terrain rendering package or made using gimp/photoshop, and then split it up into tiles checking for duplicates. From this process you get the tiles, and a map for how to reconstruct them.

Typical

smt_convert --smt --tilesize 32x32 -o mytiles.smt big_image.jpg

Will spit out a tile file(SMT), and a tile map in csv format

from there you construct the map file(SMF) and specifying the tile file(SMT) and tilemap as dependents.

smf_cc [more options] -o mymap.smf --map mytiles.smt.csv mytiles.smt

mymap.smf and mytiles.smt are used in the engine.

Alternative

However because this is based on tiles, it could be just as useful to build a tilefile from individual tiles, and then build your tilemap using a program like [http://www.mapeditor.org/ Tiled] to arrange them.

smt_convert -o mytiles --tilesize 32x32 tile_{0-n}.jpg

it will still output the tile file and the tile map, but we can discard the tilemap as we will be using one from [http://www.mapeditor.org/ Tiled].

Benchmarks

  • Intel Core i7 ULV (4 th generation)