1xcf2pnm(1) xcf2pnm(1)
2
6 xcfview - display GIMP xcf files
7
9 xcfview [ options ] filename [ layer names ]
10
12 xcfview is a wrapper script that uses xcf2png(1) or xcf2pnm(1) (q.v.)
13 to flatten an XCF image and then displays the flattened image using a
14 PNG or PPM viewer found using the mailcap(5) database.
15
17 Every command-line parameter to xcfview will be passed through to the
18 underlying xcf2png or xcf2pnm command. Because it is not certain which
19 converter will be used, the options given should be ones that make
20 sense for both of these:
21 --mask Enable the layer mask.
23 --mode mode
25 Set the layer mode (e.g., Normal or Multiply).
26 --nomask
28 Disable the layer mask.
29 --opacity n
31 Set the opacity on a scale from 0 to 255 (as used internally)
32 --percent n
34 Set the opacity on a scale from 0 to 100 (as in the Gimp user
35 interface).
36 -A, --force-alpha
38 Invent a trivial alpha channel even if the flattened image is
39 completely opaque.
40 -b color, --background color
42 Use this color for transparent pixels in the image. The color
43 can be given as #rrggbb or #rgb hexadecimal values, or as an
44 X11 color name (which will only work if a color name database
45 can be found in one of a number of standard locations).
46 -c, --color, --colour
48 Force the output to use RGB color space even if it there are
49 more compact alternatives.
50 -C, --autocrop
52 Set the converted part of the image such that it just include
53 the boundaries of the visible (or selected) layers. This may
54 make it either smaller or larger than the canvas, depending on
55 the position and size of the visible layers. (Note that the
56 contents of the layers is not taken into account when autocrop‐
57 ping).
58 In the absence of options that specify otherwise, the converted
60 image will cover the entire XCF canvas.
61 -D, --dissolve
63 Do a "dissolve" step to eliminate partial transparency after
64 flattening. If -b is also given, this happens before the back‐
65 ground color is applied.
66 -f, --full-image
68 First flatten the entire image to a memory buffer before writ‐
69 ing output. Then analyse the image to decide on the details of
70 the output format (e.g., whether a grayscale output is suffi‐
71 cient). Without this option, the program flattens only a singe
72 row of "tiles" (height 64) at a time.
73 -g, --gray, --grey
75 Force the output to be a grayscale image even if it may be
76 monochrome. If any colored pixels are encountered, exit with
77 status 103. This will be selected automatically if the output
78 file's name ends with .pgm.
79 -G, --for-gif
81 Assert that the flattened image will have no partial trans‐
82 parency (allowing a more compact representation of the alpha
83 output). Exit with status 102 if the flattened image has any
84 partial transparency. If -b is also given, this tests whether
85 there there is partial transparency before applying the back‐
86 ground color.
87 -h, --help
89 Print an option summery to standard output and exit with a
90 return code of 0.
91 -j, --bzip
93 Equivalent to -Z bzcat. Default if the filename ends with bz2.
94 -o filename, --output filename
96 Write the converted picture to filename instead of to standard
97 output.
98 -O x,y, --offset x,y
100 Offset the converted part of the image from the top-left corner
101 of the XCF canvas. Usually used with -S.
102 -S wxh, --size wxh
104 Crop the converted image to width w and height h.
105 -T, --truecolor
107 Use standard RGB compositing for flattening indexed layers.
108 Without this option, xcfview will mimic the Gimp's current
109 strategy of rounding each alpha value to either full trans‐
110 parency or full opacity, and interpret all layer modes as Nor‐
111 mal.
112 -u, --utf8
114 Use the raw UTF-8 representation from the XCF file to compare
115 and display layer names. Ordinarily, layer names will be con‐
116 verted to the character set of the current locale.
117 -v, --verbose
119 Print progress messages about the conversion to standard error.
120 -V, --version
122 Print the version numer of xcftools to standard output and exit
123 with a return code of 0.
124 -z, --gzip
126 Equivalent to -Z zcat. Default if the filename ends with gz.
127 -Z command, --unpack command
129 Specify a command that the input file is filtered through
130 before being interpreted as an XCF file. The command is invoked
131 as command filename and must produce output to its standard
132 output. Note that it is not possible to specify arguments as
133 part of command. An uncompressor is selected automatically if
134 the filename ends with gz or bz2; to suppress this, use -Z cat
135 (which is implemented without actually starting a cat(1)
136 process).
137
139 The exit status is 0 in case of success. A nonzero exit status may
140 either be that of the xcf2foo converter or that of the image viewer.
141
143 xcfview was written by Henning Makholm <henning@makholm.net>.
144 Parts of the script originate from the run-mailcap(1) script by Brian
146 White <bcwhite@pobox.com>.
147
149 xcf2pnm(1), xcf2png(1)
150Xcftools 2006-02-12 xcf2pnm(1)