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,-ishow information about the map (size, layers, etc.)
--print=layer,-playerattempt to print the given
layeras ASCII text to standard output. The values printed at each tile location are the internal tile codes.--render=dest.png,-rdest.pngrender the map as an image, saved to
dest.png.
Options
--list-typesshow a list of supported file formats, along with the values to pass to
--typeand--graphicstype.--force,-fopen the file as the given
--type, even if it doesn't look like it's in that format.--graphics=tileset,-gtilesetsupply the filename of the
tilesetto use when rendering the map.--graphicstype=format,-yformatmanually 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,-sprint output suitable for parsing by a script.
--type=format,-tformatmanually 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
lessso that each row doesn't wrap to the next line, andlesscan be used to scroll through the layer horizontally.- gamemap --graphics vgadave.dav level01.dav --render dave01.png
use the tileset
vgadave.davto 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.