**********************************************************

       Welcome to ColorMapper V1.0, the interactive
       colormap configuration editor.

       Written by : SoftTronics, Lutz + Kretzschmar

**********************************************************

This software is a handy tool for interactively creating color maps or
spreads (most useful for raytracers).

It features a GUI interface and requires:
- a Standard VGA Graphics Card that supports 320x200x256 (the program uses the
  SVGA256.BGI Driver).
- a Microsoft-compatible mouse.


------
Usage:
------

  Simply call the program from the DOS command line:

    C:\>cmapper

  You will then see the graphics screen that you work on.


 Quitting
 --------
  To quit the program either press ESC or the right mouse button.

 Display
 -------
  You will see the colormap display as a thick band at the top of the
  screen, together with another this band above it, representing the
  alpha channel.
  Below that are 'nodes' (4 at startup) that define the colormap.
  Below that is the color editing field.
  Below that is a small menu area.

 Theory of Operation
 -------------------
  Pointing to the colormap are arrows that originate at squares further
  down ('Nodes', see above). These arrows can be pushed around to change
  the position of where the color that is in the node affects the colormap.
  Simply click and drag the left mouse button while near an arrow tip.

  Below the nodes is the color editing field. Here you edit a the color
  of a single node by moving sliders about. You can change the RGB values
  directly or use the Hue, Luminosity and Saturation slider to change
  the colors. You can also change the alpha value of the node by moving
  the alpha slider (obviously!).
  If you want to change one of the 7 values (R,G,B,H,L,S,A) of ALL the nodes
  then press SHIFT while you move the corresponding slider. All nodes will
  be set to this new value.
  This, for example, allows you to set all nodes the same luminance (actual
  color).

  The square next to the slider is just for display and shows the color
  currently in the editor.

 Menu
 ----
  þ Nodes++
    You can increase the number of nodes up to a maximum of 12 (this is
    arbitrary, if anyone needs more than 12 they should contact me). I
    think 12 is enough (actually I've never used more than 7 [for marble]).
  þ Nodes--
    You can decrease the number of nodes down to a minimum of 3.
  þ CopyTo
    You can copy the settings of one node to another node. The cursor \
    changes to a 'TO' cursor and you must click on a node to which you
    wish to copy the settings.
  þ CopyFrom
    Similar to Copy To.
  þ Save F2
    This saves the current setup on disk, so that you can read it in
    later. The format is somewhat less complicated than the PoV source,
    but still a text file. (If you want to convert existing PoV color maps
    examine the format and convert the file, it's really simple! Basically
    all you need to do is leave out the keywords!).
  þ Load F3
    This loads a previously saved setup on disk, so that you can resume
    editing your last map. This only read files that are formatted as by
    Save (I was too lazy to incorporate a parser!).
  þ Print F8
    This prints the current color map to PoV format.
  þ Quit F10
    100 points if you can figure this one out!


  Thats it! Any further suggestions, enhancements or comments are welcome.

  Have fun!

----------------------------------------------------------------------

Official Stuff:


This software is hereby released to the public domain and is, in this
version, free of charge.


Disclaimer:
-----------
I will not be held responsible for anything this program does or causes
to anything or anybody, under any circumstances (so there!).
However, if you find a bug I'd be grateful if you could let me know.


Credits:
--------
Thanks to Jordan Hargrave [72510,1143] for writing the BGI SVGA Driver
and thus making it really simple to use the SVGA cards in the 256-color
modes.

The RGB to HLS and vice versa conversion code is from
"Fundamentals of three-dimensional computer graphics" by Alan Watt.

The layout of this program as well as the functionality was inspired
by a small section of a professional RayTracer for Silicon Graphics
hardware by the name of SoftImage, which I saw at an exhibition a few
weeks ago (now if I had that horsepower and that software ..... sigh!)


Support:
--------

I can be reached in the following ways :

  CIS  : 100023,2006   (preferred.)

  BIX  : lkretzschmar

  Fax  : +49 89 8204270

  Tel  : +49 89 8204250

  Mail : SoftTronics
         Fritz-Reuter-Str. 20B
         D-8000 Munich 60
         Germany

Technical Stuff:
----------------
  CMAPPER was written in Turbo Pascal V6.0 and uses the object-oriented
  extension a little. All source code is self-written.

