Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
ppmcie(1)
Edit
PageHistory
Diff
Info
LikePages
PPMCIE !!!PPMCIE NAME SYNOPSIS DESCRIPTION OPTIONS SEE ALSO AUTHOR ---- !!NAME ppmcie - draw a CIE color chart as a PPM image !!SYNOPSIS __ppmcie__ [[__-rec709__|__-cie__|__-ebu__|__-hdtv__|__-ntsc__|__-smpte__] [[__-xy__|__-upvp__] [[__-red__ ''rx ry''] [[__-green__ ''gx gy''] [[__-blue__ ''bx by''] [[__-white__ ''wx wy''] [[__-size__ ''edge''] [[__-xsize__|__-width__ ''width''] [[__-ysize__|__-height__ ''height''] [[__-noblack__] [[__-nowpoint__] [[__-nolabel__] [[__-noaxes__] [[__-full__] All options can be abbreviated to their shortest unique prefix. !!DESCRIPTION __ppmcie__ creates a PPM file containing a plot of the CIE ``tongue'' color chart -- to the extent possible in a PPM image. Alternatively, creates a pseudo-PPM image of the color tongue using RGB values from a color system of your choice. The CIE color tongue is an image of all the hues that can be described by CIE X-Y chromaticity coordinates. They are arranged on a two dimensional coordinate plane with the X chromaticity on the horizontal axis and the Y chro- maticity on the vertical scale. (You can choose alterna- tively to use CIE u'-v' chromaticity coordinates, but the general idea of the color tongue is the same). Note that the PPM format specifies that the RGB values in the file are from CIE Rec. 709 color system, gamma-cor- rected. And positive. See ppm(5) for details. If you use one of the color system options on __ppmcie__, what you get is not a true PPM image, but is very similar. If you display such __ppmcie__ output using a device that expects PPM input (which includes just about any computer graphics display program), it will display the wrong colors. However, you may have a device that expects one of these variations on PPM. In every RGB color system you can specify, including the default (which produces a true PPM image) there are hues in the color tongue that can't be represented. For exam- ple, monochromatic blue-green with a wavelength of 500nm cannot be represented in a PPM image. For these hues, __ppmcie__ substitutes a similar hue as fol- lows: They are desaturated and rendered as the shade where the edge of the Maxwell triangle intersects a line drawn from the requested shade to the white point defined by the color system's white point. Furthermore, unless you spec- ify the __-full__ option, __ppmcie__ reduces their intensity by 25% compared to the true hues in the image. __ppmcie__ draws and labels the CIE X-Y coordinate axes unless you choose otherwise with options. __ppmcie__ draws the Maxwell triangle for the color system in use on the color tongue. The Maxwell triangle is the tri- angle whose vertices are the primary illuminant hues for the color system. The hues inside the triangle show the color gamut for the color system. They are also the only ones that are correct for the CIE X-Y chromaticity coordi- nates shown. (See explanation above). __ppmcie__ also places a mark at the color system's white point and displays in text the CIE X-Y chromaticities of the primary illuminants and white point for the color sys- tem. You can turn this off with options, though. __ppmcie__ annotates the periphery of the color tongue with the wavelength, in nanometers of the monochromatic hues which appear there. Finally, __ppmcie__ displays the black body chromaticity curve for Planckian radiators from 1000 to 30000 kelvins on the image. You can choose from several standard color systems, or specify one of your own numerically. CIE charts, by their very nature, contain a very large number of colors. If you're encoding the chart for a col- or mapped device or file format, you'll need to use __pp- mquant__ or __ppmdither__ to reduce the number of colors in the image. !!OPTIONS __-rec709__|__-cie__|__-ebu__|__-hdtv__|__-ntsc__|__-smpte__ Select a standard color system whose gamut to plot. The default is __-rec709__, which chooses CIE Rec. 709, gamma-corrected. This is the only color system for which __ppmcie__'s output is a true PPM image. See explanation above. __-ebu__ chooses the primaries used in the PAL and SECAM broad- casting standards. __-ntsc__ chooses the primaries specified by the NTSC broadcasting system (few modern monitors actually cover this range). __-smpte__ selects the primaries recommended by the Society of Motion Picture and Television Engi- neers (SMPTE) in standards RP-37 and RP-145, and __-hdtv__ uses the much broader ''HDTV ideal'' pri- maries. __-cie__ chooses a color system that has the largest possible gamut within the spectrum of the chart. This is the same color system as you get with the __-cie__ option to John Walker's __cietoppm__ program. __-xy__ plot CIE 1931 x y chromaticities. This is the default. __-upvp__ plot u' v' 1976 chromaticities rather than CIE 1931 x y chromaticities. The advantage of u' v' coordinates is that equal intervals of distance on the u' v' plane correspond roughly to the eye's ability to discriminate colors. __-red__ ''rx ry'' specifies the CIE ''x'' and ''y'' co-ordinates of the red illuminant of a custom color system and se- lects the custom system. __-green__ ''gx gy'' specifies the CIE ''x'' and ''y'' co-ordinates of the green illuminant of the color system and selects the custom system. __-blue__ ''bx by'' specifies the CIE ''x'' and ''y'' co-ordinates of the blue illuminant of the color system and selects the custom system. __-white__ ''wx wy'' specifies the CIE ''x'' and ''y'' co-ordinates of the white point of the color system and selects the custom system. __-size__ ''edge'' Create a pixmap of ''edge'' by ''edge'' pixels. The de- fault is 512x512. __-xsize|-width__ ''width'' Sets the width of the generated image to ''width'' pixels. The default width is 512 pixels. If the height and width of the image are not the same, the CIE diagram will be stretched in the longer dimension. __-ysize|-height__ ''height'' Sets the height of the generated image to ''height'' pixels. The default height is 512 pixels. If the height and width of the image are not the same, the CIE diagram will be stretched in the longer dimension. __-noblack__ Don't plot the black body chromaticity curve. __-nowpoint__ Don't plot the color system's white point. __-nolabel__ Omit the label. __-noaxes__ Don't plot axes. __-full__ Plot the entire CIE tongue in full intensity; don't enhance the gamut of the specified color system. !!SEE ALSO ppmdither(1), ppmquant(1), ppm(5) !!AUTHOR Copyright (C) 1995 by John Walker (kelvin@fourmilab.ch) WWW home page: http://www.fourmilab.ch/ Permission to use, copy, modify, and distribute this soft- ware and its documentation for any purpose and without fee is hereby granted, without any conditions or restrictions. This software is provided ``as is'' without express or im- plied warranty. ----
One page links to
ppmcie(1)
:
Man1p
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
