\
.\" 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 "Ppmntsc User Manual" 1 "19 April 2000" "netpbm documentation"

.SH NAME

ppmntsc - Make RGB colors legal for NTSC or PAL color systems.

.UN synopsis
.SH SYNOPSIS

\fBppmntsc\fP

[\fB--pal\fP]
[\fB--legalonly\fP]
[\fB--illegalonly\fP]
[\fB--correctedonly\fP]
[\fB--verbose\fP]
[\fB--debug\fP]
[\fIinfile\fP]
.PP
Minimum unique abbreviations of options are acceptable.

.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
This program makes colors legal in the NTSC (or PAL) color systems.
Often, images generated on the computer are made for use in movies
which ultimately end up on a television screen.  However, the range of colors
(as specified by their RGB values) on a computer does not match the
range of colors that can be represented using the NTSC (or PAL)
systems.  If an image with "illegal" colors is sent directly
to an NTSC (or PAL) video system for recording, the
"illegal" colors will be clipped.  This may result in an
undesirable looking picture.
.PP
This utility tests each pixel in an image to see if it falls
within the legal NTSC (or PAL) range.  If not, it raises or lowers the
pixel's saturation in the output so that it does fall within legal
limits.  Pixels that are already OK just go unmodified into the
output.
.PP
Input is from the file named \fIinput\fP.  If \fIinput\fP is
\fB-\fP, input is from Standard Input.  If you don't specify
\fIinput\fP, input is from Standard Input.
.PP
Output is always to Standard Output.
.PP
This program handles multi-image PPM input, producing multi-image
PPM output.

.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see 
.UR index.html#commonoptions
 Common Options
.UE
\&), \fBppmntsc\fP recognizes the following
command line options:



.TP
\fB--pal\fP
Use the PAL transform instead of the default NTSC.

.TP
\fB--verbose\fP
Print a grand total of the number of illegal pixels.

.TP
\fB--debug\fP
Produce a humongous listing of illegal colors and their legal counterparts.
NOTE:  This option may produce a great deal of output.

.TP
\fB--legalonly\fP
Output only pixels that are already legal.  Output black in place of pixels
that are not.

.TP
\fB--illegalonly\fP
Output only pixels that are illegal (and output them uncorrected).
Output black in place of pixels that are already legal.

.TP
\fB--correctedonly\fP
Output only pixels that are corrected versions of illegal pixels.  Output
black in place of pixels that are already legal.



.UN seealso
.SH SEE ALSO
.BR "pamdepth" (1)\c
\&,
.BR "ppmdim" (1)\c
\&,
.BR "pambrighten" (1)\c
\&,
.BR "ppm" (1)\c
\&

.UN author
.SH AUTHOR

Wes Barris, Minnesota Supercomputer Center, Inc., Bryan Henderson
.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/ppmntsc.html
.PP