ppmfade(1)

1Ppmfade User Manual(0)                                  Ppmfade User Manual(0)
2
3
4

NAME

6       ppmfade  -  generate a transition between two image files using special
7       effects
8
9

SYNOPSIS

11       ppmfade   [-f   first.ppm]    [-l    last.ppm]    [-mix|-spread|-shift|
12       -relief|-oil|-edge|-bentley|-block] [-base name]
13
14

DESCRIPTION

16       This program is part of Netpbm(1).
17
18       ppmfadegenerates  a  transition  between  either  two  input  images or
19       between one input image and black.  You can  use  the  30  intermediate
20       images  generated  to  show  a  smooth transition between segments of a
21       movie.  The input and output images are in  the  PPM  format.   If  you
22       specify  both  input images, they should both be the same size.  If you
23       want to fade from black to an image, specify only the last  image.   If
24       you  want to fade from an image to black, specify only the first image.
25       ppmfade names the resulting image files base.nnnn.ppm, where nnnn is  a
26       number  varying between 0001 and 0030 and base is what you specify with
27       via the -base option (default fade).
28
29       Another way to convert by steps from one image to another is  morphing.
30       You can use xmorph to do that.
31
32

OPTIONS

34       In  addition  to  the options common to all programs based on libnetpbm
35       (most notably -quiet, see
36        Common Options ⟨index.html#commonoptions⟩ ),  ppmfade  recognizes  the
37       following command line options:
38
39
40
41       -f first.ppm
42              This  is the image file (PPM format) to be used at the beginning
43              of the transition.  If you don't specify  this,  the  fade  will
44              start from black.
45
46
47       -l last.ppm
48              This  is the image file (PPM format) to be used at the ending of
49              the transition.  If you don't specify this, the  fade  will  end
50              with black.
51
52
53       -mix   The two images are superimposed with the brightness of the first
54              image decreasing from full to none and  the  brightness  of  the
55              final  image  increasing  from  none to full.  The transition is
56              quadratic in brightness with faster transition in the  beginning
57              and slower at the end.
58
59
60       -spread
61              The pixels in the first image will be moved (spread) further and
62              further from their original location and  then  moved  into  the
63              proper location in the final image.  This is the default transi‐
64              tion.
65
66
67       -shift The pixels in the first image will be shifted further  and  fur‐
68              ther  horizontally  from  their original location and then moved
69              into the proper location in the final image.
70
71
72       -relief
73              The first image is faded to a Laplacian relief filtered  version
74              of  the  first  image.  This is then faded to a Laplacian relief
75              filtered version of the second image and finally  faded  to  the
76              final image.
77
78
79       -oil   The  first  image  is  faded to an "oil transfer" version of the
80              first image.  This is then faded to an "oil transfer" version of
81              the second image and finally faded to the final image.
82
83
84       -edge  The  first  image  is  faded  to an edge detected version of the
85              first image.  This is then faded to an edge detected version  of
86              the second image and finally faded to the final image.
87
88
89       -bentley
90               The  first  image is faded to a "Bentley Effect" version of the
91              first image.  This is then faded to a "Bentley  Effect"  version
92              of the second image and finally faded to the final image.
93
94
95       -block The  first image is defocused to small blocks.  The small blocks
96              are converted to match a defocused version of  the  last  image.
97              The block version of the last image is then focused to the final
98              image.
99
100
101       -base name
102              This forms part of the output filenames, as described above.
103
104
105
106

EXAMPLES

108       ppmfade -f teapot.ppm -l pyr.ppm
109
110       Fade  from  teapot.ppm   to   pyr.ppm   generating   fade.0001.ppm   to
111       fade.0030.ppm using the "spread" transition.
112
113       ppmfade -l teapot.ppm
114
115       Fade   from   black   to   teapot.ppm   generating   fade.0001.ppm   to
116       fade.0030.ppm.
117
118       ppmfade -f teapot.ppm -base end
119
120       Fade from teapot.ppm to black generating end.0001.ppm to end.0030.ppm.
121
122

AUTHOR

128       Bryan Henderson, Olympia WA; April 2000
129
130       Inspired by and intended as a replacement for  pbmfade  (not  a  Netpbm
131       program) by Wesley C. Barris.
132

DOCUMENT SOURCE

134       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
135       source.  The master documentation is at
136
137              http://netpbm.sourceforge.net/doc/ppmfade.html
138
139netpbm documentation             01 April 2000          Ppmfade User Manual(0)