home *** CD-ROM | disk | FTP | other *** search
/ Online Praxis 1996 April / OP4_96.ISO / surfen / astro / earthv / cietoppm.doc < prev    next >
Text File  |  1996-08-19  |  6KB  |  129 lines
  1. CIETOPPM(1)              USER COMMANDS                CIETOPPM(1)
  2.  
  3. NAME
  4.      cietoppm - draw a CIE colour chart in a portable pixmap
  5.  
  6. SYNOPSIS
  7.      cietoppm [-noblack] [-nowpoint] [-interpwp] [-full]
  8.               [-cie|-ebu|-hdtv |-ntsc|-smpte] [-red rx ry]
  9.               [-green gx gy] [-blue bx by] [-white wx wy] [-size
  10.               edge] [-xsize|-width width] [-ysize|-height height]
  11.  
  12. DESCRIPTION
  13.      cietoppm creates a portable pixmap containing a plot of  the
  14.      CIE ``tongue'' colour chart, showing the colour gamut of ei-
  15.      ther a standard or user-specified colour  system,  annotated
  16.      with  axes,  a mark indicating the white point of the colour
  17.      system, and the black body chromaticity curve for  Planckian
  18.      radiators  from  1000 to 30000 degrees Kelvin.  The axes are
  19.      labeled with the CIE X and Y coordinates, the  periphery  of
  20.      the  tongue  is  annotated  with the wavelength of light, in
  21.      nanometres, of the pure hues which  appear  there,  and  the
  22.      black body chromaticity curve is marked with the temperature
  23.      in degrees Kelvin.
  24.  
  25.      CIE charts, by their  very  nature,  contain  a  very  large
  26.      number  of  colours.   If  you're  encoding  the chart for a
  27.      colour mapped device or file  format,  you'll  need  to  use
  28.      ppmquant or ppmdither to reduce the number of colours in the
  29.      image.
  30.  
  31. OPTIONS
  32.      -cie|-ebu|-hdtv|-ntsc|-smpte
  33.                Select a standard colour system whose  gamut  (the
  34.                area  inside the triangle formed by the three pri-
  35.                mary colours) and white point are  plotted  within
  36.                the  CIE  tongue  chart.  The default is -ebu, the
  37.                primaries used in the PAL and  SECAM  broadcasting
  38.                standards.   -ntsc chooses the primaries specified
  39.                by the NTSC broadcasting system (few modern  moni-
  40.                tors  actually  cover this range).  -smpte selects
  41.                the primaries recommended by the Society of Motion
  42.                Picture  and Television Engineers (SMPTE) in stan-
  43.                dards RP-37 and RP-145, and -hdtv  uses  the  much
  44.                broader  HDTV  ideal primaries.  -cie uses the CIE
  45.                RGB primaries with wavelengths of  700  nm,  546.1
  46.                nm, and 438.8 nm respectively; the CIE white point
  47.                is defined by equal R, G, and B intensities.
  48.  
  49.      -red rx ry
  50.                specifies the CIE x and y co-ordinates of the  red
  51.                illuminant  of  a custom colour system and selects
  52.                the custom system.
  53.  
  54.      -green gx gy
  55.                specifies the CIE x  and  y  co-ordinates  of  the
  56.                green  illuminant of the colour system and selects
  57.                the custom system.
  58.  
  59.      -blue bx by
  60.                specifies the CIE x and y co-ordinates of the blue
  61.                illuminant  of  the  colour system and selects the
  62.                custom system.
  63.  
  64.      -white wx wy
  65.                specifies the CIE x  and  y  co-ordinates  of  the
  66.                white  point  of the colour system and selects the
  67.                custom system.
  68.  
  69.      -size edge
  70.                Create a pixmap of edge by edge pixels.   The  de-
  71.                fault is 512x512.
  72.  
  73.      -xsize|-width width
  74.                Sets the width of the  generated  image  to  width
  75.                pixels.   The default width is 512 pixels.  If the
  76.                height and width of the image are  not  the  same,
  77.                the  CIE  diagram  will be stretched in the longer
  78.                dimension.
  79.  
  80.      -ysize|-height height
  81.                Sets the height of the generated image  to  height
  82.                pixels.  The default height is 512 pixels.  If the
  83.                height and width of the image are  not  the  same,
  84.                the  CIE  diagram  will be stretched in the longer
  85.                dimension.
  86.  
  87.      -noblack  Don't plot the black body chromaticity curve.
  88.  
  89.      -nowhite  Don't plot the colour system's white point.
  90.  
  91.      -full     Plot the entire  CIE  tongue  in  full  intensity;
  92.                don't  enhance  the  gamut of the specified colour
  93.                system.
  94.  
  95.      -interpwp Interpolate out-of-gamut colours using the  colour
  96.                system's white point as the origin of the interpo-
  97.                lation line.  By default, the white defined by  an
  98.                equal mix of the three primaries is used.
  99.  
  100.      All flags can be abbreviated to their shortest  unique  pre-
  101.      fix.
  102.  
  103. BUGS
  104.      Obviously, colours outside the gamut of the device  used  to
  105.      view  or  print the CIE chart cannot be rendered accurately.
  106.      Colours outside the Maxwell's triangle formed by  the  three
  107.      illuminants  are desaturated and rendered as the shade where
  108.      the edge of the gamut triangle intersects a line drawn  from
  109.      the  requested  shade to the white point defined by an equal
  110.      mixture of the illuminants (or  the  colour  system's  white
  111.      point,  if  -interpwp  is  specified).   These  out of gamut
  112.      colours are drawn ``subdued'' at 3/4 the  intensity  of  the
  113.      shades  within  the  gamut unless the -full switch is speci-
  114.      fied, in which case in-gamut and out of  gamut  colours  are
  115.      not distinguished.
  116.  
  117. SEE ALSO
  118.      ppmdither(1), ppmquant(1), ppm(5)
  119.  
  120. AUTHOR
  121.        Copyright (C) 1994 by John Walker (kelvin@fourmilab.ch).
  122.               WWW home page: http://www.fourmilab.ch/
  123.  
  124.      Permission  to  use,  copy,  modify,  and  distribute   this
  125.      software  and  its documentation for any purpose and without
  126.      fee is hereby granted, without any  conditions  or  restric-
  127.      tions.   This software is provided ``as is'' without express
  128.      or implied warranty.
  129.