1Ppmntsc User Manual(0)                                  Ppmntsc User Manual(0)
2
3
4

NAME

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

SYNOPSIS

10       ppmntsc
11
12       [--pal]  [--legalonly]  [--illegalonly]  [--correctedonly]  [--verbose]
13       [--debug] [infile]
14
15       Minimum unique abbreviations of options are acceptable.
16
17

DESCRIPTION

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

OPTIONS

45       In addition to the options common to all programs  based  on  libnetpbm
46       (most notably -quiet, see
47        Common  Options  ⟨index.html#commonoptions⟩  ), ppmntsc recognizes the
48       following command line options:
49
50
51
52
53       --pal  Use the PAL transform instead of the default NTSC.
54
55
56       --verbose
57              Print a grand total of the number of illegal pixels.
58
59
60       --debug
61              Produce a humongous listing of illegal colors  and  their  legal
62              counterparts.   NOTE:   This  option may produce a great deal of
63              output.
64
65
66       --legalonly
67              Output only pixels that are  already  legal.   Output  black  in
68              place of pixels that are not.
69
70
71       --illegalonly
72              Output  only  pixels  that  are  illegal (and output them uncor‐
73              rected).  Output black in  place  of  pixels  that  are  already
74              legal.
75
76
77       --correctedonly
78              Output  only  pixels that are corrected versions of illegal pix‐
79              els.  Output black in place of pixels that are already legal.
80
81
82
83

SEE ALSO

85       pamdepth(1), ppmdim(1), pambrighten(1), ppm(1)
86
87

AUTHOR

89       Wes Barris, Minnesota Supercomputer Center, Inc., Bryan Henderson
90

DOCUMENT SOURCE

92       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
93       source.  The master documentation is at
94
95              http://netpbm.sourceforge.net/doc/ppmntsc.html
96
97netpbm documentation             19 April 2000          Ppmntsc User Manual(0)
Impressum