1Ppmntsc User Manual(0) Ppmntsc User Manual(0)
2
3
4
6 ppmntsc - Make RGB colors legal for NTSC or PAL color systems.
7
8
10 ppmntsc
11
12 [--pal] [--legalonly] [--illegalonly] [--correctedonly] [--verbose]
13 [--debug] [infile]
14
15 Minimum unique abbreviations of options are acceptable.
16
17
19 This program is part of Netpbm(1).
20
21 This program makes colors legal in the NTSC (or PAL) color systems.
22 Often, images generated on the computer are made for use in movies
23 which ultimately end up on a television screen. However, the range of
24 colors (as specified by their RGB values) on a computer does not match
25 the range of colors that can be represented using the NTSC (or PAL)
26 systems. If an image with 'illegal' colors is sent directly to an NTSC
27 (or PAL) video system for recording, the 'illegal' colors will be
28 clipped. This may result in an undesirable looking picture.
29
30 This utility tests each pixel in an image to see if it falls within the
31 legal NTSC (or PAL) range. If not, it raises or lowers the pixel's
32 saturation in the output so that it does fall within legal limits.
33 Pixels that are already OK just go unmodified into the output.
34
35 Input is from the file named input. If input is -, input is from Stan‐
36 dard Input. If you don't specify input, input is from Standard Input.
37
38 Output is always to Standard Output.
39
40 This program handles multi-image PPM input, producing multi-image PPM
41 output.
42
43
45 --pal Use the PAL transform instead of the default NTSC.
46
47
48 --verbose
49 Print a grand total of the number of illegal pixels.
50
51
52 --debug
53 Produce a humongous listing of illegal colors and their legal
54 counterparts. NOTE: This option may produce a great deal of
55 output.
56
57
58 --legalonly
59 Output only pixels that are already legal. Output black in
60 place of pixels that are not.
61
62
63 --illegalonly
64 Output only pixels that are illegal (and output them uncor‐
65 rected). Output black in place of pixels that are already
66 legal.
67
68
69 --correctedonly
70 Output only pixels that are corrected versions of illegal pix‐
71 els. Output black in place of pixels that are already legal.
72
73
74
75
77 pamdepth(1), ppmdim(1), ppmbrighten(1), ppm(1)
78
79
81 Wes Barris, Minnesota Supercomputer Center, Inc., Bryan Henderson
82
83
84
85netpbm documentation April 19, 2000 Ppmntsc User Manual(0)