home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / raytrace / dkb / dkbutdoc.zoo / read.me < prev    next >
Encoding:
Text File  |  1991-06-09  |  5.7 KB  |  124 lines
  1.  
  2.                                 DKBTrace 2.12
  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 executable archive contains two versions of the raytracer:
  15.  
  16.        dkbieee    - Non co-processor version of the raytracer.
  17.                     This version will run on any Amiga with sufficient
  18.                     memory.  If a 68881 chip is present, it will be used
  19.                     although it will be slower than trace881.  You must
  20.                     have mathieeedoubbas.library in your :lib directory.
  21.                     
  22.  
  23.        dkb881     - Math coprocessor version.  This version will only
  24.                     run on 68020 or 68030 based systems that have a
  25.                     68881 or 68882 math coprocessor.
  26.  
  27.  
  28.    I usually like having a fairly large stack for this program.  If it
  29.    crashes on you, try inceasing the stack size.
  30.  
  31.  
  32.    The IBM/MS-DOS executable archive also contains two versions:
  33.  
  34.      dkbno87.exe  - Emulated Floating Point version of the raytracer.
  35.                     This version will run on any IBM P.C. or Compatible
  36.                     machine, as it is compiled for 8088 opcodes.
  37.  
  38.      dkb.exe      - Math coprocessor and 80186 or better ('286, '386, etc.)
  39.                     optimized version of the raytracer.  Requires a 80x87 NPE.
  40.  
  41.    These files were compiled using Microsoft C 6.00A with maximum optimization
  42.    options, where possible.  There are makefile's (.mak) and link files (.lnk)
  43.    provided for both MSC 6.00A and for Turbo-C 2.0, for compatibility with
  44.    prior versions.  Note, however, that the Turbo-C version is no longer
  45.    formally supported, and the make and link files are include for historical
  46.    reasons only (it may take some work to make DKB compatible with Turbo-C
  47.    now, as I no longer use it).
  48.  
  49.    This version has been fed through four different compilers at their
  50.    maximum warning levels, and then through a VERY picky "LINT", so it should
  51.    be edible by very nearly all decent "C" compilers.  Also, all memory
  52.    allocation functions are checked carefully for memory size limitations.
  53.  
  54.    The stack size in this version is set to about 12K which should be enough
  55.    to do tracing of scenes with about 550K free RAM.  If it dies while it's
  56.    tracing chances are you may need to increase the stack size a bit.  I have
  57.    the internal stack checking option off for additional speed when tracing.
  58.    Currently the stack size is set at 3000H, but more can be easily allocated
  59.    with the Microsoft EXEMOD or EXEHDR utilities.  I would suggest trying 3800
  60.    or 4000H, but not too much more.  The more stack you have will mean less
  61.    memory will be available for complex scenes.
  62.  
  63.    If you run into a scene which is too complex to parse with 640K of memory
  64.    (as evidenced by an allocation error message during the "Parsing" phase),
  65.    QuarterDeck's QRAM or VIDRAM are programs which will extend DOS memory to
  66.    704K/740K using either EMM or Video RAM memory, respectively.  There are
  67.    also Public Domain programs (such as 740K.COM/SYS (?)) that will accomplish
  68.    the same thing.  MAKE SURE you use the -d (no display) option if you use
  69.    one of these programs or upper memory corruption could occur!!
  70.  
  71.    The raytracer will use up to ALL available DOS linear memory, but no EMM
  72.    or XMS support is present at this time.
  73.  
  74.    DKBTrace was formerly distributed with a plethora of utilities, some for
  75.    data file generation, some for image translation.  There are simply so
  76.    many of them now, we have decided to release a separate archive containing
  77.    all of them, updated to the new DKB 2.12 standards.  Many of these are
  78.    still being converted to conform with the new standards, so they will
  79.    be released following the actual release of DKB 2.12.
  80.  
  81.    This program is being distributed in the following packages:
  82.  
  83.       DKB212AM.xxx:   Amiga executables dkb881 and dkbieee.
  84.  
  85.       DKB212IB.xxx:   IBM PC/MS-DOS executables dkb.exe and dkbno87.exe.
  86.  
  87.       DKB212DT.xxx:   Many new, and some older updated sample data files, with
  88.                       required imagemap texturing GIF and IFF files for the
  89.                       provided sample scenes.  Also, .def files for running
  90.               the raytracer, and the three standard include files
  91.               colors.dat, shapes.dat, and textures.dat.
  92.  
  93.       DKB212SR.xxx:   Source code for DKBTrace 2.12, include files, linkage
  94.                       files, and makefiles for Amiga, MS-DOS, Mac and Unix.
  95.  
  96.       DKB212DC.xxx:   Documentation files for DKB 2.12, and for data file
  97.                       conversion up to version 2.12.  Also contains the
  98.               whats.new file for changes from version 2.0 up to 2.12.
  99.  
  100.  
  101.       DKBUTAMI.xxx:   Amiga executable utilities for DKBTrace.
  102.  
  103.       DKBUTIBM.xxx:   IBM executable utilities for DKBTrace.
  104.  
  105.       DKBUTSRC.xxx:   Source code for utilities for DKBTrace.
  106.  
  107.       DKBUTDOC.xxx:   Documentation for DKBTrace utilities.
  108.  
  109.  
  110.    The xxx extensions are one of:
  111.         zip   - ZIP file format for IBM's (text files include CR-LF)
  112.         lzh   - LHArc format for Amiga (text files contain only LF)
  113.         tar.Z - compressed tar format for UNIX (text files contain only LF)
  114.  
  115.    There is a document in the DKB21Doc.xxx archive which describes the
  116.    conversions required to use data files for DKBTrace version 1.2 with
  117.    the older 2.0 - 2.05 version.  This file is called 12to20.doc.  There is
  118.    now another file describing the required data file conversions from version
  119.    2.0 through 2.05 up to the new DKB 2.12 standard.  This file is called
  120.    25to210.doc.
  121.  
  122.    This readme file is in all DKB 2.12 archives.
  123.  
  124.