\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it!  If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Ppmmix User Manual" 0 "23 March 2010" "netpbm documentation"

.SH NAME

ppmmix - blend together two PPM images

.UN synopsis
.SH SYNOPSIS

ppmmix \fIfadefactor\fP \fIppmfile1\fP \fIppmfile2\fP

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBppmmix\fP 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.
.PP
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).
.PP
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 \fBppmmix\fP 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.
.PP
\fBpamcomp\fP 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.

.UN options
.SH OPTIONS
.PP
There are no command line options defined specifically
for \fBppmmix\fP, but it recognizes the options common to all
programs based on libnetpbm (See 
.UR index.html#commonoptions
 Common Options
.UE
\&.)

.UN seealso
.SH SEE ALSO
.BR "pamcomp" (1)\c
\&,
.BR "pammixmulti" (1)\c
\&,
.BR "ppm" (5)\c
\&

.UN author
.SH AUTHOR

Copyright (C) 1993 by Frank Neumann
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source.  The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/ppmmix.html
.PP