xcfinfo(1)

1xcfinfo(1)                                                          xcfinfo(1)
2
3
4

NAME

6       xcfinfo - display information about GIMP xcf files
7

SYNOPSIS

9       xcfinfo [ options ] filename
10

DESCRIPTION

12       xcfinfo is a command-line tool that displays information about the con‐
13       tents of image files in the XCF format used  by  gimp(1),  particularly
14       about the layers in the image.
15

OPTIONS

17       -h, --help
18               Print  an  option  summery  to  standard output and exit with a
19               return code of 0.
20
21       -j, --bzip
22               Equivalent to -Z bzcat.  Default if the filename ends with bz2.
23
24       -u, --utf8
25               Use the raw UTF-8 representation from the XCF file  to  compare
26               and  display layer names.  Ordinarily, layer names will be con‐
27               verted to the character set of the current locale.
28
29       -v, --verbose
30               Print progress messages about the conversion to standard error.
31
32       -V, --version
33               Print the version numer of xcftools to standard output and exit
34               with a return code of 0.
35
36       -z, --gzip
37               Equivalent to -Z zcat.  Default if the filename ends with gz.
38
39       -Z command, --unpack command
40               Specify  a  command  that  the  input  file is filtered through
41               before being interpreted as an XCF file. The command is invoked
42               as  command  filename  and  must produce output to its standard
43               output.  Note that it is not possible to specify  arguments  as
44               part  of command.  An uncompressor is selected automatically if
45               the filename ends with gz or bz2; to suppress this, use -Z  cat
46               (which  is  implemented  without  actually  starting  a  cat(1)
47               process).
48

OUTPUT

50       Information about the image is displayed on standard output in a  fixed
51       format.   The  first  line  contains  general information about the XCF
52       file:
53
54       -  The file format version
55
56       -  The canvas size
57
58       -  The image mode (color, grayscale, or indexed)
59
60       -  The numer of layers
61
62       -  The internal compression algorithm
63
64       Following this line there is a line for each layer:
65
66       1) The character + if the layer is visible and - if it is not
67
68       2) The size and offset of the layer
69
70       3) The pixel format of the layer, including whether the  layer  has  an
71          alpha channel.
72
73       4) The layer mode, as well as the opacity if not 100%, and /mask if the
74          layer has an active layer mask.
75
76       5) The name of the layer.
77

EXIT STATUS

79       The exit status of xcfinfo is
80
81       0    Success
82
83       20   Problems parsing the command line.
84
85       21   The specified XCF file does not exist or cannot be read.
86
87       123  The XCF file contains presumably valid features that xcftools does
88            not support.  (As of this writing there is no known way of getting
89            the Gimp to write an XCF  file  that  will  provoke  this  return.
90            Please notify the author if you discover one).
91
92       125  The XCF file is malformed.
93
94       126  An  uncompression  program  could  not  be executed, or terminated
95            abnormally.
96
97       127  Unexpected I/O error, internal errors, or other "this  can't  hap‐
98            pen" situations.
99
100       If  an uncompression program returns an error exit status, this will be
101       returned from xcfinfo too.
102

AUTHOR

104       xcfinfo was written by Henning Makholm <henning@makholm.net>.
105