MapConv: Difference between revisions
From Spring
Jump to navigationJump to search
| Line 129: | Line 129: | ||
* http://code.google.com/p/mapc/ | * http://code.google.com/p/mapc/ | ||
* http://springrts.com/phpbb/viewtopic.php?f=13&t=18533 | * http://springrts.com/phpbb/viewtopic.php?f=13&t=18533 | ||
[[Category:Map making]] | |||
Revision as of 00:12, 27 September 2011
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.