summary refs log tree commit diff
path: root/ppmmix.html
blob: e7b5e833eb69692e2c22e08569a057c3b84b6d81 (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
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.3//EN">
<html><head><title>Ppmmix User Manual</title></head>
<body>
<h1>ppmmix</h1>
Updated: 23 March 2010
<br>
<a href="#index">Table Of Contents</a>

<h2>NAME</h2>

ppmmix - blend together two PPM images

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

ppmmix <i>fadefactor</i> <i>ppmfile1</i> <i>ppmfile2</i>

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

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

<p><b>ppmmix</b> reads two PPM images as input and mixes them together
using the specified fade factor.  The fade factor may be in the range
from 0.0 (only ppmfile1's image data) to 1.0 (only ppmfile2's image
data).  Anything in between specifies a smooth blend between the two
images.

<p>The two images must have the same dimensions and the same maxval.  Before
Netpbm 10.54 (March 2011), they must also have the same type (PBM/PGM/PPM).

<p>The fade factor is applied to brightness, not light intensity.  That means
for example that if you have a series of images you generated
using <b>ppmmix</b> of a black and a white image with a linearly increasing
fade factor, you will see an image getting linearly brighter, but the light
intensity will increase faster at the end.  That is because it requires more
intensity change at the bright end of the scale than at the dark end for the
human eye to perceive the same brightness change.  This also means that
if the original images aren't all one color, the mixed image is distorted,
since the intensity relationship between pixels is different from the
original image.

<p><b>pamcomp</b> is a more general alternative.  It allows you to mix
images of different size and to have the fade factor vary throughout
the image (through the use of a transparency mask).  It does not have the
same-maxval and same-type restrictions.  It mixes light intensity, not
brightness.

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

<p>There are no command line options defined specifically
for <b>ppmmix</b>, but it recognizes the options common to all
programs based on libnetpbm (See <a href="index.html#commonoptions">
Common Options</a>.)

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

<b><a href="pamcomp.html">pamcomp</a></b>,
<b><a href="pammixmulti.html">pammixmulti</a></b>,
<b><a href="ppm.html">ppm</a></b>

<h2 id="author">AUTHOR</h2>

Copyright (C) 1993 by Frank Neumann

<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="#seealso">SEE ALSO</a>
<li><a href="#author">AUTHOR</a>
</ul>
</body>
</html>