NAME¶
xcfinfo - display information about GIMP xcf files
SYNOPSIS¶
xcfinfo [
options ]
filename
DESCRIPTION¶
xcfinfo is a command-line tool that displays information about the
contents of image files in the XCF format used by
gimp(1), particularly
about the layers in the image.
OPTIONS¶
- -h, --help
- Print an option summery to standard output and exit with a
return code of 0.
- -j, --bzip
- Equivalent to -Z bzcat. Default if the filename ends
with bz2.
- -u, --utf8
- Use the raw UTF-8 representation from the XCF file to
compare and display layer names. Ordinarily, layer names will be converted
to the character set of the current locale.
- -v, --verbose
- Print progress messages about the conversion to standard
error.
- -V, --version
- Print the version numer of xcftools to standard
output and exit with a return code of 0.
- -z, --gzip
- Equivalent to -Z zcat. Default if the filename ends
with gz.
- -Z command, --unpack
command
- Specify a command that the input file is filtered through
before being interpreted as an XCF file. The command is invoked as
command filename and must produce output to its standard output.
Note that it is not possible to specify arguments as part of
command. An uncompressor is selected automatically if the filename
ends with gz or bz2; to suppress this, use -Z cat
(which is implemented without actually starting a cat(1)
process).
OUTPUT¶
Information about the image is displayed on standard output in a fixed format.
The first line contains general information about the XCF file:
- -
- The file format version
- -
- The canvas size
- -
- The image mode (color, grayscale, or indexed)
- -
- The numer of layers
- -
- The internal compression algorithm
Following this line there is a line for each layer:
- 1)
- The character + if the layer is visible and -
if it is not
- 2)
- The size and offset of the layer
- 3)
- The pixel format of the layer, including whether the layer
has an alpha channel.
- 4)
- The layer mode, as well as the opacity if not 100%, and
/mask if the layer has an active layer mask.
- 5)
- The name of the layer.
EXIT STATUS¶
The exit status of
xcfinfo is
- 0
- Success
- 20
- Problems parsing the command line.
- 21
- The specified XCF file does not exist or cannot be
read.
- 123
- The XCF file contains presumably valid features that
xcftools does not support. (As of this writing there is no known
way of getting the Gimp to write an XCF file that will provoke this
return. Please notify the author if you discover one).
- 125
- The XCF file is malformed.
- 126
- An uncompression program could not be executed, or
terminated abnormally.
- 127
- Unexpected I/O error, internal errors, or other "this
can't happen" situations.
If an uncompression program returns an error exit status, this will be returned
from
xcfinfo too.
AUTHOR¶
xcfinfo was written by Henning Makholm <henning@makholm.net>.
SEE ALSO¶
xcf2pnm(1),
xcf2png(1)