Debian Codegraph @

upstream/debian-unstable/man1/ppmntsc.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 "Ppmntsc User Manual" 1 "19 April 2000" "netpbm documentation"
7
8 .SH NAME
9
10 ppmntsc - 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
25 Minimum unique abbreviations of options are acceptable.
26
27 .UN description
28 .SH DESCRIPTION
29 .PP
30 This program is part of
31 .BR "Netpbm" (1)\c
32 \&.
33 .PP
34 This program makes colors legal in the NTSC (or PAL) color systems.
35 Often, images generated on the computer are made for use in movies
36 which 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
38 range of colors that can be represented using the NTSC (or PAL)
39 systems. If an image with "illegal" colors is sent directly
40 to an NTSC (or PAL) video system for recording, the
41 "illegal" colors will be clipped. This may result in an
42 undesirable looking picture.
43 .PP
44 This utility tests each pixel in an image to see if it falls
45 within the legal NTSC (or PAL) range. If not, it raises or lowers the
46 pixel's saturation in the output so that it does fall within legal
47 limits. Pixels that are already OK just go unmodified into the
48 output.
49 .PP
50 Input 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
54 Output is always to Standard Output.
55 .PP
56 This program handles multi-image PPM input, producing multi-image
57 PPM output.
58
59 .UN options
60 .SH OPTIONS
61 .PP
62 In addition to the options common to all programs based on libnetpbm
63 (most notably \fB-quiet\fP, see
64 .UR index.html#commonoptions
65 Common Options
66 .UE
67 \&), \fBppmntsc\fP recognizes the following
68 command line options:
69
70
71
72 .TP
73 \fB--pal\fP
74 Use the PAL transform instead of the default NTSC.
75
76 .TP
77 \fB--verbose\fP
78 Print a grand total of the number of illegal pixels.
79
80 .TP
81 \fB--debug\fP
82 Produce a humongous listing of illegal colors and their legal counterparts.
83 NOTE: This option may produce a great deal of output.
84
85 .TP
86 \fB--legalonly\fP
87 Output only pixels that are already legal. Output black in place of pixels
88 that are not.
89
90 .TP
91 \fB--illegalonly\fP
92 Output only pixels that are illegal (and output them uncorrected).
93 Output black in place of pixels that are already legal.
94
95 .TP
96 \fB--correctedonly\fP
97 Output only pixels that are corrected versions of illegal pixels. Output
98 black in place of pixels that are already legal.
99
100
101
102 .UN seealso
103 .SH SEE ALSO
104 .BR "pamdepth" (1)\c
105 \&,
106 .BR "ppmdim" (1)\c
107 \&,
108 .BR "pambrighten" (1)\c
109 \&,
110 .BR "ppm" (1)\c
111 \&
112
113 .UN author
114 .SH AUTHOR
115
116 Wes Barris, Minnesota Supercomputer Center, Inc., Bryan Henderson
117 .SH DOCUMENT SOURCE
118 This manual page was generated by the Netpbm tool 'makeman' from HTML
119 source. The master documentation is at
120 .IP
121 .B http://netpbm.sourceforge.net/doc/ppmntsc.html
122 .PP