home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_disks / 300-399 / ff397.lzh / DKBTrace / read.me < prev    next >
Text File  |  1990-10-30  |  4KB  |  104 lines
  1.  
  2.                                 DKBTrace
  3.  
  4.  
  5.  
  6.  
  7.    This ray tracer was written by David K. Buck and is released as freely
  8.    distributable software.  The author retains all copyrights but permits
  9.    free distribution of the software through any medium.  The software may
  10.    be used without charge so long as the code is not included in any 
  11.    commercial product.
  12.  
  13.  
  14.    The Amiga archive here contains two versions of the raytracer:
  15.  
  16.        traceffp   - Fast Floating Point version of the raytracer.
  17.                     This version will run on any Amiga with sufficient
  18.                     memory.
  19.  
  20.        trace881   - Math coprocessor version.  This version will only
  21.                     run on 68020 or 68030 based systems that have a
  22.                     68881 or 68882 math coprocessor.
  23.  
  24.  
  25.    I usually like having a fairly large stack for this program.  If it
  26.    crashes on you, try inceasing the stack size.
  27.  
  28.  
  29.    In addition, the following utilities are provided (these will run on any
  30.    AMIGA system).
  31.  
  32.        DumpToIFF  - Converts the raw 24 bit output files of the raytracer into
  33.                     hires HAM images.
  34.  
  35.                syntax:
  36.                 DumpToIFF  [options] input-file [output-file [palette-file]] 
  37.  
  38.                options are:
  39.                     -d            Suppress Floyd Steinberg dithering
  40.                     -pfilename    Output a colour palette for the picture
  41.  
  42.               The colour palette for one image may be used in other images.
  43.               This is useful for animations in order to force the entire
  44.               animation to use the same colour palette.
  45.  
  46.                  eg.
  47.                    DumpToIFF  -pmyImage.palette myImage.dis  myImage.ham
  48.                    DumpToIFF  myImage2.dis  myImage2.ham  myImage.palette
  49.  
  50.  
  51.        Dump2RGB   - Converts the raw 24 bit output files of the raytracer into
  52.                     three separate dump files for red, green and blue.
  53.  
  54.                syntax:
  55.                 Dump2RGB [options] input-file
  56.  
  57.                options are:
  58.                     -wxxx         Output image width
  59.                     -hxxx         Output image height
  60.  
  61.        Dump2Raw    - Same as Dump2RGB but takes the size from the input file
  62.                      and takes less memory.
  63.  
  64.        Sculpt2DKB  - Converts a Sculpt-Animate 3D .scene file into DKB format.
  65.               At the current time, smoothed triangles are not supported.  The
  66.               only information converted is the information on the polygons,
  67.               the colours, and the textures.  Lightsources, viewpoints, and
  68.               world information is currently ignored.
  69.  
  70.                 syntax:
  71.                    Sculpt2DKB  scene-file  dkb-dat-file
  72.  
  73.               You must edit this file after the conversion to add a viewpoint
  74.               and lightsources as needed.
  75.  
  76.  
  77.    The program documentation can be found in the file DKB.DOC and the
  78.    documentation for some Amiga specific utilities may be found in
  79.    AmigaUtils.doc.
  80.  
  81.    This program is being distributed in four separate packages:
  82.  
  83.  
  84.       DKBTrace.lzh:  Executables for traceffp and trace881
  85.                      documentation files
  86.                      DumpToIFF and Sculpt2DKB executables
  87.  
  88.       DKBData.lzh    Many sample data files
  89.  
  90.       DKBSource.lzh  Source code for DKBTrace, Amiga utilities, and
  91.                      IBM Utilities.
  92.  
  93.  
  94.       DKBPics.lzh    Sample pictures produced by the raytracer.
  95.                      (you could render these yourself using the
  96.                       data files in the DKBTrace.lzh archive)
  97.  
  98.  
  99.    There is a document in the DKBTrace.lzh archive which describes the
  100.    conversions required to use data files for DKBTrace version 1.2 with
  101.    the new 2.0 version.  This file is called 12to20.doc
  102.  
  103.    This readme file is in all three archives.
  104.