Debian Codegraph @

upstream/debian-unstable/man1/ppmmix.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 "Ppmmix User Manual" 1 "23 March 2010" "netpbm documentation"
7
8 .SH NAME
9
10 ppmmix - blend together two PPM images
11
12 .UN synopsis
13 .SH SYNOPSIS
14
15 ppmmix \fIfadefactor\fP \fIppmfile1\fP \fIppmfile2\fP
16
17 .UN description
18 .SH DESCRIPTION
19 .PP
20 This program is part of
21 .BR "Netpbm" (1)\c
22 \&.
23 .PP
24 \fBppmmix\fP reads two PPM images as input and mixes them together
25 using the specified fade factor. The fade factor may be in the range
26 from 0.0 (only ppmfile1's image data) to 1.0 (only ppmfile2's image
27 data). Anything in between specifies a smooth blend between the two
28 images.
29 .PP
30 The two images must have the same dimensions and the same maxval. Before
31 Netpbm 10.54 (March 2011), they must also have the same type (PBM/PGM/PPM).
32 .PP
33 The fade factor is applied to brightness, not light intensity. That means
34 for example that if you have a series of images you generated
35 using \fBppmmix\fP of a black and a white image with a linearly increasing
36 fade factor, you will see an image getting linearly brighter, but the light
37 intensity will increase faster at the end. That is because it requires more
38 intensity change at the bright end of the scale than at the dark end for the
39 human eye to perceive the same brightness change. This also means that
40 if the original images aren't all one color, the mixed image is distorted,
41 since the intensity relationship between pixels is different from the
42 original image.
43 .PP
44 \fBpamcomp\fP is a more general alternative. It allows you to mix
45 images of different size and to have the fade factor vary throughout
46 the image (through the use of a transparency mask). It does not have the
47 same-maxval and same-type restrictions. It mixes light intensity, not
48 brightness.
49
50 .UN options
51 .SH OPTIONS
52 .PP
53 There are no command line options defined specifically
54 for \fBppmmix\fP, but it recognizes the options common to all
55 programs based on libnetpbm (See
56 .UR index.html#commonoptions
57 Common Options
58 .UE
59 \&.)
60
61 .UN seealso
62 .SH SEE ALSO
63 .BR "pamcomp" (1)\c
64 \&,
65 .BR "pammixmulti" (1)\c
66 \&,
67 .BR "ppm" (1)\c
68 \&
69
70 .UN author
71 .SH AUTHOR
72
73 Copyright (C) 1993 by Frank Neumann
74 .SH DOCUMENT SOURCE
75 This manual page was generated by the Netpbm tool 'makeman' from HTML
76 source. The master documentation is at
77 .IP
78 .B http://netpbm.sourceforge.net/doc/ppmmix.html
79 .PP