.\" Manual page for xcf2png
.\" This file was written by Henning Makholm <henning@makholm.net>
.\" It is hereby in the public domain.
.\" 
.\" In jurisdictions that do not recognise grants of copyright to the
.\" public domain: I, the author and (presumably, in those jurisdictions)
.\" copyright holder, hereby permit anyone to distribute and use this code,
.\" in source code or binary form, with or without modifications. This
.\" permission is world-wide and irrevocable.
.\"
.\" Of course, I will not be liable for any errors or shortcomings in the
.\" code, since I give it away without asking any compenstations.
.\"
.\" If you use or distribute this code, I would appreciate receiving
.\" credit for writing it, in whichever way you find proper and customary.
.TH xcf2png 1 2006-02-12 "Xcftools" ""
.SH NAME
xcf2png \- convert from GIMP xcf files to png format
.ds p xcf2png
.SH SYNOPSIS
.B \*p
[
.I options
]
.I filename
[
.I layer names
]
.SH DESCRIPTION
.B xcf2png
is a command-line tool that converts image files in the XCF format used by
.BR gimp (1)
to the generic image format
.BR png ,
flattening layers if necessary. It does not need to have
the Gimp engine itself available.
.SH GENERAL OPTIONS
.so xcf2png.1i
.P
Several groups of options are mutually incompatible; in each group the
one given last will win:
.TP 4
1)
.B \-A
and
.BR \-b .
.TP
2)
.B \-g
and
.B \-c .
.TP
3)
.B \-D
and
.BR \-G .
.TP
4)
.BR \-j ,
.BR \-z ,
and
.BR \-Z .
.TP
5)
.B \-C
and
.BR \-O / \-S .
.SH LAYER SPECIFICATIONS
If no
.I layer name
is given on the command line, all of the visible layers in
the XCF file are merged to produce the output image.
It is also possible to specify the layers to merge explicitly,
by giving their names as separate arguments after the
input filename. In that case, the output will contain
.I only
the named layers. The layers will be merged in the order
they appear on the command line, with the leftmost being
"at the bottom" \- that is, the layer ordering in the XCF file
will be ignored.
.P
The following options can be given
.I after
a layer name to override the global properties of the layer:
.so xcf2png.1il
.so exit.1i
.SH BUGS AND LIMITATIONS
.P
When several partially transparent layers are merged, the pixel
values are interpolated without gamma correction. (The Gimp also
does it this way). Some slight rounding errors in the interpolation
are inevitable;
.B \*p
sometimes has different rounding errors than the Gimp itself,
especially when more than two layers are involved, or in case of
some of the more exotic layer modes.
These differences are usually not visible to the eye.
.P
Floating selections are currently not handled correctly.
.P
There are probably other bugs lurking in corner cases. If you discover
one, please notify the author.

.SH FILES
.TP 8
.B /etc/X11/rgb.txt
.TP 8
.B /usr/share/X11/rgb.txt
.TP 8
.B /usr/lib/X11/rgb.txt
Color name database for
.BR \-b .
.SH AUTHOR
.B \*p
was written by Henning Makholm <henning@makholm.net>.
.P
.SH SEE ALSO
.BR xcfinfo (1),
.BR xcf2pnm (1)