Debian Codegraph @

upstream/debian-unstable/man1/ppmfade.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 "Ppmfade User Manual" 1 "01 April 2000" "netpbm documentation"
7
8 .SH NAME
9 ppmfade - generate a transition between two image files using special effects
10
11 .UN synopsis
12 .SH SYNOPSIS
13
14 \fBppmfade\fP
15 [\fB-f\fP \fIfirst.ppm\fP]
16 [\fB-l\fP \fIlast.ppm\fP]
17 [\fB-mix\fP|\fB-spread\fP|\fB-shift\fP|
18 \fB-relief\fP|\fB-oil\fP|\fB-edge\fP|\fB-bentley\fP|\fB-block\fP]
19 [\fB-base\fP \fIname\fP]
20
21 .UN description
22 .SH DESCRIPTION
23 .PP
24 This program is part of
25 .BR "Netpbm" (1)\c
26 \&.
27 .PP
28 \fBppmfade\fPgenerates a transition between either two input
29 images or between one input image and black. You can use the 30
30 intermediate images generated to show a smooth transition between
31 segments of a movie. The input and output images are in the PPM
32 format. If you specify both input images, they should both be the
33 same size. If you want to fade from black to an image, specify only
34 the last image. If you want to fade from an image to black, specify
35 only the first image. \fBppmfade\fP names the resulting image files
36 \fIbase\fP\fB.\fP\fInnnn\fP\fB.ppm\fP, where \fInnnn\fP is a
37 number varying between 0001 and 0030 and \fIbase\fP is what you
38 specify with via the \fB-base\fP option (default \fBfade\fP).
39 .PP
40 Another way to convert by steps from one image to another is
41 morphing. You can use \fBxmorph\fP to do that.
42
43 .UN options
44 .SH OPTIONS
45 .PP
46 In addition to the options common to all programs based on libnetpbm
47 (most notably \fB-quiet\fP, see
48 .UR index.html#commonoptions
49 Common Options
50 .UE
51 \&), \fBppmfade\fP recognizes the following
52 command line options:
53
54
55 .TP
56 \fB-f\fP \fIfirst.ppm\fP
57 This is the image file (PPM format) to be used at the beginning of the
58 transition. If you don't specify this, the fade will start from black.
59
60 .TP
61 \fB-l\fP \fIlast.ppm\fP
62 This is the image file (PPM format) to be used at the ending of the
63 transition. If you don't specify this, the fade will end with black.
64
65 .TP
66 \fB-mix\fP
67 The two images are superimposed with the brightness of the first image
68 decreasing from full to none and the brightness of the final image
69 increasing from none to full. The transition is quadratic in brightness
70 with faster transition in the beginning and slower at the end.
71
72 .TP
73 \fB-spread\fP
74 The pixels in the first image will be moved (spread) further and further
75 from their original location and then moved into the proper location in
76 the final image. This is the default transition.
77
78 .TP
79 \fB-shift\fP
80 The pixels in the first image will be shifted further and further horizontally
81 from their original location and then moved into the proper location in
82 the final image.
83
84 .TP
85 \fB-relief\fP
86 The first image is faded to a Laplacian relief filtered version of the
87 first image. This is then faded to a Laplacian relief filtered version
88 of the second image and finally faded to the final image.
89
90 .TP
91 \fB-oil\fP
92 The first image is faded to an "oil transfer" version
93 of the first image. This is then faded to an "oil transfer"
94 version of the second image and finally faded to the final image.
95
96 .TP
97 \fB-edge\fP
98 The first image is faded to an edge detected version of the first image.
99 This is then faded to an edge detected version of the second image and
100 finally faded to the final image.
101
102 .TP
103 \fB-bentley\fP
104 The first image is faded to a "Bentley Effect" version
105 of the first image. This is then faded to a "Bentley
106 Effect" version of the second image and finally faded to the
107 final image.
108
109 .TP
110 \fB-block\fP
111 The first image is defocused to small blocks. The small blocks are converted
112 to match a defocused version of the last image. The block version of the last
113 image is then focused to the final image.
114
115 .TP
116 \fB-base\fP \fIname\fP
117 This forms part of the output filenames, as described above.
118
119
120
121 .UN examples
122 .SH EXAMPLES
123
124 \fBppmfade -f teapot.ppm -l pyr.ppm\fP
125 .PP
126 Fade from teapot.ppm to pyr.ppm generating fade.0001.ppm to fade.0030.ppm using
127 the "spread" transition.
128 .PP
129 \fBppmfade -l teapot.ppm\fP
130 .PP
131 Fade from black to teapot.ppm generating fade.0001.ppm to fade.0030.ppm.
132 .PP
133 \fBppmfade -f teapot.ppm -base end\fP
134 .PP
135 Fade from teapot.ppm to black generating end.0001.ppm to end.0030.ppm.
136
137 .UN seealso
138 .SH SEE ALSO
139
140 \fBtontsc\fP manual,
141 \fBsgifade\fP manual,
142 \fBsmart_vfr\fP manual,
143 \fBxmorph\fP manual,
144 .BR "ppm" (1)\c
145 \&
146
147 .UN author
148 .SH AUTHOR
149 Bryan Henderson, Olympia WA; April 2000
150 .PP
151 Inspired by and intended as a replacement for \fBpbmfade\fP (not a
152 Netpbm program) by Wesley C. Barris.
153 .SH DOCUMENT SOURCE
154 This manual page was generated by the Netpbm tool 'makeman' from HTML
155 source. The master documentation is at
156 .IP
157 .B http://netpbm.sourceforge.net/doc/ppmfade.html
158 .PP