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