gamemap

Name

gamemap — get information about maps/levels used by supported games

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, and less 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 image dave01.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.