home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / raytrace / dkb / dkbutdoc.zoo / tce.doc < prev    next >
Encoding:
Text File  |  1991-06-09  |  7.0 KB  |  167 lines
  1.  
  2.  
  3.     TCE: The Color Editor
  4.     Version 1.01
  5.     April 12, '91
  6.  
  7.     Another BirdWare product by Dan Farmer ("Its as free as a bird!")
  8.     Well, actually, you *could* send me some money to get a math chip!
  9.     It would still be cheep! (ugh! boo!)
  10.  
  11.     Copyright Dan Farmer, 1991.  All rights reserved.
  12.  
  13.     BirdWare Software
  14.     1001 E. 80th St. Apt#102
  15.     Bloomington MN 55425
  16.     (612) 854-6209
  17.  
  18.     All the usual legal disclaimers pertaining to everything under the sun
  19.     regarding the use of this software are true with this program, also.
  20.     The author is not responsible for anything whatsoever, whenever.  This
  21.     program is freely distributable,  however, if you make any changes to
  22.     the source code, please DOCUMENT the hell out of it if you upload it
  23.     anywhere.  This program may NOT be sold for any amount.
  24.  
  25.  
  26.     The Color Editor is a tool for use by DKBTrace users to preview and
  27.     design colors for inclusion in their data files. (It also gave me an
  28.     opportunity to play around a bit during working hours while IBM was
  29.     busy trying (unsucessfully) to recover our LAN server drives!)
  30.     As you will see, I got a bit carried away with GUI interfaces during
  31.     this project.  No, this is NOT an Amiga port.
  32.  
  33.  
  34.     Environment / Commandline options:
  35.     ----------------------------------
  36.         TCE looks for your COLORS.DAT file in the current working directory
  37.         unless you tell it to look elsewhere.
  38.         There are two ways in which you can do this:
  39.  
  40.         1) You can set an evironment variable DKB to the path to COLORS.DAT
  41.                 SET DKB=C:\DKB\DATA\COLORS.DAT
  42.  
  43.                                     - or -
  44.  
  45.         2) You can tell TCE on the commandline:
  46.                 TCE c:\dkb\data\color.dat
  47.                         - or -
  48.                 TCE mycolors.dat
  49.  
  50.  
  51.     How it works:
  52.     -------------
  53.         1) Upon startup, the program will pause for a few seconds while it
  54.            generates a gray palette and paints the preview image.
  55.  
  56.         2) If you didn't specify a color data file, and TCE can't find one
  57.            in the current directory, it will ask you for the path and name
  58.            of your color file.
  59.  
  60.         3) Viewing COLORS.DAT:
  61.             Once the color file has been loaded, TCE will display the first
  62.             color in your file.  You can scroll through the file with your
  63.             up/down arrow keys.  Press "P" or "V" to project the color onto
  64.             the preview image.
  65.  
  66.         4) Keys:
  67.  
  68.             R G or B (Upper Case)    Increase Red, Green, or Blue.
  69.             r g or b (Lower Case)    Decrease Red, Green, or Blue.
  70.             D or d                   Darken the current color.
  71.             L or l                   Lighten the current color.
  72.             C or c                   Clear all values to white,gray,or black.
  73.             V,v,P,p                  PreView color on a shaded sphere.
  74.             S,s,W or w               Save/Write the color to COLORS.DAT
  75.             +                        Toggle Fast/Slow step rate.
  76.             ESC                      Quit the program.
  77.             F                        Specify Input/Output filenames.
  78.  
  79.     Editing/Creating Colors:
  80.     ------------------------
  81.     Existing COLORS.DAT color declarations will NEVER be over-written by TCE.
  82.     You can, however, scroll to a color in the file and then modify it,
  83.     and save it with a new name (or the same name, for that matter.  See
  84.     section below about saving colors).
  85.  
  86.  
  87.     Fine / Course Tuning:
  88.     -----------------------
  89.     On startup, changes are stepped by +/- 0.01, so you can make very fine
  90.     changes in hue or saturation, but at the same time, it may seem sometimes
  91.     like nothing is happening. Pressing the + key will toggle to a fast mode
  92.     where changes are stepped +/- 0.1.  A panel in the lower right displays
  93.     either "Fast" or "Slow" to show which mode you are currently using.
  94.  
  95.  
  96.     Saving a color (S,s,W, or w keys)
  97.     -----------------------
  98.     Pressing the "S" or "W"  key puts you into save mode.  You will be prompted
  99.     for a descriptive name for the new color.  Pressing <ENTER> without
  100.     entering a name will abort the save operation and you will be returned
  101.     to the color editor.
  102.  
  103.     Color names are NOT checked for duplicity, but at the same time,
  104.     colors are never over-written.  If you do have duplicate color names,
  105.     I believe DKB will use the last declared definition.  There is no delete
  106.     function, so you will have to use a text editor to remove unwanted
  107.     color declarations.  There is a limit to the number of DECLARATIONS that
  108.     DKB can use, so you may wish to store new colors to a separate COLORS.DAT
  109.     file until you want to use them.
  110.  
  111.     Spherical Preview  (V,v,P or p keys)
  112.     -----------------
  113.     This is, admittedly, a hack.  It's sorta slow generating the palette,
  114.     and the way I draw the sphere leaves a bit to be desired, and it is
  115.     only an approximation of the way the color will look on a rendered
  116.     object, but it got the product out of the door and into your hands.
  117.     (Besides, it's really kinda neat!).
  118.  
  119.  
  120.     That's about it. Pretty easy, huh?  But I think you'll find it helpful
  121.     when you're looking for that illusive color for bread dough!
  122.  
  123.  
  124.     What's new:
  125.  
  126.     Version 1.01
  127.  
  128.         Doesn't really DO anything new, just what it does, it does better.
  129.  
  130.         Better palette scaling for the preview window.  Nicer preview
  131.         image, too, with a sky and a shaded background.  Also, the
  132.         preview image now is drawn only once, at load time.
  133.  
  134.         This gives two benefits:
  135.  
  136.         1) You only have to wait once for it to draw.
  137.         2) Since the palette is not updated in the image until you
  138.            press "Preview", you can compare a previously previewed color
  139.            against one in the window.
  140.  
  141.         Now if only I can come up with a quicker palette loader!
  142.         (I'm looking into it)
  143.  
  144.         The original release allowed you to specify a PATH to your
  145.         color file, either on the command line or with a DOS environment
  146.         variable "DKB".  Both methods still work, but must have the
  147.         filename, too.  This is because DKB Version 2.10 looks for
  148.         a file named COLORS.DAT, where earlier versions looked only
  149.         for COLOR.DAT (singular).
  150.  
  151.         But wait... it gets better!
  152.         You can now specify from within the program the name of your
  153.         input file and optionally a name for a separate output file.
  154.         What used to be the Help button (who needs help when you have
  155.         a document file, right?) is now the "Files" button.  Press "F"
  156.         and you will be asked if you wish to specify an Input file or
  157.         an Output file.  Pressing <Enter> will abort the process.
  158.  
  159.     CREDITS: DKB is a superb (by far the best for PC's) ray tracing
  160.              program written by David K. Buck with Aaron Collins.
  161.              DKB is freeware, not shareware or crippleware.
  162.              (Motto: "It's free, and well worth the price")
  163.  
  164.              DKB is available on CompuServe (tm) (GO COMART) and
  165.              the "You Can Call Me Ray" BBS in Chicago (708) 358-5611.
  166.  
  167.