Debian Codegraph @

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