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)