MapConv: Difference between revisions

From Spring
Jump to navigationJump to search
mNo edit summary
mNo edit summary
Line 9: Line 9:


= Documentation =
= Documentation =
<code><pre>
$ 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.
</pre></code>


= other =
= other =
http://code.google.com/p/mapc/
http://code.google.com/p/mapc/

Revision as of 01:21, 17 July 2010

Mapconv

A cross platform SMF 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

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

other

http://code.google.com/p/mapc/