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