Synopsis
gamemap
[options
...] map
[actions
...]
Description
Perform the specified actions
on the given
map
file. The actions are performed in order
(i.e. the first action specified on the command line is performed first.)
Actions
--info
,-i
show information about the map (size, layers, etc.)
--print
=layer
,-p
layer
attempt to print the given
layer
as ASCII text to standard output. The values printed at each tile location are the internal tile codes.--render
=dest.png
,-r
dest.png
render the map as an image, saved to
dest.png
.
Options
--list-types
show a list of supported file formats, along with the values to pass to
--type
and--graphicstype
.--force
,-f
open the file as the given
--type
, even if it doesn't look like it's in that format.--graphics
=tileset
,-g
tileset
supply the filename of the
tileset
to use when rendering the map.--graphicstype
=format
,-y
format
manually specify the file type of the graphics file given by
--graphics
. The type is normally autodetected, but it needs to be specified for a few formats which lack signatures to identify them by. See--list-types
.--script
,-s
print output suitable for parsing by a script.
--type
=format
,-t
format
manually specify the file type. The type is normally autodetected, but it needs to be specified for a few formats which lack signatures to identify them by. See
--list-types
.
Examples
- gamemap level01.dav --info
display information about the first level in Dangerous Dave.
- gamemap level01.dav --print 1 | less -S
display the first layer of the map as text, passing it to
less
so that each row doesn't wrap to the next line, andless
can be used to scroll through the layer horizontally.- gamemap --graphics vgadave.dav level01.dav --render dave01.png
use the tileset
vgadave.dav
to draw the entire map, and save it as the PNG imagedave01.png
.
Notes
Exit status is 0 on success, non-zero on failure (1 for bad parameters, 2 for critical errors such as being unable to open the the archive file, 3 for more information needed, 4 for non-critical errors such as being unable to insert one of many files, 5 for uncommon failures like running out of disk space.)
All the file formats supported by this utility are fully documented on the Game Modding Wiki.
Bugs and Questions
Report bugs at https://github.com/Malvineous/libgamemaps/issues
Ask questions about Camoto or modding in general at the RGB Classic Games modding forum
Copyright
Copyright (c) 2010-2017 Adam Nielsen.
License GPLv3+: GNU GPL version 3 or later
This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.