gameimg

Name

gameimg — manipulate files holding a single image, used internally by many games

Synopsis

gameimg [options...] image [actions...]

Description

Perform the specified actions on the given image. The actions are performed in order (i.e. the first action specified on the command line is performed first.)

Actions

--extract=dest.png, -x dest.png

convert the image to a PNG format file, saving it as dest.png.

--overwrite=new.png, -o new.png

replace the image content with that loaded from new.png. If the new image is a different width or height, the underlying game image will be resized if possible, otherwise for image formats with fixed dimensions, an error will occur.

Options

--force, -f

open the archive as the given --type, even if it doesn't look like it's in that format.

--list-types

show a list of supported file formats, along with the code to pass to --type.

--script, -s

print output suitable for parsing by a script.

--type=format, -t format

manually specify the format type. The type is normally autodetected, but it needs to be specified for a few file formats which lack signatures to identify them by. See --list-types.

Examples

gameimg sys000.ega -x cctitle.png

convert the Captain Comic title screen sys000.ega into a PNG image called cctitle.png.

gameimg sys000.ega -o modtitle.png

replace the Captain Comic title screen with the PNG image stored in modtitle.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/libgamegraphics/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.