MapConv - beyond-all-reason/springrts_engine_wiki_mirror GitHub Wiki
Linux users, use: MapConvNG
map decompiler 1
A cross platform map compiler for spring
- Forum thread for news and releases
- In 2021, on windows, use the GUI version here: PyMapConv
- Beherith
MapConv at github
git clone git://github.com/spring/MapConv.git
Fastest compile, lowest quality:
MapConv -i -c 0 -x 250 -n 25 -o Zion_v1.smf -t t.bmp -a h.raw -m m.bmp -f f.bmp -z "nvdxt.exe -dxt1a -nmips 4 -quick -file"
Medium speed, good quality: (CUDA version, requires nvidia 8 or higher series gfx card)
MapConv -i -c 0 -x 250 -n 25 -o Zion_v1.smf -t t.bmp -a h.raw -m m.bmp -f f.bmp -q
Slow, great quality:
MapConv -i -c 0 -x 250 -n 25 -o Zion_v1.smf -t t.bmp -a h.raw -m m.bmp -f f.bmp
Slower, best possible quality:
MapConv -i -c 0 -x 250 -n 25 -o Zion_v1.smf -t t.bmp -a h.raw -m m.bmp -f f.bmp -z "nvdxt.exe -dxt1a -nmips 4 -Sinc -quality_highest -file"
$ mapconv -h
USAGE:
mapconv [-j <feature list file>] [-f <featuremap image>] [-l] [-i] [-z
<texcompress program>] [-c <compression>] -x <max height> -n
<min height> [-o <output .smf>] [-e <tile file>] [-g <Geovent
image>] [-y <typemap image>] -m <metalmap image> -a <heightmap
file> -t <texturemap file> [--] [-v] [-h]
Where:
-j <feature list file>, --featurelist <feature list file>
(value required) A file with the name of one feature on each line.
(Default: fs.txt). See README.txt for details.
-f <featuremap image>, --featuremap <featuremap image>
(value required) Feature placement file, xsize by ysize. See
README.txt for details.
-l, --lowpass
Lowpass filters the heightmap
-i, --invert
Flip the height map image upside-down on reading.
-z <texcompress program>, --texcompress <texcompress program>
(value required) Name of companion program texcompress from current
working directory.
-c <compression>, --compress <compression>
(value required) How much we should try to compress the texture map.
Default 0.8, lower -> higher quality, larger files.
-x <max height>, --maxheight <max height>
(required) (value required) What altitude in spring the max(0xff or
0xffff) level of the height map represents.
-n <min height>, --minheight <min height>
(required) (value required) What altitude in spring the min(0) level
of the height map represents.
-o <output .smf>, --outfile <output .smf>
(value required) The name of the created map file. Should end in
.smf. A tilefile (extension .smt) is also created.
-e <tile file>, --externaltilefile <tile file>
(value required) External tile file that will be used for finding
tiles. Tiles not found in this will be saved in a new tile file.
-g <Geovent image>, --geoventfile <Geovent image>
(value required) The decal for geothermal vents; appears on the
compiled map at each vent. (Default: geovent.bmp).
-y <typemap image>, --typemap <typemap image>
(value required) Type map to use, uses the red channel to decide
type. types are defined in the .smd, if this argument is skipped the
map will be all type 0
-m <metalmap image>, --metalmap <metalmap image>
(required) (value required) Metal map to use, red channel is amount
of metal. Resized to xsize / 2 by ysize / 2.
-a <heightmap file>, --heightmap <heightmap file>
(required) (value required) Input heightmap to use for the map, this
should be in 16 bit raw format (.raw extension) or an image file. Must
be xsize*64+1 by ysize*64+1.
-t <texturemap file>, --intex <texturemap file>
(required) (value required) Input bitmap to use for the map. Sides
must be multiple of 1024 long. xsize, ysize determined from this file:
xsize = intex width / 8, ysize = height / 8.
--, --ignore_rest
Ignores the rest of the labeled arguments following this flag.
-v, --version
Displays version information and exits.
-h, --help
Displays usage information and exits.
Converts a series of image files to a Spring map. This just creates the
.smf and .smt files. You also need to write a .smd file using a text
editor.
MapConv - Invoking the MapConv program (MapConv.exe)
-i - Inverts the heightmap (Always use -i, otherwise your
heightmap will be flipped producing undesierable results)
-l - Lowpass option. Lowpass applies a blurring to the heightmap
to smooth out rough edges and make pathing easier. If you are using a
16bit heightmap you will probably not want to use lowpass, however, many
experienced mappers still use lowpass even on 16bit heightmaps due to
the fact that lowpass smoothing will, in most cases, make it easier for
the pathfinder to do it's job.
-c`` ``#`` ``(-c`` ``0) - Compression level. Deprecated,
never use any other value than 0.
-x`` ``#`` ``(-x`` ``101) - Map maximum
height. Deprecated. Map levels can be set in the map's parameters via
LUA which is a much better method.
-n`` ``#`` ``(-n`` ``100) - Map minimum
height. Deprecated. Map levels can be set in the map's parameters via
LUA which is a much better method.
**-o (-o EvoRTS-Craggy_Creek-v01.smf'') **''- -o
stands for "Output Filename". Generally this is the name of your map,
but realistically it can be anything as you can change the name of the
map via the Map's LUA parameters. Once compiled, NEVER rename the .smt
file!
**-t (t terrain.png) **- Name of the Texture map
file. Must be in the same directory as MapConv!
-a`` ``(-a`` ``height6.png) - Name of the
Height map file. Must be in the same directory as MapConv!
-m`` ``(-m`` ``metal.png) - Name of the Metal
map file. Must be in the same directory as MapConv!
-f`` ``(-f`` ``feature.png) - Name of the
Feature map file. Must be in the same directory as MapConv!
-z`` ``(-z`` ``"nvdxt.exe`` ``-dxt1a`` ``-nmips`` ``4`` ``-Sinc`` ``-quality_highest`` ``-file")-
-z invokes nvdxt.exe which is a helper program that breaks the texture
map into DDS tiles. The parameters listed tell nvdxt.exe how much to
compress the tiles or how high of quality to strive for. There is never
any reason to change the parameters from the example.
Category:Map Tools