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)