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

NAME

6       ppmcie - draw a CIE color chart as a PPM image
7
8

SYNOPSIS

10       ppmcie
11
12       [ -rec709|-cie|-ebu|-hdtv|-ntsc|-smpte ] [-xy|-upvp]
13
14       [-red rx ry]
15
16       [-green gx gy]
17
18       [-blue bx by]
19
20       [-white wx wy]
21
22       [-size edge]
23
24       [{-xsize|-width} width]
25
26       [{-ysize|-height} height]
27
28       [-noblack] [-nowpoint] [-nolabel] [-noaxes] [-full]
29
30

DESCRIPTION

32       This program is part of Netpbm(1).
33
34       ppmcie  creates  a PPM file containing a plot of the CIE "tongue" color
35       chart -- to the extent possible in a PPM image.  Alternatively, creates
36       a  pseudo-PPM  image  of the color tongue using RGB values from a color
37       system of your choice.
38
39       The CIE color tongue is an image of all the hues that can be  described
40       by CIE X-Y chromaticity coordinates.  They are arranged on a two dimen‐
41       sional coordinate plane with the X chromaticity on the horizontal  axis
42       and the Y chromaticity on the vertical scale.  (You can choose alterna‐
43       tively to use CIE u'-v' chromaticity coordinates, but the general  idea
44       of the color tongue is the same).
45
46       Note  that the PPM format specifies that the RGB values in the file are
47       from the ITU-R Recommendation  BT.709  color  system,  gamma-corrected.
48       And  positive.   See  ppm(1)  for details.  If you use one of the color
49       system options on ppmcie, what you get is not a true PPM image, but  is
50       very  similar.   If  you display such ppmcie output using a device that
51       expects PPM input (which includes just about any computer graphics dis‐
52       play program), it will display the wrong colors.
53
54       However,  you may have a device that expects one of these variations on
55       PPM.
56
57       In every RGB color system you can specify, including the default (which
58       produces  a  true  PPM  image)  there are hues in the color tongue that
59       can't be represented.  For example,  monochromatic  blue-green  with  a
60       wavelength of 500nm cannot be represented in a PPM image.
61
62       For  these  hues, ppmcie substitutes a similar hue as follows: They are
63       desaturated and rendered as the shade where the  edge  of  the  Maxwell
64       triangle  intersects a line drawn from the requested shade to the white
65       point defined by the color system's white point.   Furthermore,  unless
66       you  specify  the  -full  option, ppmcie reduces their intensity by 25%
67       compared to the true hues in the image.
68
69       ppmcie draws and labels the CIE X-Y coordinate axes unless  you  choose
70       otherwise with options.
71
72       ppmcie  draws  the  Maxwell triangle for the color system in use on the
73       color tongue.  The Maxwell triangle is the triangle whose vertices  are
74       the  primary illuminant hues for the color system.  The hues inside the
75       triangle show the color gamut for the color system.  They are also  the
76       only  ones  that  are  correct for the CIE X-Y chromaticity coordinates
77       shown.  (See explanation above).  ppmcie denotes the  Maxwell  triangle
78       by  rendering  it  at  full brightness, while rendering the rest of the
79       color tongue as 3/4 brightness.  You can turn this off with options.
80
81       ppmcie also places a black cross at  the  color  system's  white  point
82       (with  the  center  of the cross open so you can actually see the white
83       color) and displays in text the CIE X-Y chromaticities of  the  primary
84       illuminants  and  white  point for the color system.  You can turn this
85       off with options, though.
86
87       ppmcie annotates the periphery of the color tongue with the wavelength,
88       in nanometers of the monochromatic hues which appear there.
89
90       ppmcie  displays the black body chromaticity curve for Planckian radia‐
91       tors from 1000 to 30000 kelvins on the image.  This  curve  traces  the
92       colors of black bodies as various temperatures.
93
94       You  can  choose from several standard color systems, or specify one of
95       your own numerically.
96
97       CIE charts, by their very nature, contain a very large number  of  col‐
98       ors.   If  you're  encoding the chart for a color mapped device or file
99       format, you'll need to use pnmquant or ppmdither to reduce  the  number
100       of colors in the image.
101
102

OPTIONS

104       In  addition  to  the options common to all programs based on libnetpbm
105       (most notably -quiet, see
106        Common Options ⟨index.html#commonoptions⟩  ),  ppmcie  recognizes  the
107       following command line options:
108
109       You may abbreviate any option to its shortest unique prefix.
110
111
112
113       -rec709
114
115       -cie
116
117       -ebu
118
119       -hdtv
120
121       -ntsc
122
123       -smpte Select a standard color system whose gamut to plot.  The default
124              is -rec709, which chooses ITU-R  Recommendation  BT.709,  gamma-
125              corrected.   This  is  the  only color system for which ppmcie's
126              output is a  true  PPM  image.   See  explanation  above.   -ebu
127              chooses  the  primaries  used  in the PAL and SECAM broadcasting
128              standards.  -ntsc chooses the primaries specified  by  the  NTSC
129              broadcasting  system  (few  modern  monitors actually cover this
130              range).  -smpte selects the primaries recommended by the Society
131              of  Motion Picture and Television Engineers (SMPTE) in standards
132              RP-37 and RP-145, and -hdtv uses the  much  broader  HDTV  ideal
133              primaries.   -cie  chooses  a  color system that has the largest
134              possible gamut within the spectrum of the chart.   This  is  the
135              same  color  system  as  you  get  with  the -cie option to John
136              Walker's cietoppm program.
137
138
139       -xy    plot CIE 1931 x y chromaticities.  This is the default.
140
141
142       -upvp  plot u' v' 1976 chromaticities rather than CIE 1931  x  y  chro‐
143              maticities.   The  advantage  of u' v' coordinates is that equal
144              intervals of distance on the u' v' plane correspond  roughly  to
145              the eye's ability to discriminate colors.
146
147
148       -red rx ry
149              specifies  the CIE x and y co-ordinates of the red illuminant of
150              a custom color system and selects the custom system.
151
152
153       -green gx gy
154              specifies the CIE x and y co-ordinates of the  green  illuminant
155              of the color system and selects the custom system.
156
157
158       -blue bx by
159              specifies the CIE x and y co-ordinates of the blue illuminant of
160              the color system and selects the custom system.
161
162
163       -white wx wy
164              specifies the CIE x and y co-ordinates of the white point of the
165              color system and selects the custom system.
166
167
168       -size edge
169              Create an image of edge by edge pixels.  The default is 512x512.
170
171
172       -xsize|-width width
173              Sets  the  width  of  the  generated image to width pixels.  The
174              default width is 512 pixels.  If the height  and  width  of  the
175              image are not the same, the CIE diagram will be stretched in the
176              longer dimension.
177
178
179       -ysize|-height height
180              Sets the height of the generated image to  height  pixels.   The
181              default  height  is  512 pixels.  If the height and width of the
182              image are not the same, the CIE diagram will be stretched in the
183              longer dimension.
184
185
186       -noblack
187              Don't plot the black body chromaticity curve.
188
189
190       -nowpoint
191              Don't plot the color system's white point.
192
193
194       -nolabel
195              Omit the label.
196
197
198       -noaxes
199              Don't plot axes.
200
201
202       -full  Plot  the  entire  CIE  tongue in full brightness; don't dim the
203              part which is outside the gamut of the  specified  color  system
204              (i.e. outside the Maxwell triangle).
205
206
207
208

INTERPRETATION OF COLOR CHART

210       A  color  spectrum is a linear combination of one or more monochromatic
211       colors.
212
213       A color is a set of color spectra that all look the same to  the  human
214       eye  (and  brain).   Actually,  for  the purposes of the definition, we
215       assume the eye has infinite precision, so we can call two color spectra
216       different  colors even though they're so close a person couldn't possi‐
217       bly tell them apart.
218
219       The eye contains 3 kinds of color receptors (cones).  Each has  a  dif‐
220       ferent response to the various monochromatic colors.  One kind responds
221       most strongly to blue, another red, another green.  Because  there  are
222       only  three,  many  different  color  spectra  will excite the cones at
223       exactly the same level, so the eye cannot tell them  apart.   All  such
224       spectra that excite the cones in the same way are a single color.
225
226       Each  point  in  the color tongue represents a unique color.  But there
227       are an infinite number of color spectra in the set that is that  color;
228       i.e.  an  infinite  number of color spectra that would look to you like
229       this point.  A machine could tell them apart, but you could not.
230
231       Remember that the colors outside the highlighted triangle are  approxi‐
232       mations of the real colors because the PPM format cannot represent them
233       (and your display device  probably  cannot  display  them).   That  is,
234       unless you're using a variation of PPM and a special display device, as
235       discussed earlier in this manual.
236
237       A color is always relative to some given maximum brightness.  A partic‐
238       ular beam of light looks lime green if in a dim field, but pea green if
239       in a bright field.  An image on a movie screen  may  look  pitch  black
240       because the projector is not shining any light on it, but when you turn
241       off the projector and look at the same spot in room light,  the  screen
242       looks quite white.  The same light from that spot hit your eye with the
243       project on as with it off.
244
245       The chart shows two dimensions of color.  The third is intensity.   All
246       the  colors  in the chart have the same intensity.  To get all possible
247       colors in the gamut, Make copies of the whole chart at every  intensity
248       between zero and the maximum.
249
250       The  edge  of  the  tongue consists of all the monochromatic colors.  A
251       monochromatic color is one with a single wavelength.  I.e. a color that
252       is  in  a  rainbow.  The numbers you see are the wavelengths in nanome‐
253       ters.
254
255       Any straight line segment within the tongue contains colors  which  are
256       linear  combinations  of  two colors -- the colors at either end of the
257       line segment.
258
259       Any color in the chart can be created from two other colors  (actually,
260       from any of an infinite number of pairs of other colors).
261
262       All  the colors within a triangle inside the tongue can be created from
263       a linear combination of the colors at the vertices of that triangle.
264
265       Any color in the tongue can be created from  at  most  3  monochromatic
266       colors.
267
268       The  highlighted triangle shows the colors that can be expressed in the
269       tristimulus color system you chose.  (ITU-R BT.709  by  default).   The
270       corners of the triangle are the 3 primary illuminants in that system (a
271       certain red, green, and blue for BT.709).  The edges of  the  triangle,
272       then,  represent  the  colors you can represent with two of the primary
273       illuminants (saturated colors), and the  interior  colors  require  all
274       three primary illuminants (are not saturated).
275
276       In  the  ITU-R  BT.709  color  system (the default), the white point is
277       defined as D65, which is (and is named after) the color of a black body
278       at  6502  kelvins.   Therefore, you should see the temperature curve on
279       the image pass through the white part of the image, and the cross  that
280       marks the white point, at 6502 kelvins.
281
282       D65  white  is supposed to be the color of the sun.  If you have a per‐
283       fect BT.709 display device, you should see the color of the sun at  the
284       white point cross.  That's an important color, because when you look at
285       an object in sunlight, the color that reflects of the object  is  based
286       on  the  color  of  sunlight.   Note that the sun produces a particular
287       color spectrum, but many other color spectra are the  same  color,  and
288       display devices never use the actual color spectrum of the sun.
289
290       The colors at the corners of the triangle have the chromaticities phos‐
291       phors in a monitor that uses the selected color system.  Note  that  in
292       BT.709  they  are very close to monochromatic red, green, and blue, but
293       not quite.  That's why you can't display even one  true  color  of  the
294       rainbow on a video monitor.
295
296       Remember  that  the chart shows colors of constant intensity, therefore
297       the corners of the triangles are not the full  colors  of  the  primary
298       illuminants,  but  only their chromaticities.  In fact, the illuminants
299       typically have different intensities.   In  BT.709,  the  blue  primary
300       illuminant  is  far  more intense than the green, which is more intense
301       than the red.  Designers did this in order to make an equal combination
302       of  red,  green,  and  blue generate gray.  I.e.  a combination of full
303       strength red, full strength green, and full strength blue  BT.709  pri‐
304       mary illuminants is D65 white.
305
306       The  tongue  has a sharp straight edge at the bottom because that's the
307       limit of human vision.  There are colors  below  that  line,  but  they
308       involve  infrared  and  ultraviolet light, so you can't see them.  This
309       line is called the "line of purples."
310
311

SEE ALSO

313       ppmdither(1), pnmquant(1), ppm(1)
314
315

AUTHOR

317       Copyright (C) 1995 by John Walker (kelvin@fourmilab.ch)
318
319       WWW home page: http://www.fourmilab.ch/http://www.fourmilab.ch/
320
321       Permission to use, copy, modify, and distribute this software  and  its
322       documentation  for any purpose and without fee is hereby granted, with‐
323       out any conditions or restrictions.  This software is  provided  as  is
324       without express or implied warranty.
325

DOCUMENT SOURCE

327       This  manual  page was generated by the Netpbm tool 'makeman' from HTML
328       source.  The master documentation is at
329
330              http://netpbm.sourceforge.net/doc/ppmcie.html
331
332netpbm documentation             31 July 2005            Ppmcie User Manual(0)
Impressum