home *** CD-ROM | disk | FTP | other *** search
/ CD-X 1 / cdx_01.iso / shareuti / cmapper / cmapper.doc < prev    next >
Encoding:
Text File  |  1991-12-04  |  4.9 KB  |  152 lines
  1. **********************************************************
  2.  
  3.        Welcome to ColorMapper V1.0, the interactive
  4.        colormap configuration editor.
  5.  
  6.        Written by : SoftTronics, Lutz + Kretzschmar
  7.  
  8. **********************************************************
  9.  
  10. This software is a handy tool for interactively creating color maps or
  11. spreads (most useful for raytracers).
  12.  
  13. It features a GUI interface and requires:
  14. - a Standard VGA Graphics Card that supports 320x200x256 (the program uses the
  15.   SVGA256.BGI Driver).
  16. - a Microsoft-compatible mouse.
  17.  
  18.  
  19. ------
  20. Usage:
  21. ------
  22.  
  23.   Simply call the program from the DOS command line:
  24.  
  25.     C:\>cmapper
  26.  
  27.   You will then see the graphics screen that you work on.
  28.  
  29.  
  30.  Quitting
  31.  --------
  32.   To quit the program either press ESC or the right mouse button.
  33.  
  34.  Display
  35.  -------
  36.   You will see the colormap display as a thick band at the top of the
  37.   screen, together with another this band above it, representing the
  38.   alpha channel.
  39.   Below that are 'nodes' (4 at startup) that define the colormap.
  40.   Below that is the color editing field.
  41.   Below that is a small menu area.
  42.  
  43.  Theory of Operation
  44.  -------------------
  45.   Pointing to the colormap are arrows that originate at squares further
  46.   down ('Nodes', see above). These arrows can be pushed around to change
  47.   the position of where the color that is in the node affects the colormap.
  48.   Simply click and drag the left mouse button while near an arrow tip.
  49.  
  50.   Below the nodes is the color editing field. Here you edit a the color
  51.   of a single node by moving sliders about. You can change the RGB values
  52.   directly or use the Hue, Luminosity and Saturation slider to change
  53.   the colors. You can also change the alpha value of the node by moving
  54.   the alpha slider (obviously!).
  55.   If you want to change one of the 7 values (R,G,B,H,L,S,A) of ALL the nodes
  56.   then press SHIFT while you move the corresponding slider. All nodes will
  57.   be set to this new value.
  58.   This, for example, allows you to set all nodes the same luminance (actual
  59.   color).
  60.  
  61.   The square next to the slider is just for display and shows the color
  62.   currently in the editor.
  63.  
  64.  Menu
  65.  ----
  66.   ■ Nodes++
  67.     You can increase the number of nodes up to a maximum of 12 (this is
  68.     arbitrary, if anyone needs more than 12 they should contact me). I
  69.     think 12 is enough (actually I've never used more than 7 [for marble]).
  70.   ■ Nodes--
  71.     You can decrease the number of nodes down to a minimum of 3.
  72.   ■ CopyTo
  73.     You can copy the settings of one node to another node. The cursor \
  74.     changes to a 'TO' cursor and you must click on a node to which you
  75.     wish to copy the settings.
  76.   ■ CopyFrom
  77.     Similar to Copy To.
  78.   ■ Save F2
  79.     This saves the current setup on disk, so that you can read it in
  80.     later. The format is somewhat less complicated than the PoV source,
  81.     but still a text file. (If you want to convert existing PoV color maps
  82.     examine the format and convert the file, it's really simple! Basically
  83.     all you need to do is leave out the keywords!).
  84.   ■ Load F3
  85.     This loads a previously saved setup on disk, so that you can resume
  86.     editing your last map. This only read files that are formatted as by
  87.     Save (I was too lazy to incorporate a parser!).
  88.   ■ Print F8
  89.     This prints the current color map to PoV format.
  90.   ■ Quit F10
  91.     100 points if you can figure this one out!
  92.  
  93.  
  94.   Thats it! Any further suggestions, enhancements or comments are welcome.
  95.  
  96.   Have fun!
  97.  
  98. ----------------------------------------------------------------------
  99.  
  100. Official Stuff:
  101.  
  102.  
  103. This software is hereby released to the public domain and is, in this
  104. version, free of charge.
  105.  
  106.  
  107. Disclaimer:
  108. -----------
  109. I will not be held responsible for anything this program does or causes
  110. to anything or anybody, under any circumstances (so there!).
  111. However, if you find a bug I'd be grateful if you could let me know.
  112.  
  113.  
  114. Credits:
  115. --------
  116. Thanks to Jordan Hargrave [72510,1143] for writing the BGI SVGA Driver
  117. and thus making it really simple to use the SVGA cards in the 256-color
  118. modes.
  119.  
  120. The RGB to HLS and vice versa conversion code is from
  121. "Fundamentals of three-dimensional computer graphics" by Alan Watt.
  122.  
  123. The layout of this program as well as the functionality was inspired
  124. by a small section of a professional RayTracer for Silicon Graphics
  125. hardware by the name of SoftImage, which I saw at an exhibition a few
  126. weeks ago (now if I had that horsepower and that software ..... sigh!)
  127.  
  128.  
  129. Support:
  130. --------
  131.  
  132. I can be reached in the following ways :
  133.  
  134.   CIS  : 100023,2006   (preferred.)
  135.  
  136.   BIX  : lkretzschmar
  137.  
  138.   Fax  : +49 89 8204270
  139.  
  140.   Tel  : +49 89 8204250
  141.  
  142.   Mail : SoftTronics
  143.          Fritz-Reuter-Str. 20B
  144.          D-8000 Munich 60
  145.          Germany
  146.  
  147. Technical Stuff:
  148. ----------------
  149.   CMAPPER was written in Turbo Pascal V6.0 and uses the object-oriented
  150.   extension a little. All source code is self-written.
  151.  
  152.