summary refs log tree commit diff
path: root/ppmfade.html
blob: 2fb89810268ad83fef6c0393ed92d51c5177f4ad (plain) (blame)
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
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
<html><head><title>Ppmfade User Manual</title></head>
<body>
<h1>ppmfade</h1>
Updated: 01 April 2000
<br>
<a href="#index">Table Of Contents</a>

<h2>NAME</h2>
ppmfade - generate a transition between two image files using special effects

<h2 id="synopsis">SYNOPSIS</h2>

<b>ppmfade</b>
[<b>-f</b> <i>first.ppm</i>]
[<b>-l</b> <i>last.ppm</i>]
[<b>-mix</b>|<b>-spread</b>|<b>-shift</b>|
<b>-relief</b>|<b>-oil</b>|<b>-edge</b>|<b>-bentley</b>|<b>-block</b>]
[<b>-base</b> <i>name</i>]

<h2 id="description">DESCRIPTION</h2>

<p>This program is part of <a href="index.html">Netpbm</a>.

<p><b>ppmfade</b>generates a transition between either two input
images or between one input image and black.  You can use the 30
intermediate images generated to show a smooth transition between
segments of a movie.  The input and output images are in the PPM
format.  If you specify both input images, they should both be the
same size.  If you want to fade from black to an image, specify only
the last image.  If you want to fade from an image to black, specify
only the first image.  <b>ppmfade</b> names the resulting image files
<i>base</i><b>.</b><i>nnnn</i><b>.ppm</b>, where <i>nnnn</i> is a
number varying between 0001 and 0030 and <i>base</i> is what you
specify with via the <b>-base</b> option (default <b>fade</b>).

<p>Another way to convert by steps from one image to another is
morphing.  You can use <b>xmorph</b> to do that.

<h2 id="options">OPTIONS</h2>

<p>In addition to the options common to all programs based on libnetpbm
(most notably <b>-quiet</b>, see <a href="index.html#commonoptions">
Common Options</a>), <b>ppmfade</b> recognizes the following
command line options:

<dl compact>
<dt><b>-f</b> <i>first.ppm</i>

<dd>
This is the image file (PPM format) to be used at the beginning of the
transition.  If you don't specify this, the fade will start from black.

<dt><b>-l</b> <i>last.ppm</i>

<dd>
This is the image file (PPM format) to be used at the ending of the
transition.  If you don't specify this, the fade will end with black.

<dt><b>-mix</b>

<dd>
The two images are superimposed with the brightness of the first image
decreasing from full to none and the brightness of the final image
increasing from none to full.  The transition is quadratic in brightness
with faster transition in the beginning and slower at the end.

<dt><b>-spread</b>

<dd>
The pixels in the first image will be moved (spread) further and further
from their original location and then moved into the proper location in
the final image.  This is the default transition.

<dt><b>-shift</b>

<dd>
The pixels in the first image will be shifted further and further horizontally
from their original location and then moved into the proper location in
the final image.

<dt><b>-relief</b>

<dd>
The first image is faded to a Laplacian relief filtered version of the
first image.  This is then faded to a Laplacian relief filtered version
of the second image and finally faded to the final image.

<dt><b>-oil</b>

<dd>The first image is faded to an "oil transfer" version
of the first image.  This is then faded to an "oil transfer"
version of the second image and finally faded to the final image.

<dt><b>-edge</b>

<dd>
The first image is faded to an edge detected version of the first image.
This is then faded to an edge detected version of the second image and
finally faded to the final image.

<dt><b>-bentley</b>

<dd> The first image is faded to a "Bentley Effect" version
of the first image.  This is then faded to a "Bentley
Effect" version of the second image and finally faded to the
final image.

<dt><b>-block</b>

<dd>
The first image is defocused to small blocks.  The small blocks are converted
to match a defocused version of the last image.  The block version of the last
image is then focused to the final image.

<dt><b>-base</b> <i>name</i>

<dd>
This forms part of the output filenames, as described above.

</dl>

<h2 id="examples">EXAMPLES</h2>

<b>ppmfade -f teapot.ppm -l pyr.ppm</b>

<p>
Fade from teapot.ppm to pyr.ppm generating fade.0001.ppm to fade.0030.ppm using
the "spread" transition.

<p>
<b>ppmfade -l teapot.ppm</b>

<p>
Fade from black to teapot.ppm generating fade.0001.ppm to fade.0030.ppm.

<p>
<b>ppmfade -f teapot.ppm -base end</b>

<p>
Fade from teapot.ppm to black generating end.0001.ppm to end.0030.ppm.

<h2 id="seealso">SEE ALSO</h2>

<b>tontsc</b> manual,
<b>sgifade</b> manual,
<b>smart_vfr</b> manual,
<b>xmorph</b> manual,
<b><a href="ppm.html">ppm</a></b>

<h2 id="author">AUTHOR</h2>
Bryan Henderson, Olympia WA; April 2000

<p>Inspired by and intended as a replacement for <b>pbmfade</b> (not a
Netpbm program) by Wesley C. Barris.

<hr>
<h2 id="index">Table Of Contents</h2>
<ul>
<li><a href="#synopsis">SYNOPSIS</a>
<li><a href="#description">DESCRIPTION</a>
<li><a href="#options">OPTIONS</a>
<li><a href="#examples">EXAMPLES</a>
<li><a href="#seealso">SEE ALSO</a>
<li><a href="#author">AUTHOR</a>
</ul>
</body>
</html>