home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / raytrace / dbw_render / Docs / General < prev    next >
Encoding:
Text File  |  1992-10-27  |  3.0 KB  |  68 lines
  1. ***************************************************************************
  2. *                                                                         *
  3. *                                   DBW_Render                            *
  4. *                              RISC OS version 2.00                       *
  5. *                                                                         *
  6. *                                  General Guide                          *
  7. *                               © Neil Coffey 1992                        *
  8. *                                                                         *
  9. ***************************************************************************
  10.  
  11.  
  12.   Contents:
  13.  
  14.      !ArcFS                      - Read only version of archive filing
  15.                                    system for reading compressed example
  16.                                    files
  17.      !DBWRender                  - The ray tracer itself
  18.      Docs                        - Ray tracer documentation
  19.      Examples                    - An archive containing four example
  20.                                    pictures complete with the script files
  21.                                    used to create them
  22.      Library                     - Contains the utilities DBWLink, DBWPCX
  23.                                    and DBWSprite
  24.      SourceCode                  - The source code to the original
  25.                                    DBW_Render
  26.  
  27.   The RISC OS version of DBW_Render is a multi-tasking application. Once
  28.   it is installed, ray tracing is started by dragging a directory contain-
  29.   ing a command script file on to the window, and clicking on 'Ray Trace'.
  30.  
  31.   The script is a list of commands telling the ray tracer where to place
  32.   the objects in the scene. A separate documentation file, 'Script',
  33.   details the various commands. The script file is created in !Edit and
  34.   should be saved with the name 'DAT' inside the directory (see examples).
  35.  
  36.   During ray tracing, the program produces another file, TMP, inside the
  37.   directory. This is a file containing the raw picture information, and is
  38.   in the format:
  39.  
  40.       2 bytes:   X resolution
  41.       2 bytes:   Y resolution
  42.  
  43.   and then:
  44.  
  45.       2 bytes:   scan line number
  46.     160 bytes:   320 4-bit red intensities
  47.     160 bytes:   320 4-bit green intensities
  48.     160 bytes:   320 4-bit blue intensities
  49.  
  50.   The utility DBWSprite is then used to convert a TMP file into a sprite
  51.   file. A full image consists of 200 lines of 320 pixels. DBWSprite uses
  52.   this to create a dithered mode 15 sprite.
  53.  
  54.   The scan line region to be traced is set up in the main window before
  55.   tracing. The whole screen is scan lines 0-200; the first half would be
  56.   0-100; the second quarter would be 50-100.
  57.  
  58.   The program DBWLink can be used to join such files together to create one
  59.   whole image. This allows you to share the computation across two or more
  60.   machines.
  61.  
  62.   The program DBWPCX converts DBW_Render files into PCX files which can then
  63.   be exported to PCs.
  64.  
  65.  
  66.   Neil Coffey
  67.   August 1992
  68.