summaryrefslogtreecommitdiffstats
path: root/xcf2pnm.10
blob: 07d17c1c3ed723490e948c06980eef2fe9595dde (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
.\" Manual page for xcf2pnm
.\" 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 xcf2pnm 1 2006-02-12 "Xcftools" ""
.SH NAME
xcf2pnm \- convert from GIMP xcf files to ppm/pgm/pbm format
.ds p xcf2pnm
.SH SYNOPSIS
.B \*p
[
.I options
]
.I filename
[
.I layer names
]
.SH DESCRIPTION
.B xcf2pnm
is a command-line tool that converts image files in the XCF format used by
.BR gimp (1)
to the generic image formats
.BR pbm (5),
.BR pgm (5),
and
.BR ppm (5),
flattening layers if necessary. It does not need to have
the Gimp engine itself available.
.SH GENERAL OPTIONS
.so xcf2pnm.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)
.BR \-c ,
.BR \-g ,
.BR \-m ,
and
.BR \-n .
.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 xcf2pnm.1il
.so exit.1i
.SH EXAMPLES
.IP
.B xcf2pnm -b white foo.xcf > foo.ppm
.IP
.B xcf2pnm -a footrans.pgm -o foo.ppm foo.xcf Layer1 Layer2
.P
To test whether the flattened image has any transparency, use
.IP
.B xcf2pnm foo.xcf > /dev/null
.P
To test whether the flattened image has
.I partially
transparent pixels, use
.IP
.B xcf2pnm -b white -G > /dev/null
.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 xcf2png (1)