home *** CD-ROM | disk | FTP | other *** search
/ Fish 'n' More 1 / FishNMoreVol1.bin / more / graphics / applications / qrtv1.5 / docs / intro.doc < prev    next >
Text File  |  1989-03-18  |  8KB  |  265 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.         
  8.                              Introduction to the QRT
  9.                                    Ray Tracer
  10.         
  11.         
  12.         QRT is a ray tracing  image  rendering  system  that runs under a
  13.         variety  of  operating  systems.   It  has  a  free  format input
  14.         language   with   extensive   error   detection   and   reporting
  15.         capabilities.
  16.         
  17.         This manual is divided into several sections as follows:
  18.         
  19.            QRT Language Reference:
  20.            
  21.                This is  a  quick  reference  guide  to  the  QRT  command
  22.                language.  It can suffice as a tutorial for those familiar
  23.                with ray tracing programs,  or  function as a guide to QRT
  24.                features not described in the User Manual.
  25.                
  26.            QRT User Manual:
  27.            
  28.                The User Manual is a  more  complete  tutorial  to the QRT
  29.                system.  It describes the  basic  commands and features of
  30.                QRT, without listing every possible command or option.  It
  31.                would be a good starting  place  for  beginners.  QRT bugs
  32.                and desired  enhancements  are  listed  at the end of this
  33.                section.
  34.                
  35.            QRT Technical Reference:
  36.            
  37.                This is a  programmer's  guide  to  the  QRT software.  It
  38.                describes  the  structures  used  by  QRT  and  the design
  39.                philosophy used in creating the system.  It should be read
  40.                by anyone attempting to understand or modify the code.
  41.                
  42.            QRT Error Codes
  43.            
  44.                The error code  section  explains  QRT  error  messages in
  45.                detail,  and   lists   solutions   or   suggestions  where
  46.                appropriate.
  47.                
  48.            Context Free Grammar
  49.            
  50.                This is a BNF style context  free  grammar  description of
  51.                the  QRT  input  language.   It  may  be  used  as a quick
  52.                reference for people familiar with compiler terminology.
  53.                
  54.            QRT Sample Programs
  55.            
  56.                These are actual QRT input files;  they show suggested QRT
  57.                indenting style and give examples of various features.
  58.  
  59.  
  60.         QRT Ray Tracer               Page 1                  Introduction
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                
  74.            Machine Specifics
  75.            
  76.                The QRT post processor is machine dependent.  This section
  77.                contains instructions on using  it, as well as information
  78.                on other machine dependent features.
  79.                
  80.         
  81.         
  82.         
  83.         
  84.         
  85.         References
  86.            
  87.            
  88.            
  89.            Howard Anton, Elementary Linear Algebra, Anton Textbooks,
  90.               Inc.,   1987
  91.            
  92.            
  93.            David F. Rogers, Procedural Elements for Computer Graphics,
  94.               McGraw Hill, Inc., 1985
  95.            
  96.            
  97.            Eric Graham, Graphic Scene Simulations, Amiga World,  CW
  98.               Communications/Peterborough, Inc., May/June 1987
  99.            
  100.            
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.         QRT Ray Tracer               Page 2                  Introduction
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.                                  Table of Contents
  140.            
  141.                                                                Page
  142.            
  143.                 I. QRT Language Reference Manual
  144.            
  145.                    A. Introduction  ..........................   1
  146.                    B. Setup Commands .........................   3
  147.            
  148.                       1. Sky .................................   3
  149.                       2. Ground ..............................   4
  150.                       3. Focal Length ........................   5
  151.                       4. First Scan ..........................   5
  152.                       5. Last Scan ...........................   5
  153.                       6. File Name ...........................   6
  154.                       7. Observer ............................   6
  155.                       8. Lamp ................................   7
  156.            
  157.                    C. Primitive Types ........................   8
  158.            
  159.                       1. Sphere ..............................   8
  160.                       2. Parallelogram .......................   9
  161.                       3. Triangle ............................  10
  162.                       4. Ring ................................  11
  163.                       5. Quadratic ...........................  12
  164.            
  165.                    D. Patterned Surfaces .....................  14
  166.            
  167.                       1. Pattern .............................  14
  168.                       2. Rectangle ...........................  16
  169.                       3. Circle ..............................  17
  170.                       4. Polygon .............................  18
  171.            
  172.                    E. Bounding Boxes .........................  19
  173.            
  174.                       1. Begin Bbox ..........................  19
  175.                       2. End Bbox ............................  19
  176.            
  177.                    F. Instances ..............................  20
  178.            
  179.                       1. Begin Instances .....................  20
  180.                       2. End Instances .......................  21
  181.                       3. Instance Of .........................  22
  182.            
  183.                    G. Setting Defaults .......................  23
  184.            
  185.                       1. Default .............................  23
  186.                
  187.  
  188.  
  189.  
  190.  
  191.  
  192.         QRT Ray Tracer               Page 3                  Introduction
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.            
  206.                              Table of Contents - Cont.
  207.            
  208.                                                                Page
  209.            
  210.                 II. QRT Users Manual
  211.            
  212.                    A. Introduction  ..........................   1
  213.                    B. Comparison to Other Systems ............   1
  214.                    C. The World ..............................   3
  215.                    D. Input Language .........................   4
  216.                    E. Illumination Model .....................   6
  217.                    F. Light Sources ..........................   9
  218.                    G. Observer ...............................  10
  219.                    H. Filenames ..............................  11
  220.                    I. Focal Length ...........................  11
  221.                    J. Sky and Ground .........................  12
  222.                    K. Bounding Boxes .........................  13
  223.                    L. Patterns ...............................  15
  224.                    M. Instances ..............................  17
  225.                    N. Defaults ...............................  19
  226.                    O. Problems, Bugs .........................  20
  227.                    P. Possible Enhancements ..................  21
  228.            
  229.            
  230.                 III. QRT Technical Reference Manual
  231.            
  232.                    A. Introduction ...........................   1
  233.                    B. C Source file list .....................   1
  234.                    C. Data Structures ........................   2
  235.                    D. Code Description .......................   4
  236.            
  237.            
  238.                 IV. QRT Error Codes
  239.            
  240.            
  241.                 V.  Context Free Grammar
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.         QRT Ray Tracer               Page 4                  Introduction
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.