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 "Ppmntsc User Manual" 0 "April 19, 2000" "netpbm documentation"
7
8.SH NAME
9
10ppmntsc - Make RGB colors legal for NTSC or PAL color systems.
11
12.UN synopsis
13.SH SYNOPSIS
14
15\fBppmntsc\fP
16
17[\fB--pal\fP]
18[\fB--legalonly\fP]
19[\fB--illegalonly\fP]
20[\fB--correctedonly\fP]
21[\fB--verbose\fP]
22[\fB--debug\fP]
23[\fIinfile\fP]
24.PP
25Minimum unique abbreviations of options are acceptable.
26
27.UN description
28.SH DESCRIPTION
29.PP
30This program is part of
31.BR "Netpbm" (1)\c
32\&.
33.PP
34This program makes colors legal in the NTSC (or PAL) color systems.
35Often, images generated on the computer are made for use in movies
36which ultimately end up on a television screen.  However, the range of colors
37(as specified by their RGB values) on a computer does not match the
38range of colors that can be represented using the NTSC (or PAL)
39systems.  If an image with "illegal" colors is sent directly
40to an NTSC (or PAL) video system for recording, the
41"illegal" colors will be clipped.  This may result in an
42undesirable looking picture.
43.PP
44This utility tests each pixel in an image to see if it falls
45within the legal NTSC (or PAL) range.  If not, it raises or lowers the
46pixel's saturation in the output so that it does fall within legal
47limits.  Pixels that are already OK just go unmodified into the
48output.
49.PP
50Input is from the file named \fIinput\fP.  If \fIinput\fP is
51\fB-\fP, input is from Standard Input.  If you don't specify
52\fIinput\fP, input is from Standard Input.
53.PP
54Output is always to Standard Output.
55.PP
56This program handles multi-image PPM input, producing multi-image
57PPM output.
58
59.UN lbAE
60.SH OPTIONS
61
62
63
64.TP
65\fB--pal\fP
66Use the PAL transform instead of the default NTSC.
67
68.TP
69\fB--verbose\fP
70Print a grand total of the number of illegal pixels.
71
72.TP
73\fB--debug\fP
74Produce a humongous listing of illegal colors and their legal counterparts.
75NOTE:  This option may produce a great deal of output.
76
77.TP
78\fB--legalonly\fP
79Output only pixels that are already legal.  Output black in place of pixels
80that are not.
81
82.TP
83\fB--illegalonly\fP
84Output only pixels that are illegal (and output them uncorrected).
85Output black in place of pixels that are already legal.
86
87.TP
88\fB--correctedonly\fP
89Output only pixels that are corrected versions of illegal pixels.  Output
90black in place of pixels that are already legal.
91
92
93
94.UN seealso
95.SH SEE ALSO
96.BR "pamdepth" (1)\c
97\&,
98.BR "ppmdim" (1)\c
99\&,
100.BR "pambrighten" (1)\c
101\&,
102.BR "ppm" (5)\c
103\&
104
105.UN author
106.SH AUTHOR
107
108Wes Barris, Minnesota Supercomputer Center, Inc., Bryan Henderson
109.SH DOCUMENT SOURCE
110This manual page was generated by the Netpbm tool 'makeman' from HTML
111source.  The master documentation is at
112.IP
113.B http://netpbm.sourceforge.net/doc/ppmntsc.html
114.PP