home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / GRAPHICS / MISC / DKBTRACE.ZIP / READ.ME < prev    next >
Encoding:
Text File  |  1990-08-09  |  8.0 KB  |  182 lines
  1.  
  2.                                 DKBTrace 2.04
  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 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.    The IBM/MS-DOS archive also contains two versions of the raytracer:
  30.  
  31.      dkbno87.exe  - Emulated Floating Point version of the raytracer.
  32.                  This version will run on any IBM P.C. or Compatible
  33.             machine, as it is compiled for 8088 opcodes.
  34.  
  35.      dkb.exe      - Math coprocessor and 80186 or better ('286, '386, etc.)
  36.                  optimized version of the raytracer.  Requires a 80x87 NPE.
  37.  
  38.    These files were compiled using Microsoft C 6.0 with maximum optimization,
  39.    so it should be a LOT faster than previous versions.  There are MAKEFILE's
  40.    and link files (.lnk) provided for both MSC and for Turbo-C 2.0, for
  41.    compatibility with prior versions.  Note, however, that Microsoft C's
  42.    execution time is fully 20% faster than Turbo-C's!
  43.  
  44.    This version has been fed through four different compilers at their
  45.    maximum warning levels, and then through a VERY picky "LINT", so it should
  46.    be edible by very nearly all decent "C" compilers.  Also, all memory
  47.    allocation functions are checked carefully for memory size limitations.
  48.  
  49.    The stack size in this version is set to about 12K which should be enough
  50.    to do tracing of scenes with about 550K free RAM.  If it dies while it's
  51.    tracing (it hasn't for me, yet, but that should be about the only reason
  52.    it ever would, now...) chances are you may need to increase the stack size
  53.    a bit.  I have the internal stack checking option off for additional speed
  54.    when tracing.  Currently the stack size is set at 3000H, but more can be
  55.    easily allocated with the Microsoft EXEMOD or EXEHDR utilities, or even
  56.    with DEBUG, if you're a real die-hard hacker.  I would suggest trying 3800
  57.    or 4000H, but not too much more.  The more stack you have will mean less
  58.    memory will be available for complex objects.
  59.  
  60.    If you run into a scene which is too complex to parse with 640K of memory
  61.    (as evidenced by an allocation error message during the "Parsing" phase),
  62.    QuarterDeck's QRAM or VIDRAM are programs which will extend DOS memory to
  63.    704K/740K using either EMM or Video RAM memory, respectively.  There are
  64.    also Public Domain programs (such as 740K.COM/SYS (?)) that will accomplish
  65.    the same thing.  MAKE SURE you use the -d (no display) option if you use
  66.    one of these programs or upper memory corruption could occur!!
  67.  
  68.    The raytracer will use up to ALL available DOS linear memory, but no EMM
  69.    or XMS support is present at this time.
  70.  
  71.    In addition, the following utilities are provided (these will run on any
  72.    Amiga system).
  73.  
  74.        DumpToIFF  - Converts the raw 24 bit output files of the raytracer into
  75.                     hires HAM images.
  76.  
  77.                syntax:
  78.                 DumpToIFF  [options] input-file [output-file [palette-file]] 
  79.  
  80.                options are:
  81.                     -d            Suppress Floyd Steinberg dithering
  82.                     -pfilename    Output a colour palette for the picture
  83.  
  84.               The colour palette for one image may be used in other images.
  85.               This is useful for animations in order to force the entire
  86.               animation to use the same colour palette.
  87.  
  88.                  eg.
  89.                    DumpToIFF  -pmyImage.palette myImage.dis  myImage.ham
  90.                    DumpToIFF  myImage2.dis  myImage2.ham  myImage.palette
  91.  
  92.  
  93.        Dump2RGB   - Converts the raw 24 bit output files of the raytracer into
  94.                     three separate dump files for red, green and blue.  Note
  95.             that the extension .DIS is assumed for input files, so
  96.             "input-file" should not specify any file name extension.
  97.             The extensions .red, .grn, and .blu will be automatically
  98.             supplied for the color-separated output files.
  99.  
  100.                syntax:
  101.                 Dump2RGB [options] input-file
  102.  
  103.                options are:
  104.                     -wxxx         Output image width
  105.                     -hxxx         Output image height
  106.  
  107.        Dump2Raw    - Same as Dump2RGB but takes the size from the input file
  108.                      and uses less memory.  This takes no size options.
  109.  
  110.                syntax:
  111.                 Dump2Raw input-file (no extension, .DIS assumed for input)
  112.  
  113.        Sculpt2DKB  - Converts a Sculpt-Animate 3D .scene file into DKB format.
  114.               At the current time, smoothed triangles are not supported.  The
  115.               only information converted is the information on the polygons,
  116.               the colours, and the textures.  Lightsources, viewpoints, and
  117.               world information is currently ignored.
  118.  
  119.                 syntax:
  120.                    Sculpt2DKB  scene-file  dkb-dat-file
  121.  
  122.               You must edit this file after the conversion to add a viewpoint
  123.               and lightsources as needed.
  124.  
  125.    The IBM / Compatible version has all the above but DumpToIFF, plus the
  126.    following two utilities:
  127.  
  128.  
  129.        GlueTGA    - Glues several .TGA (TARGA-24) files together into one.
  130.                    Uses the Y-offset in the header to insert the pieces
  131.              into their respective positions in the final image.
  132.              Takes the image size from the first supplied input file's
  133.              header.  This is for putting together several pars of
  134.              an interrupted trace.  The .TGA extension is assumed, and
  135.              will be added to file names if not otherwise specified.
  136.  
  137.          syntax:
  138.           GlueTGA output-file input-file [input-file]...
  139.  
  140.        HalfTGA    - Shrinks a .TGA (TARGA-24) file to half it's X and Y size.
  141.                    For reducing size of output images on lower resolution
  142.              systems.  Does not interpolate colour values, just drops
  143.              odd pixels.  Extension of .TGA is also assumed and added
  144.              if not specified for files.
  145.  
  146.          syntax:
  147.           HalfTGA input-file output-file
  148.  
  149.    Also, a notable difference from the Amiga to the IBM is that the DUMP2RAW
  150.    utility writes .red, .grn and .blu file extensions on the Amiga, but uses
  151.    .r8, .g8, and .b8 respectively on the IBM.  This is to be compatibile with
  152.    the PICLAB post-processor's "RAW" format
  153.  
  154.  
  155.    The main program documentation can be found in the file DKB.DOC and the
  156.    documentation for the Amiga specific utilities may be found in the
  157.    file AmigaUtils.doc.  The IBM utilities are simple enough that the usage
  158.    messages should be practically self-explanatory.
  159.  
  160.    This program is being distributed in four separate packages:
  161.  
  162.  
  163.       DKBTrace.zip:  Executables for dkb.exe and dkbno87.exe
  164.                      documentation files
  165.                      Sculpt2DKB, Dump2RAW, GlueTGA, HalfTGA executables
  166.  
  167.       DKBData.zip:   Many sample data files
  168.  
  169.       DKBSrc.zip:    Source code for DKBTrace, Amiga utilities, and
  170.                      IBM Utilities.
  171.  
  172.       DKBPics.zip:   Sample pictures produced by the raytracer.
  173.                      (You could render these yourself using the
  174.                      data files in the DKBData.zip archive).
  175.  
  176.  
  177.    There is a document in the DKBTrace.zip archive which describes the
  178.    conversions required to use data files for DKBTrace version 1.2 with
  179.    the new 2.04 version.  This file is called 12to20.doc.
  180.  
  181.    This readme file is in all three archives.
  182.