MapConv

From Spring
Jump to: navigation, search

Linux users, use: MapConvNG

Some Mapconv Information 1,2

map decompiler 1

Mapconv

A cross platform map compiler for spring

Windows download

7zip Archive: beherith_mapconv_2.4.7z

Source Code

MapConv at github

Getting the Source

git clone git://github.com/spring/MapConv.git

Documentation

Example Usage

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"


--help output

$ 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.

Links

MapConv Parameters Explained

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 <Mapname> (-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 <Filename> (t terrain.png) - Name of the Texture map file. Must be in the same directory as MapConv!


-a <Filename> (-a height6.png) - Name of the Height map file. Must be in the same directory as MapConv!


-m <Filename> (-m metal.png) - Name of the Metal map file. Must be in the same directory as MapConv!


-f <Filename> (-f feature.png) - Name of the Feature map file. Must be in the same directory as MapConv!


-z <Parameters> (-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.