ppmntsc - Man Page

• Make the RGB colors in a PPM image compatible with NTSC color systems: ppmntsc path/to/input_file.ppm > path/to/output_file.ppm
• Make the RGB colors in a PPM image compatible with PAL color systems: ppmntsc --pal path/to/input_file.ppm > path/to/output_file.ppm
• Print the number of illegal pixels in the input image to stderr: ppmntsc --verbose path/to/input_file.ppm > path/to/output_file.ppm
• Output only legal/illegal/corrected pixels, set other pixels to black: ppmntsc --legalonly|illegalonly|correctedonly path/to/input_file.ppm > path/to/output_file.ppm

tldr.sh

ppmntsc

[--pal] [--legalonly] [--illegalonly] [--correctedonly] [--verbose] [--debug] [infile]

Minimum unique abbreviations of options are acceptable.

This program is part of Netpbm(1).

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.

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.

Input is from the file named input.  If input is -, input is from Standard Input.  If you don't specify input, input is from Standard Input.

Output is always to Standard Output.

This program handles multi-image PPM input, producing multi-image PPM output.

In addition to the options common to all programs based on libnetpbm (most notably -quiet, see Common Options ), ppmntsc recognizes the following command line options:

--pal

Use the PAL transform instead of the default NTSC.

--verbose

Print a grand total of the number of illegal pixels.

--debug

Produce a humongous listing of illegal colors and their legal counterparts. NOTE:  This option may produce a great deal of output.

--legalonly

Output only pixels that are already legal.  Output black in place of pixels that are not.

--illegalonly

Output only pixels that are illegal (and output them uncorrected). Output black in place of pixels that are already legal.

--correctedonly

Output only pixels that are corrected versions of illegal pixels.  Output black in place of pixels that are already legal.

pamdepth(1), ppmdim(1), pambrighten(1), ppm(1)

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

This manual page was generated by the Netpbm tool 'makeman' from HTML source.  The master documentation is at

http://netpbm.sourceforge.net/doc/ppmntsc.html