

        \\\\\\\\\\\\\\\\\\\\ ///////////////////////

        example programs using the autocolor attribute

        //////////////////// \\\\\\\\\\\\\\\\\\\\\\

Note: There is no autocolor visual object.  Rather, these examples demonstrate
      how the KCOLOR_AUTOCOLOR autocolor attribute can be used with Color 
      Services on a data object to change the colormap.

1.autocolor_rdonly/

  This program displays an image to be autocolored. It then creates a list
  object to display all the currently supported colormaps.  Each time a
  colormap is selected from the list, that colormap is applied to the image.
  A read/only color allocation policy is used which allows applications to
  share colors and avoid techno-flashing.

2.autocolor_readwrite/

  This program displays an image to be autocolored. It then creates a list
  object to display all the currently supported colormaps.  Each time a
  colormap is selected from the list, that colormap is applied to the image.
  A read/write color allocation policy is used to speed up the installation
  of new colormaps.

3.autocolor_timer/

  This example illustrates static colormaps and dynamic colormaps.  
  Some colormaps always have the same effect on the image, regardless of when 
  the colormap is installed, or which colormap was previously installed on the 
  image.  These colormaps are referred to as static;  examples of these 
  include RGB Cube, HLS Spiral, and SA PSeudo.  Other colormaps have different 
  effects on the image each time they are installed, since they use the 
  currently-installed colormap as a basis from which to derive a new colormap.  
  These colormaps are referred to as dynamic;  examples of these include 
  Rotate Left (rotates each of the RGB color components one place to the left), 
  Rotate Right, and Reverse.

  This program displays an image with its original colormap.  It then puts up
  two lists, a list of the static colormaps on the left, and a list of the
  dynamic colormaps on the right.  When a colormap is chosen from the list of
  static colormaps on the left, the colormap is simply installed on the image.

  In contrast, the program installs a timeout on the image so that whenever a
  dynamic colormap is chosen from the list on the right, that dynamic colormap
  is repeatedly re-installed on the image at very short time intervals, thus 
  demonstrating the dynamic quality of the colormap. 

  By choosing a static colormap to "initialize" the colormap, and then by 
  choosing a dynamic colormap that will be re-installed repeatedly
  (each installation using the previous colormap as a basis for deriving 
   the new colormap), very interesting effects may be achieved.

  Although the default input image is a sequence also used in animations, 
  here, only the first image band is used;  the effect is not a result of 
  animation, but only of repeated installations of dynamic colormaps.
