Debian Codegraph @

upstream/debian-trixie/man1/ppmtogif.1

raw
1 \
2 .\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
3 .\" Do not hand-hack it! If you have bug fixes or improvements, please find
4 .\" the corresponding HTML page on the Netpbm website, generate a patch
5 .\" against that, and send it to the Netpbm maintainer.
6 .TH "Ppmtogif User Manual" 1 "" "netpbm documentation"
7
8 .SH NAME
9
10 ppmtogif - replaced by pamtogif
11
12 .SH DESCRIPTION
13 .PP
14 This program is part of
15 .BR "Netpbm" (1)\c
16 \&.
17 .PP
18 \fBppmtogif\fP was replaced in Netpbm 10.37 (December 2006) by
19 .BR "pamtogif" (1)\c
20 \&.
21 .PP
22 \fBpamtogif\fP is mostly backward compatible with \fBppmtogif\fP.
23 .PP
24 One way \fBpamtogif\fP is not backward compatible with \fBppmtogif\fP
25 is that to specify a transparency (alpha) mask with \fBppmtogif\fP, you
26 supply the transparency as a separate pseudo-PGM image and use the
27 \fB-alpha\fP option, whereas with \fBpamtogif\fP, you supply an input
28 image that has the transparency integrated into it, and there is no
29 \fB-alpha\fP option.
30 .PP
31 \fBppmtogif\fP still exists as a separate program for backward
32 compatibility, but it runs \fBpamtogif\fP to do the essential work.
33 The compatibility \fBppmtogif\fP interprets an \fB-alpha\fP option
34 by reading the transparency image and combining it with the input
35 image, then feeding \fBpamtogif\fP the combined image it expects.
36 Other than that, the compatibility \fBppmtogif\fP just passes input and
37 options directly to \fBpamtogif\fP.
38 .PP
39 You should not make any new use of \fBppmtogif\fP and if you modify an
40 existing use, you should upgrade to \fBpamtogif\fP. But note that if you
41 write a program that might have to be used with old Netpbm, \fBppmtogif\fP is
42 the only way to do that.
43 .PP
44 Unless you use the \fB-alpha\fP option, you can simply change the name
45 of the program. If you use \fB-alpha\fP, here is how to upgrade:
46
47 .nf
48 \f(CW
49 $ ppmtogif -alpha=myalpha.pgm myinput.ppm >myoutput.gif
50 \fP
51
52 .fi
53
54 becomes
55
56 .nf
57 \f(CW
58 $ pamstack -tupletype=RGB_ALPHA myinput.ppm myalpha.pgm | \e
59 pamtogif >myoutput.gif
60 \fP
61
62 .fi
63
64
65 .SH Original Ppmtogif
66 .PP
67 If you are using Netpbm before 10.37, \fBpamtogif\fP doesn't exist,
68 so you use \fBppmtogif\fP. You can use the \fBpamtogif\fP manual
69 for \fBppmtogif\fP, with the following exceptions.
70 .PP
71 The current documentation of \fBpamtogif\fP documents all versions
72 of that program. Use the information for Version 10.37 only.
73 .PP
74 \fBppmtogif\fP before Netpbm 10.31 does not accept PAM input at all.
75 .PP
76 \fBppmtogif\fP does not accept PAM input with transparency information
77 in it. Instead, \fBppmtogif\fP has an \fB-alpha\fP option.
78 .PP
79 The syntax of the option is \fB-alpha=\fP\fIpgmfile\fP.
80 \fBppmtogif\fP treats the contents of the named PGM file the same as
81 \fBpamtogif\fP treats the alpha plane of a PAM. The PGM image must
82 have the same dimensions as the input file. But unlike the PAM case,
83 the alpha image need not have the same maxval as the input.
84 \fBppmtogif\fP interprets the alpha file using the alpha file's
85 maxval.
86 .PP
87 You cannot specify both \fB-transparent\fP and \fB-alpha\fP.
88 .SH DOCUMENT SOURCE
89 This manual page was generated by the Netpbm tool 'makeman' from HTML
90 source. The master documentation is at
91 .IP
92 .B http://netpbm.sourceforge.net/doc/ppmtogif.html
93 .PP