home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / raytrace / ray3d / Docs / !Ray3d-Pro next >
Encoding:
Text File  |  1995-07-24  |  62.7 KB  |  1,785 lines

  1.           
  2.  
  3.    Ray3d-Pro supports context sensitive help when this help reader
  4.    application is loaded. To receive help on a specific option or
  5.    tool in !Ray3d-Pro, hold down CONTROL and click on the option with
  6.    the mouse. If there is no help available you will hear a beep.
  7.    
  8.  
  9.    How to register
  10.  
  11.    Why should I register?
  12.  
  13.    The Public Domain release of Ray3d-Pro has been limited in the number
  14.    of objects that may be used to create a scene. This number depends on
  15.    what objects you use, but it is around the 20 mark.
  16.  
  17.    Registration will remove this limit, allowing Ray3d-Pro to be used to
  18.    it's full potential - scenes with over 7000 objects have been created
  19.    and raytraced (this depends on the amount of memory in your system).
  20.  
  21.    Many of the options in the PD release are unavailable because of this
  22.    restriction, such as scaling spheres, cylinders and cones, creating
  23.    fractal shapes, complex CSG shapes, etc. All of these functions are
  24.    fully operational in the full release.
  25.  
  26.    There are also some support applications that accompany the full
  27.    release which allow you to import scenes from other applications in
  28.    different file formats. Also included is a utility which will take
  29.    a !Draw file and import it into Ray3d-Pro - thus allowing you to use
  30.    text in your images.
  31.  
  32.    How do I register?
  33.  
  34.    To register and receive the full version of Ray3d-Pro, send a cheque
  35.    (or eurocheque) for 10 UK pounds made payable to "Robert Taylor" to
  36.    the address below. If you live outside Europe, then contact me at
  37.    this address and I will discuss other means of payment.
  38.  
  39.    Send the cheque to:   Robert Taylor
  40.                          Wyvern Software
  41.                          5 Mayfield Grove
  42.                          Skegness
  43.                          Lincolnshire
  44.                          UNITED KINGDOM
  45.                          PE25 3RY
  46.  
  47.    remembering to include a return address!
  48.  
  49.    Further versions
  50.  
  51.    Registration allows you to receive program updates for free, by
  52.    sending your registration disk to the above address and enclosing
  53.    a stamped addressed envelope.
  54.  
  55.    IF there is sufficient interest in Ray3d-Pro, I will continue to
  56.    work on it. Planned updates include image mapping, full script
  57.    language support, libraries and animation support.
  58.  
  59.  
  60.    Introduction to raytracing
  61.  
  62.    Raytracing is the technique used for generating realistic pictures
  63.    from a 3d scene. Each ray of light is traced from where it ‘hits’
  64.    the scene, back to the light source it came from. This process then
  65.    ensures that the scene generated is close to real life because it
  66.    follows the same physical laws.
  67.    
  68.    Ray3d-Pro does not actually do the raytracing, it simply defines
  69.    the scene and passes this information to the selected PD raytracer,
  70.    which then raytraces the scene.
  71.  
  72.  
  73.    Introduction to Ray3d-Pro
  74.  
  75.    This document describes !Ray3d-Pro, a cheaper  alternative to other
  76.    commercial raytracing packages, but which still has lots of features.
  77.  
  78.    !Ray3d-Pro allows the user to create a scene in 3 dimensions by using
  79.    a graphical editing system, which can then transformed into the
  80.    textual data needed to raytrace a scene by Public Domain raytracing
  81.    packages. 
  82.  
  83.    Loading and Running
  84.  
  85.    To run the application, double click on the !Ray3d-Pro icon in the
  86.    normal way.
  87.  
  88.    The Ray3d-Pro world
  89.    
  90.    Scenes generated in the Ray3d-Pro world consist of a number of objects
  91.    called primitives. These can be of a number of pre-defined shapes
  92.    such as cone, sphere, box etc. In order for an object to be seen, it
  93.    must have a surface associated with it. Surfaces specify the colour
  94.    of the object, whether it is mirror-like, transparent and other such
  95.    factors.
  96.    
  97.    Objects may also have a texture applied to them, which may be of a
  98.    number of types. There is wood, marble, bumps, checker, gloss and
  99.    blotch.
  100.    
  101.    The user also sets the position of the observer within the scene and
  102.    the direction that they are looking in. It is possible for the
  103.    observer to be placed within a transparent object, such as a goldfish
  104.    bowl, or from any distance.
  105.    
  106.    Finally, in order to be able to draw the scene, there must be light,
  107.    and Ray3d-Pro allows two different forms of lighting.
  108.  
  109.    Using the editor
  110.    
  111.    The 3d editor has been designed to be as easy to use as possible,
  112.    although some people may find the  system difficult to work
  113.    with. In this case, it is possible to switch to a single view which
  114.    is similar to that used by other packages (eg: Euclid).
  115.    
  116.    When !Ray3d-Pro has been loaded, clicking on the icon on the icon bar
  117.    brings up five windows. Three of these windows show views onto the
  118.    Ray3d-Pro world, while the fourth and fifth are a toolbox and object
  119.    list.
  120.  
  121.    All of the objects within a scene are listed within the object list
  122.    window. Groups of objects are listed at the top in red, with single
  123.    objects listed below in black. Clicking on an object with the SELECT
  124.    mouse button will select the object and deselect everything else, while
  125.    clicking with ADJUST will cause the object to be added to those already
  126.    selected.
  127.  
  128.    It is possible to move into a group by clicking on the arrow on the
  129.    right hand side of the group name. In this manner you can create and
  130.    use groups within groups within groups, etc.
  131.    
  132.    All of the most used operations can be found on the tools window.
  133.  
  134.    Bugs, Features and Cautions
  135.    
  136.    Unforeseen errors are sometimes reported as “Internal error” and
  137.    a message. If you get one of these, let me know what happened with
  138.    as much information as possible, namely:
  139.    
  140.       Machine type, OS version and memory available
  141.       Version of !Ray3d-Pro
  142.       What was being done at the time
  143.       Error message or other symptoms
  144.       Is the problem repeatable?
  145.       Is the problem confined to just one scene?
  146.  
  147.  
  148.    Tri-view
  149.    
  150.    Tri-view is the name given to the form of 3d representation that
  151.    !Ray3d-Pro uses in order to make 3d editing possible.
  152.  
  153.    !Ray3d-Pro opens three windows, each of which looks at the world from
  154.    a different direction. By using all three of these windows it is
  155.    possible to represent the 3 dimensional world.
  156.  
  157.    If you imagine a cube, then the plan view is what you see if
  158.    looking from above straight downwards. The front and side views
  159.    represent what you would see if looking from the front and side
  160.    respectively.
  161.  
  162.    When you are designing your scene, I suggest you First click in the
  163.    Front or Side view windows to set the height of the object. Then
  164.    click in the plan window to decide where the object will be placed.
  165.  
  166.  
  167.    Installation
  168.  
  169.    The !Ray3d-Pro package consists of the following directories:
  170.  
  171.         * !Ray3d-Pro
  172.         * !Help+
  173.         * !Shade4
  174.         * !RayShade
  175.         * Rayfiles    (a directory of example files)
  176.  
  177.    Hard Disc
  178.  
  179.    It is a simple matter to install !Ray3d-Pro onto a hard disc. Simply
  180.    copy all of the supplied applications into the required directory
  181.    on your hard disc in the normal RISC OS way.
  182.  
  183.    Floppy Disc
  184.  
  185.    To set !Ray3d-Pro up on a floppy based system I recommend that you split
  186.    these directories over two discs.
  187.  
  188.    The first disc, which you should use to design your scenes and save
  189.    them to will need the following directories:
  190.  
  191.         *  !Help
  192.         *  !Ray3d-Pro
  193.         *  RayFiles
  194.  
  195.    Note that !Help is included on this disc, as you might need to refer
  196.    to it while creating a scene.
  197.  
  198.    The second disc should be used when you wish to raytrace a scene, and
  199.    should contain:
  200.  
  201.                 *  !RayShade
  202.                 *  !Shade4
  203.  
  204.  
  205.    Using Ray3d-Pro
  206.  
  207.  
  208.  
  209.    The object list
  210.  
  211.    All of the objects within a scene are listed within the object list
  212.    window. Groups of objects are listed at the top in red, with single
  213.    objects listed below in black. Clicking on an object with the SELECT
  214.    mouse button will select the object and deselect everything else, while
  215.    clicking with ADJUST will cause the object to be added to those already
  216.    selected.
  217.  
  218.    Once objects and groups have been selected, many operations can be done
  219.    with them such as grouping, hiding, rotating, scaling, etc.
  220.  
  221.    It is possible to move into a group by clicking on the arrow on the
  222.    right hand side of the group name. In this manner you can create and
  223.    use groups within groups within groups, etc.
  224.  
  225.    Leaving a group                   
  226.  
  227.    Clicking on the parent icon situated below the list returns you
  228.    to the group above the one you are in now.
  229.  
  230.    Select All                        
  231.  
  232.    Clicking on the select all icon, or choosing the ‘Select all’
  233.    option from the ‘select’ sub-menu on the main program menu will
  234.    cause all the objects in the currently displayed group to become
  235.    selected (that is the objects currently displayed in the object
  236.    list).
  237.  
  238.    Clear selection                   
  239.  
  240.    Clicking on the clear selection icon in the toolbox, or choosing
  241.    the ‘Clear’ option from the select sub-menu will deselect any
  242.    objects which are currently selected.
  243.  
  244.    Grouping
  245.  
  246.    It is often desirable to group several objects together so that
  247.    they may be moved, scaled, rotated, etc. as if they were one
  248.    object.
  249.  
  250.    Another benefit of grouping objects together is that it reduces
  251.    the number of objects in the main object list, and thus locating
  252.    an object is easier.
  253.  
  254.    A side effect of grouping objects that are close together is that
  255.    it can speed up the rendering time for a scene. Bearing this in
  256.    mind it is a good idea to group items together with a little thought.
  257.  
  258.    Grouping objects together         
  259.  
  260.    To group the selected objects together, first enter a new unique
  261.    name in the writable icon at the bottom of the Toolbox.
  262.  
  263.    Now click on the group icon, or select group from the select sub-
  264.    menu which can be found on the main program menu.
  265.  
  266.    Removing objects from a group     
  267.  
  268.    To remove the selected objects from a group simply click on the
  269.    ungroup icon in the toolbox, or select ungroup from the select
  270.    sub-menu in the main program menu. The objects will not be deleted,
  271.    but will instead be placed in the parent group to the one they
  272.    were in before.
  273.  
  274.    Any groups which become empty after this operation are deleted.
  275.  
  276.    Moving objects between groups     
  277.  
  278.    To move objects from within one group to within another, select
  279.    the objects you wish to move, and then enter the group that you
  280.    wish to move them into. Now click on the move icon.
  281.  
  282.    Rename                            
  283.  
  284.    It is possible in !Ray3d-Pro to rename any selected objects after
  285.    you have already created them. This also applies when you select
  286.    multiple objects, because each will be renamed to the new name
  287.    specified, with an additional number at the end.
  288.  
  289.    To rename objects once they have been created, type in the new name
  290.    into the writable icon at the foot of the toolbox, and then click
  291.    on the rename icon.
  292.  
  293.    Copying objects                   
  294.  
  295.    To copy objects, lights or groups simply select them and then
  296.    click on the copy icon. Copied items will appear in the same group
  297.    as the original object, group or whatever.
  298.  
  299.    Hiding.                           
  300.  
  301.    Sometimes, when creating a large scene it becomes impossible to
  302.    see exactly where points are being positioned due to other objects
  303.    getting in the way.
  304.  
  305.    !Ray3d-Pro allows you to ‘hide’ objects so that they are not shown
  306.    in the view windows. They will however be present if the scene
  307.    is raytraced.
  308.  
  309.    To hide objects, simply select them on the Object list and then
  310.    choose the hide option off the select sub-menu on the main
  311.    program menu, or click on the hide/show icon in the toolbox.
  312.  
  313.    So that you can tell that an object has been hidden, the name of
  314.    it will appear in blue on the object list.
  315.  
  316.  
  317.   Showing hidden objects             
  318.  
  319.   To re-display hidden objects in the view windows, select the desired
  320.   objects on the object list and then choose the show option from
  321.   the select sub-menu on the main program menu, or click on the show
  322.   icon.
  323.  
  324.  
  325.    The Basics
  326.  
  327.    What needs to be done to create a scene.
  328.  
  329.    To create a scene, you must first define the objects that will be
  330.    raytraced. Each of these objects must then be given a surface which
  331.    determines the colour, reflectivity, etc. of the objects, and
  332.    optionally a texture to apply such as marble.
  333.  
  334.    The observer must be placed at a point in the scene, as well as
  335.    another target point which is what the observer will look at.
  336.  
  337.    Finally, light must be present to raytrace a scene, so up to ten
  338.    light sources may be defined.
  339.  
  340.    Saving                            
  341.  
  342.    To save your scene, you do it in the normal RISC OS manner, using
  343.    the save option which is located in the Project sub-menu on the
  344.    main program menu. If your scene has already been saved, you may
  345.    save again using the same name by clicking on the save icon in
  346.    the toolbox.
  347.  
  348.    Moving around the !Ray3d-Pro world
  349.  
  350.    To view a different part of the scene simply use the scroll bars
  351.    on the view windows.
  352.  
  353.    To locate a point in three dimensions it is necessary to click
  354.    the mouse in two of the three view windows. This is because in 3d
  355.    a point has three coordinates (x,y,z) and clicking in one window
  356.    only sets two of the coordinates. Clicking in the second window
  357.    will set the third coordinate.
  358.  
  359.    Selecting points                  
  360.  
  361.    When this icon is selected, clicking in the view windows will set
  362.    the position of the cursor which is shown as a blue cross.
  363.    If you experiment moving the cursor around you will get the hang
  364.    of the tri-view system.
  365.                                                 
  366.    Zooming                               
  367.  
  368.    These two icons located in the toolbox zoom in or out of the scene.
  369.    Clicking on one will cause the scene to be redrawn at a different
  370.    zoom factor.
  371.  
  372.    After zooming the window, the scene is always positioned so that
  373.    the cursor appears in the centre of the window. So to zoom in on
  374.    a specific point, position the cursor on the point of interest and
  375.    click on the zoom in icon.
  376.  
  377.    It is also possible to set the zoom by selecting the desired zoom
  378.    factor from the zoom sub-menu on the main program menu.
  379.  
  380.    Note: The minimum zoom is 100% and the maximum zoom is 800%
  381.  
  382.  
  383.    Tutorial
  384.    
  385.    This tutorial takes you through the steps of creating a scene ready
  386.    for raytracing. The scene can then be loaded into !RayShade which
  387.    will produce the finished raytraced picture. If you are a complete
  388.    beginner to raytracing I suggest you read the introductions
  389.    
  390.    The scene we are going to raytrace is not going to be anything
  391.    spectacular - just a sphere suspended in mid air. This should however
  392.    get you used to using !Ray3d-Pro and lead you on to experimenting.
  393.    
  394.    Loading !Ray3d-Pro
  395.    
  396.    To load !Ray3d-Pro, simply double click on it's icon in the directory
  397.    viewer, and it will install on the icon bar.
  398.    
  399.    The views
  400.    
  401.    Clicking on the !Ray3d-Pro icon on the icon bar will bring up three view
  402.    windows and the toolbox.
  403.    
  404.    The view windows show a wireframe view onto the scene you are designing
  405.    from three different positions. This gives you a plan, side and front
  406.    view of your scene.
  407.  
  408.    All of the objects in the current scene are listed in another window,
  409.    and any object may be selected by clicking on it's name. Clicking with
  410.    SELECT will select the object you clicked on and nothing else, while
  411.    clicking with ADJUST will select the object in addition to any others
  412.    already selected.
  413.  
  414.    Another window will have opened which contains a number of tool icons.
  415.    These may seem confusing at first, but you will soon learn what they
  416.    mean.
  417.  
  418.    The currently selected tool is shown with a shaded background.
  419.    It should be the select icon at the moment.                    
  420.  
  421.    Creating a sphere
  422.    
  423.    Clicking anywhere within the view windows will position the cursor
  424.    which is used to determine where the centre of the sphere will be.
  425.    
  426.    By clicking in the windows, move the cursor to any position
  427.    you wish, and then click on the sphere icon in the toolbox.    
  428.    
  429.    The sphere tool should now be shaded to indicate that it is the tool
  430.    currently being used, and clicking in the view windows will alter the
  431.    size of the sphere.
  432.    
  433.    When the size of the sphere is satisfactory, click on the ADJUST
  434.    button while the mouse pointer is over a !Ray3d-Pro window or click
  435.    on the set icon in the toolbox. The sphere will then become part of
  436.    the current scene, and it's name appear will be added to the list
  437.    of objects.
  438.    
  439.    If at any time you wish to abandon creating a sphere, click
  440.    on the select icon.                                            
  441.    
  442.    Setting up a target and observer
  443.    
  444.    To set up the target (what the observer will look at),
  445.    click on the target icon in the toolbox . Now click anywhere   
  446.    in the view windows and a red cross will appear to indicate
  447.    the position of the target. By clicking in the centre of the
  448.    sphere in two windows, position the target at the centre of
  449.    the sphere.
  450.    
  451.    To set the position of the observer (where to look from),
  452.    click on the observer icon in the toolbox. Now clicking        
  453.    anywhere in the view windows will set the observer's
  454.    position (a red circle).
  455.    
  456.    When both the target and observer are set correctly, choose the
  457.    select tool from the toolbox so that clicking will move the cursor.
  458.    
  459.    Colouring the spheres
  460.    
  461.    In the toolbox, there is an icon that resembles a paint        
  462.    pot. Click on this and a new window should appear.
  463.    (alternatively choose 'World ⇨ Link' from the menu.)
  464.    
  465.    Within this window is two lists - one shows all the surfaces defined,
  466.    while the other shows all the objects within a scene. Also, on the
  467.    right of the window can be seen the current object, it's associated
  468.    surfaces and texture information.
  469.    
  470.    Choose the sphere you have created (by clicking on it's name in the
  471.    list) and then choose a surface to apply to it (by clicking on a
  472.    surface in the list). The chosen surface should become highlighted.
  473.    
  474.    If you wish to change the surface of an object again - click on the
  475.    current surface to deselect it, and then click on the desired new
  476.    surface.
  477.    
  478.    When you have finished close the window.
  479.    
  480.    Saving the scene
  481.    
  482.    To save the current scene to disc, select the save option in the
  483.    normal way from the 'Project' sub-menu of the main menu.
  484.  
  485.    Raytracing
  486.  
  487.    Load the !Shade4 application, and drag the file that you have just
  488.    saved from the directory viewer onto the Shade4 icon on the icon bar.
  489.    You will be prompted to save a text file, which you can now raytrace
  490.    using the Public Domain raytracer !Rayshade. (you will probably have
  491.    been supplied with this).
  492.  
  493.  
  494.    Customizing !Ray3d-Pro
  495.  
  496.    There are two ways of customizing !Ray3d-Pro to suit your particular
  497.    needs and styles.
  498.  
  499.    Firstly, certain settings in !Ray3d-Pro may be saved so that they
  500.    become the default, by choosing  from the icon bar menu.
  501.  
  502.    Secondly, !Ray3d-Pro loads default 3d file when it is first run. This
  503.    file may contain anything that makes up a scene, including objects,
  504.    lights, surfaces, etc.
  505.  
  506.    Saving the default file
  507.  
  508.    To save the default file, create all the objects, lights etc. which
  509.    you require to be loaded when !Ray3d-Pro is first run. Now choose the
  510.    ‘save default’ option from the ‘project’ sub-menu on the main program
  511.    menu.
  512.  
  513.    Whenever !Ray3d-Pro is run, it will start up with the scene you just
  514.    saved already loaded.
  515.  
  516.    Loading in the default file
  517.  
  518.    The default file is loaded when !Ray3d-Pro is first run, but it is
  519.    possible to re-load it later. To do this select the ‘load default’
  520.    option from the ‘project’ sub-menu on the main program menu.
  521.  
  522.  
  523.    Help on menu entries
  524.  
  525.    The following pages follow the same layout as the menus. By moving
  526.    through these options as if they were a menu, you will get help on
  527.    each menu option.
  528.  
  529.  
  530.    The Icon Bar Menu
  531.  
  532.    Info
  533.  
  534.   This option leads to a sub-menu displaying information about
  535.   !Ray3d-Pro such as the version you have.
  536.  
  537.    Quit
  538.  
  539.    Selecting this menu option quits !Ray3d-Pro.
  540.  
  541.    If you have an unsaved scene, !Ray3d-Pro will prompt you to either
  542.    save or discard it.
  543.  
  544.    The Main Program Menu
  545.  
  546.    Project
  547.  
  548.    About...
  549.  
  550.    Selecting this option will open up a window with information about
  551.    the current scene. The information shown includes:
  552.  
  553.      * How many objects have been created
  554.      * How many groups have been created
  555.      * How many surfaces have been defined
  556.      * How many lights are in the scene
  557.      * How many objects are currently selected
  558.      * The name of the group currently displayed in the object list.
  559.  
  560.      Select
  561.  
  562.      Group
  563.  
  564.      World
  565.  
  566.    The Grid
  567.  
  568.    The grid options are located on the ‘Grid’ sub-menu which is
  569.    accessible from the main program menu.
  570.  
  571.    !Ray3d-Pro can superimpose a rectangular grid on the scene. This is
  572.    often useful for lining up objects and for checking their size.
  573.    The grid is shown as horizontal and vertical lines which intersect
  574.    at ‘grid points’.
  575.  
  576.    You can use the grid either just as a general guide for creating
  577.    objects or you can lock points to it, so that they always align with
  578.    points in the grid. When you are creating objects with snap to grid
  579.    on, you will see them attach to the nearest grid point to the mouse
  580.    position.
  581.  
  582.    Show Grid                         
  583.  
  584.    Selecting this option toggles whether the grid should be displayed.
  585.  
  586.    Snap To grid                      
  587.  
  588.    This switches snap to grid on or off. The grid does not need to be
  589.    visible for this option to function.   
  590.  
  591.    Variable grid
  592.  
  593.    This option is the same as auto-resize grid on the  window.
  594.    When on, this option ensures that the grid size remains constant
  595.    while you are zooming in and out of an image. If this option is off,
  596.    then zooming into an image will cause the grid size to increase,
  597.    and vice versa for zooming out.
  598.  
  599.    Grid Options
  600.  
  601.    This sub-menu leads to a window which allows you to set the colour
  602.    and spacing on the grid.
  603.  
  604.    To change the grid colour, simply select a new colour from this
  605.    window.
  606.  
  607.    To change the grid size, alter the number in the writable icon.
  608.  
  609.    Clicking on OK sets the new colour and grid size.
  610.  
  611.    Zoom
  612.  
  613.    This option leads to a sub-menu where you may select a zoom factor
  614.    ranging from 100% to 800%. The current zoom factor is indicated
  615.    by a tick.
  616.  
  617.    After zooming, the scene is always positioned so that the cursor
  618.    appears in the centre of the window.
  619.  
  620.  
  621.    Tools...
  622.  
  623.    Selecting this option brings up the Toolbox window.
  624.  
  625.  
  626.    Co-ords...
  627.  
  628.    Selecting this option opens the Coordinates window which shows
  629.    the coordinates of the mouse pointer as it is moved over the
  630.    view windows. The co-ordinates are in internal world units and
  631.    can be used to correspond to cms, inches, metres or whatever
  632.    is necessary.
  633.  
  634.  
  635.    The textures menu
  636.  
  637.    Options
  638.  
  639.    When "Options..." is selected from the icon bar menu, a window is
  640.    opened which allows you to customise many of Ray3d-Pro's features.
  641.  
  642.    There are three buttons at the foot of the window:
  643.  
  644.      Save   - will save your settings to disk
  645.      Cancel - will close the window without making any changes
  646.      OK     - will close the window, and make the changes you
  647.               have made.
  648.  
  649.    When you click on Save, Ray3d-Pro also saves the position of the
  650.    view windows, toolbox, object list and coordinates window so that
  651.    they appear in the same locations when you restart the program.
  652.    Also included is the grid size, and colour.
  653.  
  654.    Toolbox Size:
  655.  
  656.    By using this option, you may choose the shape of the toolbox
  657.    window.
  658.  
  659.    Toolbox icons
  660.  
  661.    It is possible to remove icons from the toolbox by clicking on them
  662.    in this section of the Options window. Tools which will not appear
  663.    on the toolbox are shown in grey, while those that will appear are
  664.    in colour. To add icons back onto the toolbox, simply click on them
  665.    again.
  666.  
  667.    You can use this option to reduce the size of the toolbox window, or
  668.    remove icons that you never use.
  669.  
  670.    Colours
  671.  
  672.    You might not like the colour system I have designed, and so you can
  673.    change it. To change a colour click on the colour bar with the mouse
  674.    pointer. Clicking withe SELECT or ADJUST cycles through the available
  675.    colours.
  676.  
  677.    View Type
  678.  
  679.    Some people prefer the tri-view method of display (like me), but
  680.    other people like to work with only one window on the screen in
  681.    a similar manner to Euclid.
  682.  
  683.    Selecting single view will replace the tri-view system with a single
  684.    view onto the Ray3d-Pro world. Along the bottom of this single
  685.    view is three icons. Clicking on them changes the view between front
  686.    side and plan views.
  687.  
  688.    Auto-save
  689.  
  690.    This option causes Ray3d-Pro to automatically save your work after
  691.    a specified amount of time ranging from 1 to 99 minutes. When the
  692.    time comes for an auto-save you will be prompted on the screen to
  693.    confirm that you want to save the file.
  694.  
  695.    Preview
  696.  
  697.    The three dimensional wireframe preview has a couple of options
  698.    associated with it to provide more control over a scene.
  699.  
  700.    The first is draw the outline of each object in the nearest colour
  701.    available in the current mode to the colour the object will appear
  702.    when raytraced. When this option is off, all objects are shown in
  703.    white.
  704.  
  705.    The second option is to preview only the objects that are selected.
  706.    This is useful to check that a single part of the scene is turning
  707.    out as you expected, and it also speeds up the preview.
  708.  
  709.    Auto open Co-ords
  710.  
  711.    If this option is selected, Ray3d-Pro will open the coordinates
  712.    window when Ray3d-Pro is loaded, or the icon on the icon bar is
  713.    clicked on, or a new file is loaded.
  714.  
  715.    Auto-resize Grid
  716.  
  717.    When selected, this option ensures that the grid size remains constant
  718.    while you are zooming in and out of an image. If this option is off,
  719.    then zooming into an image will cause the grid size to increase,
  720.    and vice versa for zooming out.
  721.  
  722.    Copy: offset objects
  723.  
  724.    If this option is off when an object is copied, then the new object
  725.    will be created in exactly the same position of the old object.
  726.  
  727.    If this option is on, then the copied object will appear one grid
  728.    square away from the original object.
  729.  
  730.    Interactive help
  731.  
  732.    Please note that interactive help does not mean that this program
  733.    supports the Acorn !Help application, but rather the application
  734.    you are using right now to read this.
  735.  
  736.    Ray3d-Pro supports context sensitive help when this help reader
  737.    application is loaded. To receive help on a specific option or
  738.    tool in !Ray3d-Pro, hold down CONTROL and click on the option with
  739.    the mouse. If there is no help available you will hear a beep.
  740.  
  741.    Thus if you clicked on the move icon with CONTROL held down, then
  742.    the help section on moving objects would be displayed.
  743.  
  744.    Synchronised windows
  745.  
  746.    While this option is on, moving the scroll bar in one of the view
  747.    windows causes the other view windows to move thus providing a
  748.    view onto the same part of the scene. When this option is off, you
  749.    may move each window's scrollbars indepandantly.
  750.  
  751.    Auto-scroll windows
  752.  
  753.    When this option is on, pressing a mouse button near the edge of
  754.    a view window will cause it to scroll in that direction in relation
  755.    to how near the edge you are. This is not recommended for slow
  756.    machines (such as my humble A3000).
  757.  
  758.    Select distance.
  759.  
  760.    It is possible to select objects in the world without clicking on
  761.    their names in the object list, but by clicking on them in the
  762.    view window while holding down SHIFT.
  763.  
  764.    When you do this, all objects within the "select distance" of your
  765.    click and the cursor will be selected.
  766.  
  767.  
  768.    Creating Objects
  769.  
  770.    !Ray3d-Pro allows you to create many different types of objects,
  771.    which can then have surfaces and textures applied to them to
  772.    create a realistic scene.
  773.  
  774.    To create a shape, you must first enter the name you wish to give
  775.    your shape into the icon at the foot of the toolbox. If you do not
  776.    do this, !Ray3d-Pro will choose an appropriate  name for you.
  777.  
  778.    Clicking on the select icon at any time while
  779.    creating a shape will cancel the operation.       
  780.  
  781.  
  782.    Creating Spheres                  
  783.  
  784.    Firstly, position the cursor (the blue cross) where the centre
  785.    of the sphere should be located, and click on the sphere icon in
  786.    the toolbox.
  787.  
  788.    Clicking in the view windows now will allow you to select the
  789.    radius for your sphere, and when this is satisfactory, click on
  790.    the ADJUST mouse button or click on the set icon in the toolbox.
  791.  
  792.  
  793.    Cones                             
  794.  
  795.    Position the cursor at the centre of one end of the cone, and
  796.    then click on the ‘cone’ icon.
  797.  
  798.    Now using the view windows, click where the centre of the far
  799.    end of the cone should be. Use the ADJUST button to set this
  800.    point or click on the set icon in the toolbox.
  801.  
  802.    Clicking in the view windows will now indicate how wide the
  803.    first end of the cone should be, and when this is correct click
  804.    on ADJUST or click on the set icon in the toolbox.
  805.  
  806.    Do the same thing to set the size of the other end of the cone,
  807.    clicking on ADJUST or the set icon when this is done.
  808.  
  809.  
  810.    Cylinders                         
  811.  
  812.    Position the cursor at the centre of one end of the cylinder,
  813.    and then click on the ‘cylinder’ icon.
  814.  
  815.    Now using the view windows, click where the centre of the far
  816.    end of the cylinder should be. Use the ADJUST button to set this
  817.    point or click on the set icon in the toolbox.
  818.  
  819.    Clicking in the view windows will now indicate how wide the
  820.    cylinder should be, and when this is correct click on ADJUST
  821.    or click on the set icon in the toolbox.
  822.  
  823.  
  824.    Boxes                             
  825.  
  826.    Position the cursor at the centre of where the box should be
  827.    located, and then click on the ‘Box’ icon.
  828.  
  829.    Clicking in the view windows will now set the size of the box,
  830.    and when this is correct click on the ADJUST button or click on
  831.    the set icon in the toolbox
  832.  
  833.    NOTE: To make boxes which are tilted, or stand on one end, etc.
  834.          You should create a box, and then rotate it.
  835.  
  836.  
  837.    Rounded boxes                     
  838.  
  839.    !Ray3d-Pro allows you to define boxes which have slightly rounded
  840.    edges, so that it is possible to do such things as cushions.
  841.  
  842.    To create a rounded box, perform the same operation as for ,
  843.    but click on the ‘Rounded box’ icon instead.
  844.  
  845.    NOTE: Rounded boxes appear on the view windows as normal boxes,
  846.          the only difference appears when the scene is raytraced.
  847.  
  848.  
  849.    Pyramids                          
  850.  
  851.    To create a pyramid, first position the cursor where a corner of
  852.    the base is to be located, and then click on the ‘Pyramid’ icon.
  853.  
  854.    Now, clicking in the view windows will allow you to set the opposite
  855.    corner of the pyramid base. Click on ADJUST when this is correctly
  856.    positioned or click on the set icon in the toolbox.
  857.  
  858.    Clicking in the view windows again will set the point of the
  859.    pyramid. Click on ADJUST when this is done or click on the set icon
  860.    in the toolbox.
  861.  
  862.  
  863.    Rectangles                        
  864.  
  865.    Position the cursor at one corner of the rectangle, and then click
  866.    on the ‘Rectangle’ icon.
  867.  
  868.    Clicking anywhere in the view windows will position the opposite
  869.    corner of the rectangle, and when this is done click on ADJUST
  870.    or click on the set icon in the toolbox.
  871.  
  872.    As rectangles are 2 dimensional objects, they may only be defined
  873.    in one of the view windows at a time.
  874.  
  875.  
  876.    Planes                            
  877.  
  878.    Planes are a special sort of rectangle which is infinitely large.
  879.    That is, that it will go on forever. This is useful for creating
  880.    such things as walls, floors and ceilings.
  881.  
  882.    To create a plane, do it in the same manner as for ,
  883.    only click on the ‘Plane’ icon instead. Planes can be easily
  884.    distinguished on the view windows as they are drawn with a dotted
  885.    line.
  886.  
  887.  
  888.    Triangles                         
  889.  
  890.    To create a triangle, position the cursor at one point on the
  891.    triangle, and then click on the ‘Triangle’ icon.
  892.  
  893.    Clicking in the view windows will position the second point in
  894.    the triangle, and pressing the ADJUST button will set this point.
  895.  
  896.    Clicking again in the view window will position the third point
  897.    in the triangle. Click on ADJUST when this is correct.
  898.  
  899.  
  900.    Discs                             
  901.  
  902.    Discs are 2 dimensional objects, and as such can only be defined
  903.    in one view window at a time.
  904.  
  905.    Firstly, position the cursor where the centre of the disc is to be,
  906.    and click on the ‘Disc’ icon.
  907.  
  908.    Clicking in a view window will now select the radius of the disc,
  909.    and clicking on ADJUST will create the object.
  910.  
  911.  
  912.    Polygons                          
  913.  
  914.    A polygon is a 2 dimensional shape that may have any number of
  915.    sides.
  916.  
  917.    To create a polygon follow these steps:
  918.  
  919.       1:  Position the cursor at one point of the shape.
  920.       2:  Click on the ‘polygon’ icon
  921.  
  922.       3:  Click in the view windows to position the next point
  923.       4:  Click on the ADJUST button to set this point when it
  924.           is correctly positioned or click on the set icon.
  925.       5:  Repeat steps (3) and (4) until all the points on the
  926.           polygon have been defined.
  927.  
  928.       6:  Click ADJUST twice to create the object.
  929.  
  930.  
  931.    Creating Lights.                  
  932.  
  933.    First, position the cursor at the point where the light source is to
  934.    be, and click on the ‘light’ icon. When you do, a short menu will
  935.    appear with the  listed on it. Select the type of light
  936.    you want to create.
  937.  
  938.    Clicking anywhere in the view windows will allow you to set the size
  939.    of the light. The larger the light is, the more light is cast upon
  940.    the scene.When the light is of the required size, click the ADJUST
  941.    button to create it or click on the set icon in the toolbox.
  942.  
  943.    Beware: Lights that are too large will make everything in the scene
  944.            appear white and over-exposed.
  945.  
  946.    To change the colour of a light, simply link a surface to the light
  947.    and the light will cast the same colour light as the surface colour.
  948.  
  949.  
  950.    Light types
  951.  
  952.    Currently there are two types of light sources, although more
  953.    will be added in the future..
  954.  
  955.    Point light sources
  956.  
  957.    Point light sources are the default light type used by !Ray3d-Pro.
  958.    They cast very sharp shadows, which can give the scene a distinctly
  959.    computer drawn look. The advantage of them is that they are the
  960.    quickest form of lights to raytrace.
  961.  
  962.    Extended light sources.
  963.  
  964.    Extended light sources cast a ‘soft’ shadow on the world. This
  965.    means that shadows fade from dark to light, giving a more realistic
  966.    effect.
  967.  
  968.    NOTE: Using extended light sources will dramatically increase the
  969.          time taken to raytrace the scene.
  970.  
  971.  
  972.    Linking objects, surfaces and textures.     
  973.  
  974.    Up to now, we have created the objects which are to be included in
  975.    the scene, and we have created some surfaces, which define the
  976.    colours and materials such as glass, metal, etc.
  977.  
  978.    What we haven’t done however, is to tell !Ray3d-Pro which objects
  979.    should be made up from which surfaces, and everything in the scene
  980.    starts off with a default colour of white.
  981.  
  982.    To associate surfaces and textures with the objects in the scene,
  983.    select the ‘Link’ option from the ‘World’ sub-menu which can be
  984.    found on the main program menu, or alternatively click on the
  985.    paint pot icon in the toolbox.
  986.  
  987.    The link window
  988.  
  989.    On the left hand side of the link window are two lists, of which
  990.    the top one displays the objects in the scene, and the bottom one
  991.    displays the surfaces available.
  992.  
  993.    On the left hand side of the window are icons which allow you to
  994.    specify which  will be applied to an object.
  995.  
  996.    Clicking on an object in the top list will choose it for linking
  997.    with a surface and . Whole groups can be selected by
  998.    clicking on their names next to them, but you may enter a group
  999.    by clicking on the arrow next to it's name if you want to individually
  1000.    link surfaces to each part of the group.
  1001.  
  1002.    On the top of the right hand side, there are four icons:
  1003.  
  1004.            Object:  Shows the currently selected object
  1005.         Surface 1:  Shows the main surface associated with the
  1006.                     selected object.
  1007.         Surface 2:  Shows the secondary surface associated with
  1008.                     the selected object.
  1009.           Texture:  Shows the texture that will be applied to the
  1010.                     object.
  1011.  
  1012.    To set the surfaces click on the desired surface names. The first
  1013.    name clicked on will become the main surface, and the second surface
  1014.    will become the secondary surface. Clicking again on a surface de-
  1015.    selects it.
  1016.  
  1017.    The secondary surface associated with an object will specify what
  1018.    other colours and attributes are used for textures that require
  1019.    two surfaces.
  1020.  
  1021.    The texture for an object can be changed by clicking on the menu
  1022.    icon next to the texture name. This will bring up a small menu with
  1023.    the available texture types on it. See the relevant section for more
  1024.    about textures.
  1025.  
  1026.  
  1027.    The surface editor.               
  1028.  
  1029.    The editor is brought up by clicking on the ‘surfaces’ icon in the
  1030.    toolbox, or by choosing the ‘Surfaces’ option from the ‘World’
  1031.    sub-menu on the main program menu.
  1032.  
  1033.    Under the list of defined surfaces is a writable icon which contains
  1034.    the name of the surface being edited / defined which will need to
  1035.    be altered if you are defining a new surface.
  1036.  
  1037.    Editing a surface
  1038.  
  1039.    First choose the surface for editing, or create a new one, and
  1040.    then to alter the colour of the object use the red, green and blue
  1041.    slider bars. The nearest colour available in the mode you are in
  1042.    will be used to show the surface colour.
  1043.  
  1044.    The other characteristics which may be altered by clicking on the
  1045.    appropriate up / down arrows are:
  1046.  
  1047.    If the "no shadow" option is on, then when the scene is raytraced
  1048.    no shadows will be cast onto any objects with this surface.
  1049.  
  1050.    Editing a different surface
  1051.  
  1052.    To edit a different surface, click on it's name in the surface list
  1053.    at the top of the window.
  1054.  
  1055.    Note: Any changes made to the current surface will not be saved unless
  1056.          you click on "Set" first.
  1057.  
  1058.    Creating a new surface
  1059.  
  1060.    To create a new surface, choose the surface it will be most like
  1061.    and alter the surface name and any other characteristics required.
  1062.  
  1063.    Now click on the ‘Define’ icon
  1064.  
  1065.    Deleting a surface
  1066.  
  1067.    Choose the surface to be deleted and click on the ‘delete’ icon.
  1068.  
  1069.  
  1070.    Reflectivity
  1071.  
  1072.    This option determines how reflective a surface is.
  1073.  
  1074.        100% = a perfect mirror which reflects everything.
  1075.         50% = some reflections can be seen in the object
  1076.               eg: a snooker ball
  1077.          0% = a matt surface, which reflects nothing.
  1078.  
  1079.    NOTE: It is possible to create coloured mirrors, by altering the
  1080.          colour of the surface. To create a perfect mirror, each
  1081.          red, green and blue component of the surface should be set
  1082.          to an equal amount such as 2% 
  1083.  
  1084.  
  1085.    Transparency
  1086.  
  1087.    This option determines how Transparent a surface is.
  1088.  
  1089.        100% = Light will pass completely through the object
  1090.         50% = The object appears coloured, and other objects can
  1091.               be seen dimly through it.
  1092.          0% = Nothing can be seen through the object
  1093.  
  1094.    NOTE: It is possible to make coloured transparent objects by
  1095.    altering the colour of the surface.
  1096.  
  1097.  
  1098.    Translucency
  1099.  
  1100.    Translucency is similar to transparency but has a slightly different
  1101.    effect. It describes how ‘murky’ or ‘cloudy’ an object appears
  1102.  
  1103.        100% = Very cloudy
  1104.         50% = The object appears slightly cloudy.
  1105.               Eg: If the object was also a transparent sphere, it
  1106.                   would resemble a crystal ball.
  1107.          0% = No effect at all
  1108.  
  1109.    NOTE: It is possible to make coloured transparent objects by
  1110.    altering the colour of the surface.
  1111.  
  1112.  
  1113.    Speed of light.
  1114.  
  1115.    When light passes through a transparent object, it can be ‘bent’,
  1116.    which is due to the speed of light altering slightly.
  1117.  
  1118.    For example: If you stick your finger into some water, it appears
  1119.                 to bend where your finger enters the water.
  1120.  
  1121.    !Ray3d-Pro allows you to alter the amount by which the light bends,
  1122.    so that you may create surfaces such as water, glass, crystal, etc.
  1123.  
  1124.        100% = the light does not bend at all.
  1125.         58% = the light bends as much as it does for GLASS.
  1126.         50% = the light bends as much as it does for WATER.
  1127.         40%   the light bends as much as it does for DIAMOND.
  1128.  
  1129.  
  1130.    Specularity
  1131.  
  1132.    This value controls how large the highlights on an object will
  1133.    appear when a light shines on them.
  1134.  
  1135.      Eg: The spot of light on a sphere.
  1136.  
  1137.    Larger values of specularity result in smaller highlights, but you
  1138.    should find the pre-set value of 25% suitable for most things.
  1139.  
  1140.  
  1141.    Setting the observer and target point
  1142.  
  1143.    In order for a scene to be raytraced, you must have first positioned
  1144.    the observer, and the point at which the observer is looking at.
  1145.  
  1146.    The toolbox provides two icons which allow you to set these
  1147.    points:
  1148.  
  1149.    The observer                      
  1150.  
  1151.    When this icon is selected, clicking anywhere in the view windows
  1152.    will set the position of the observer which is indicated by a
  1153.    small red circle.
  1154.  
  1155.    The target point                  
  1156.  
  1157.    When this icon is selected, clicking anywhere in the view windows
  1158.    will set the position of the point that the observer is looking at,
  1159.    which is indicated by a small red cross.
  1160.  
  1161.    Using the 3d view                 
  1162.  
  1163.    When you bring up the 3d view of the scene using the 3d icon in the
  1164.    toolbox, there is a pane attatched to the window which allows you
  1165.    to alter the observer's location interactively. Clicking on the zoom
  1166.    icons, or the arrows in the pane will move the observer point.
  1167.  
  1168.    Clicking with ADJUST moves the observer point in larger increments.
  1169.  
  1170.  
  1171.    Special functions
  1172.       _______________________________________________________
  1173.  
  1174.    Printing                         
  1175.  
  1176.    The Print option can be found on the ‘Project’ sub-menu, on the
  1177.    main program menu.
  1178.  
  1179.    Moving over the ‘print’ option opens a window which shows you the
  1180.    current printer driver, and which view will be printed..
  1181.  
  1182.    Choose which view you wish to print by clicking on the radio icons,
  1183.    and then click on OK to start printing.
  1184.  
  1185.    NOTE: To print, you must have a RISC OS printer driver loaded.
  1186.  
  1187.    The Background.
  1188.  
  1189.    The basis of raytracing is that every ray of light that the observer
  1190.    can see is traced back through the scene, hitting, passing through
  1191.    or reflecting off each object.
  1192.  
  1193.    If the ray of light does not hit any objects then it is given the
  1194.    background colour.
  1195.  
  1196.      eg: A scene consisting of only a sphere will have many rays that
  1197.          do not hit the sphere, and so are coloured black (the default
  1198.          background colour).
  1199.  
  1200.    !Ray3d-Pro allows you to alter the background colour to any other
  1201.    colour that you wish.
  1202.  
  1203.    To do this choose the ‘Background’ option from the ‘World’ sub-menu
  1204.    on the main program menu. This will open a window with three slider
  1205.    bars which can be dragged to set the required colour.
  1206.  
  1207.    Advanced users
  1208.  
  1209.    When using this option you may notice that the background colour is
  1210.    constant throughout the scene, which is not always desirable.
  1211.  
  1212.    To make the sky fade from light to dark blue in the distance, the
  1213.    background colour should be left as black, and a  created where
  1214.    the sky / ceiling should be, which you give a blue colour.
  1215.  
  1216.  
  1217.    Editing functions
  1218.  
  1219.    Scaling objects.                  
  1220.  
  1221.    To scale the selected objects, bring up the scaling window by
  1222.    clicking on the scale icon, or by selecting it from the "Select"
  1223.    menu.
  1224.  
  1225.    In the window, you will see three writeable icons, one for each
  1226.    of the directions you can scale an object in. So that you can
  1227.    remember which direction X, Y or Z is, you will find that in the
  1228.    title bar of each view window it tells you.
  1229.  
  1230.    To scale an object simply type in the values and click on OK.
  1231.  
  1232.    NOTE: objects will be scaled from the cursor, as in the diagram
  1233.    below.
  1234.  
  1235.    Scaling objects by different amounts in each direction
  1236.  
  1237.    Some objects (sphere, cone and cylinder) cannot be scaled by
  1238.    different amounts in each direction without them being split up
  1239.    into polygons. The side effect of this is that the object will
  1240.    loose it's curved surface, and will appear made up of small
  1241.    sections.
  1242.  
  1243.    This can be limited by increasing the Resolution value (the higher
  1244.    it is, the smoother the shape), but this also increases the number
  1245.    of objects in the scene.
  1246.  
  1247.    It is possible to stop curved shapes from getting changed into
  1248.    polygons by turning off the "Convert to polygons" option. If you
  1249.    do this, then the objects are scaled by the same amount in all
  1250.    directions.
  1251.  
  1252.    Moving Objects                    
  1253.  
  1254.    To move the currently selected objects, first move the cursor onto
  1255.    the point you wish to move from.
  1256.  
  1257.    Now click on the move icon, and click in the view windows to
  1258.    indicate where you wish to move the point to. While you are doing
  1259.    this you will see a line being drawn from the first point to this
  1260.    new point.
  1261.  
  1262.    When you have chosen where to move the point to, press ADJUST or
  1263.    click on the set icon in the toolbox to move the objects.
  1264.  
  1265.    NOTE: clicking on the select icon at any time, will cancel the move
  1266.          operation.
  1267.  
  1268.    Rotate                            
  1269.  
  1270.    There are two methods of rotating the selected objects. The first
  1271.    is to use the rotate icon on the toolbox, while the second in to
  1272.    use the menu option ‘Rotate’ on the ‘select’ sub-menu which can
  1273.    be found on the main program menu.
  1274.  
  1275.    The rotate icon
  1276.  
  1277.    To use the rotate icon, select the objects that you wish to rotate,
  1278.    and then place the cursor (the blue cross) at the point you wish to
  1279.    rotate around.
  1280.  
  1281.    Now follow these steps.
  1282.  
  1283.      1 - Click on the rotate icon
  1284.      2 - Click on one of the points in the objects you wish to rotate
  1285.          Press the ADJUST button to set this point
  1286.      3 - Click where you want the point in (2) to end up.
  1287.          Press ADJUST to set it.
  1288.  
  1289.    While you are setting the points in (2) and (3), you will see a
  1290.    line being drawn from the centre of rotation to the point.
  1291.  
  1292.    Using the menu to rotate
  1293.  
  1294.    Using the menu is more tricky, but allows you to accurately set the
  1295.    amount of rotation.
  1296.  
  1297.    Before using the menu, you must select the objects you wish to rotate
  1298.    and place the cursor at the point you want to rotate around.
  1299.  
  1300.    Moving over the ‘Rotate’ option will open a window where three angles
  1301.    may be entered for rotation in any of the view windows. These angles
  1302.    can be entered by typing them into the icons, or altered by clicking
  1303.    on the arrows.
  1304.  
  1305.    Deleting Objects and groups       
  1306.  
  1307.    To delete the selected objects and groups, click on the delete icon
  1308.    or choose the ‘delete’ option from the ‘select’ sub-menu on the main
  1309.    program menu.
  1310.  
  1311.    As it is very easy to click on the icon by accident, the mouse pointer
  1312.    will change shape. Clicking on the left mouse button or pressing ‘Y’ on
  1313.    the keyboard will perform the delete operation, while anything else will
  1314.    abort the operation.
  1315.  
  1316.    If you wish to delete all of the objects within a scene then use the
  1317.     option
  1318.  
  1319.  
  1320.    Clearing a scene of objects or surfaces
  1321.  
  1322.    The clear option is located on the "Project" sub-menu from the main
  1323.    program menu. It provides a sub-menu which has three options on it
  1324.    which operate in the following manner:
  1325.  
  1326.      Surfaces - Clears all the defined surfaces
  1327.      Objects  - Deletes all the objects and groups in a scene
  1328.      All      - Does both of the above
  1329.  
  1330.    NB: There is no "are you sure?" message to these options, so be
  1331.        careful.
  1332.  
  1333.  
  1334.    Fractals
  1335.  
  1336.    Sometimes, it is desirable to create objects which are not uniform,
  1337.    like when we are trying to imitate nature. (mountains, rocks, etc.)
  1338.  
  1339.    !Ray3d-Pro allows you to take a triangle, and randomly break it up
  1340.    into  number of smaller triangles each of which ‘sticks out’ from the
  1341.    original. (this option only works on Triangles.)
  1342.  
  1343.    To fractalise a triangle, select it in the normal manner, and then
  1344.    move over the ‘Fractal’ option from the ‘Select’ sub-menu on the main
  1345.    program menu.
  1346.  
  1347.    On the window that appears, you may set the number of triangles that
  1348.    !Ray3d-Pro will split each selected triangle into, and the roughness
  1349.    of he resulting shape. The roughness value may range from 0 to 9.
  1350.  
  1351.  
  1352.    Mirror
  1353.  
  1354.    To mirror the selected objects about an axis, first select the objects
  1355.    that you wish to mirror. Next move the mouse over the mirror option
  1356.    on the "select" sub-menu from the main program menu.
  1357.  
  1358.    This brings up a window listing all the possible ways that objects can
  1359.    be mirrored. Simply select the direction to mirror, and click on the
  1360.    OK icon.
  1361.  
  1362.  
  1363.    The Toolbox
  1364.  
  1365.    3d Preview                        
  1366.  
  1367.    Choosing this option by clicking on the icon in the toolbox will
  1368.    present you with a wireframe perspective view of what the scene
  1369.    will look like when it is raytraced.
  1370.  
  1371.    The  window allows you to alter the way in which
  1372.    the preview works. using one of the options it is possible to get
  1373.    !Ray3d-Pro to only preview selected objects, while another causes
  1374.    the outline of each objects to be drawn in the colour it will appear
  1375.    when raytraced.
  1376.  
  1377.    Note: The colour chosen is the nearest one in the current mode. I
  1378.          advise changing into a 256 colour mode (or higher if you're
  1379.          lucky enough to have a Risc PC).
  1380.  
  1381.    The 3d view saves a great deal of time because it is no longer
  1382.    necessary to spend hours raytracing a scene, only to find you haven’t
  1383.    selected a very good view, or an item of interest is obscured by
  1384.    another object.
  1385.  
  1386.    The 3d preview does not show CSG shapes as they will appear in the
  1387.    raytrace. It will just display the objects that make up the CSG shape.
  1388.  
  1389.  
  1390.    Converting curved shapes to polygons
  1391.  
  1392.    Sometimes you may wish to break curved shape such as a cone down
  1393.    into polygons so that you can get a faceted appearance. For instance
  1394.    you may be creating a glass which appears faceted instead of smooth.
  1395.  
  1396.    The following shapes can be broken down into polygons:
  1397.  
  1398.      * Spheres
  1399.      * Cones
  1400.      * Cylinders
  1401.  
  1402.    To break a selected object down into polygons, click on the
  1403.    scale icon in the toolbox, and enter a scale value of 100%       
  1404.    for all three directions. Ensure that the "convert to polygons"
  1405.    option is on and click on OK.
  1406.  
  1407.  
  1408.    Set point
  1409.  
  1410.    This icon can be used as an alternative to clicking ADJUST while
  1411.    creating objects. When this icon is clicked on, it sets fixes the
  1412.    current point for operations such as creating objects, moving and
  1413.    rotating.
  1414.  
  1415.  
  1416.    Notes for !Ray3d v1.xx users
  1417.  
  1418.    For those of you that have been using versions of !Ray3d which have
  1419.    been supplied by Archimedes World on their cover discs (versions
  1420.    1.xx) there is a supplied tool called !v1->v2 which will convert
  1421.    your scene files to !Ray3d-Pro files.
  1422.  
  1423.    For more information on this tool, see the relevant help file.
  1424.  
  1425.  
  1426.    Using Textures                    
  1427.  
  1428.    To apply a texture to an object, first bring up the  window
  1429.    by clicking on the link icon, or selecting "link..." from the "World"
  1430.    sub-menu on the main program menu.
  1431.  
  1432.    Now select the object (or group of objects) that you wish to apply
  1433.    the texture to by clicking on it. On the right hand side of the
  1434.    screen in the "texture" box you will see what the current texture is.
  1435.  
  1436.    To change the texture, click on the menu icon to the right of the
  1437.    texture option and a short menu will be displayed showing all the
  1438.    available textures. Simply select a texture from this menu.
  1439.  
  1440.    Some textures have a type field which can be anything from 1 to 4.
  1441.    This allows you to select different types of that texture, eg: four
  1442.    different woods, four marbles, etc.
  1443.  
  1444.    All of the textures can be scaled by altering the "scale" field.
  1445.    Thus you could choose a small wood grain, or a huge one.
  1446.  
  1447.    None
  1448.  
  1449.    When this icon is selected, no texture will be applied to the
  1450.    object, which will appear the colour specified by the main surface
  1451.    associated with it. This is the default.
  1452.  
  1453.    Wood
  1454.  
  1455.    Selecting this icon will cause a wood like texture to be applied to
  1456.    the object. The colour of the texture is set by the colour of the
  1457.    main surface associated with the object.
  1458.  
  1459.    Marble
  1460.  
  1461.    Selecting this icon will cause a marble like texture to be applied to
  1462.    the object. The colour of the marble is set by the colour of the
  1463.    main surface associated with the object.
  1464.  
  1465.    Checkered
  1466.  
  1467.    This texture will cause the object to become checkered, with the two
  1468.    surfaces associated with the object controlling the appearance of
  1469.    each square. The size of each square may be set by altering the scale.
  1470.  
  1471.    Blotch
  1472.  
  1473.    This texture will give a blotchy effect where the two surfaces appear
  1474.    to fade between each other randomly. The mix % controls how much the
  1475.    main Surface  dominates the secondary surface. For example, a value of
  1476.    50% means a 50/50 mix, anything less means that there is more of the
  1477.    main surface.
  1478.  
  1479.    Bump Map
  1480.  
  1481.    This applies a random bump map to the object selected. The value it
  1482.    takes controls how large the bumps should be.
  1483.  
  1484.    Gloss
  1485.  
  1486.    This texture makes a mirrored object glossy. A value of 0% gives perfect
  1487.    mirror like reflections, while 100% gives fuzzy reflections.
  1488.  
  1489.    fbm
  1490.  
  1491.    fbm stands for fractional brownian motion and causes the object to
  1492.    become lighter and darker in a similar way to the blotch function
  1493.    but without creating a second surface. The extra value controls how
  1494.    much darker or lighter the blotches appear.
  1495.  
  1496.  
  1497.    Simple Script Language
  1498.  
  1499.    For all of you out there who would like to be able to write BASIC
  1500.    or C programs which generate shapes (such as fractal trees) which
  1501.    could be loaded into Ray3d-Pro there is a simple script language.
  1502.  
  1503.    At the moment, only three object types are supported, but if there
  1504.    is enough interest I will implement more.
  1505.  
  1506.    Scripts are simply text files which the user drops onto a Ray3d-Pro
  1507.    window to merge the contents of the script with the current scene.
  1508.  
  1509.    The script files have there own specific language, which has it's
  1510.    own rules, listed below.
  1511.  
  1512.    The language
  1513.  
  1514.    The script file MUST have the word '!Ray3d-Pro' on the first line
  1515.    or Ray3d-Pro will not recognise it as a script file.
  1516.  
  1517.    Any line beginning with a # are considered comments and are ignored.
  1518.  
  1519.    The file has two distinct sections, a DELARE section and a CODE
  1520.    section, and the script is terminated by an ENDCODE statement, so
  1521.    a script file looks like this...
  1522.  
  1523.    # !Ray3d-Pro
  1524.    DECLARE
  1525.      ...
  1526.    CODE
  1527.      ...
  1528.    ENDCODE
  1529.  
  1530.    The DECLARE section
  1531.  
  1532.    Within the DECLARE section there must be two commands, min and max
  1533.    which are followed by a colon (:) and a value. These values represent
  1534.    the maximum and minimum size of the objects you are describing and
  1535.    therefore no objects should reference points outside this range.
  1536.  
  1537.      min : <n>
  1538.      max : <n>
  1539.  
  1540.    So now a script file looks like... (for example)
  1541.  
  1542.     # !Ray3d-Pro
  1543.     DECLARE
  1544.       min : -1000
  1545.       max :  5000
  1546.     CODE
  1547.       ...
  1548.     ENDCODE
  1549.  
  1550.    The CODE section
  1551.  
  1552.    This is where you define the objects that you want to create.
  1553.    You may specify a name for the object if you wish ( in quotes)
  1554.    but it is not compulsory.
  1555.  
  1556.    The commands for creating objects are:
  1557.  
  1558.      sphere   "name" ( x y z radius )
  1559.      triangle "name" ( x1 y1 z1 x2 y2 z2 x3 y3 z3 )
  1560.      polygon  "name" ( n x1 y1 z1 .. .. .. xn yn zn )
  1561.  
  1562.    NB: you do not need to specify the "name" if you don't want to.
  1563.  
  1564.    Note: the values placed between the brackets may be split over
  1565.    new lines to make the code more readable. This is OK so long as
  1566.    each value is separated by a space or a new line.
  1567.  
  1568.    You may also create groups by the use of a GROUP command which
  1569.    takes the form:
  1570.  
  1571.      GROUP "name"
  1572.      ENDGROUP
  1573.  
  1574.    Any objects (or other groups) that are defined between the GROUP
  1575.    and ENDGROUP statement are created within the group. In this manner
  1576.    you can nest groups, placing objects in each group as required.
  1577.  
  1578.    So now an example script looks like...
  1579.  
  1580.     # !Ray3d-Pro
  1581.     DECLARE
  1582.       min : -1000
  1583.       max :  5000
  1584.     CODE
  1585.       GROUP "shapes"
  1586.         triangle "tri_1" ( 100 100 0 200 100 0 150 2000 0 )
  1587.         triangle "tri_2" ( 100 100 0
  1588.                            200 100 0
  1589.                            150   0 0 )
  1590.       ENDGROUP
  1591.     ENDCODE
  1592.  
  1593.  
  1594.    Importers and tools
  1595.  
  1596.    There are a number of applications provided with !Ray3d-Pro (some
  1597.    of which are not present in the demo version) which provide extra
  1598.    features.
  1599.  
  1600.    Importing 3d files from other sources
  1601.  
  1602.    For importing 3 dimensional scenes from other sources, there are the
  1603.    following applications:
  1604.  
  1605.       !Imp_3ds    - This will take a text file created using 3D Studio
  1606.                     on the PC, and load it into !Ray3d-Pro. Such files
  1607.                     are comprised of a number of lines, each of which
  1608.                     has 9 numbers on them.
  1609.  
  1610.       !Imp_tpoly  - This will take files in the 'tpoly' format, and
  1611.                     load them into !Ray3d-Pro. These files describe
  1612.                     models in polygons.
  1613.  
  1614.    These tools are only available to registered users.
  1615.  
  1616.    Importing text and !Draw files
  1617.  
  1618.    Another tool exists which allows you to draw a shape using !Draw, and
  1619.    import it into Ray3d-Pro as a three dimensional shape. This tools can
  1620.    also handle text if it has been converted to a path from within !Draw.
  1621.    This application is only available to registered users.
  1622.  
  1623.    Importing 3d scenes files from !Ray3d v1.xx
  1624.  
  1625.    For those of you that have been using versions of !Ray3d which have
  1626.    been supplied by Archimedes World on their cover discs (versions
  1627.    1.xx) there is a supplied tool called !v1->v2 which will convert
  1628.    your scene files to !Ray3d-Pro files.
  1629.  
  1630.  
  1631.    Constructive Solid Geometry (CSG)
  1632.  
  1633.    Constructive solid geometry allows use to take simple shapes such
  1634.    as cones, cylinders, boxes, etc. and combine them in such a way
  1635.    as to make much more complex shapes.
  1636.  
  1637.    There are three ways in which shapes can be combined, all described
  1638.    below. For information about how to create a CSG shape, click .
  1639.  
  1640.    Difference
  1641.  
  1642.    This is by far the most useful of the three CSG type. It allows you
  1643.    to remove (ie: drill) one shape from another. So if we had a cuboid
  1644.    as in the diagram below, and subtracted a cylinder we would get a box
  1645.    with a hole in the middle (as shown below).
  1646.             
  1647.  
  1648.    Union
  1649.  
  1650.    This CSG operation merges two shapes together as in the diagram below.
  1651.  
  1652.    Intersection
  1653.  
  1654.    This CSG operation creates a new shape where the first and second shapes
  1655.    overlap. So a cuboid intersected with a cylinder creates a small cylinder
  1656.    as below.
  1657.  
  1658.    Rendering Scenes
  1659.  
  1660.    Once you have created your scene, you will obviously want to raytrace
  1661.    it. To do this, you must run your saved Ray3d-Pro file through another
  1662.    program called !Shade4.
  1663.  
  1664.    !Shade4 takes a 3d file and converts it into the textual data that
  1665.    the PD raytracer Rayshade (v4.0.6) understands. For more information
  1666.    on !Shade4 and how to use it, click .
  1667.  
  1668.    A quick guide is to follow the steps below.
  1669.  
  1670.    1) Save your file from Ray3d-Pro
  1671.    2) Load !Shade4 (quitting !Ray3d-Pro if you are low on memory)
  1672.    3) Drag the saved 3d file to the !Shade4 icon on the icon bar.
  1673.    4) Save the text file by dragging the icon to a directory viewer.
  1674.  
  1675.    NB: Do not save over your original 3d file because Ray3d-Pro cannot
  1676.        load the text file for editing at a later date.
  1677.  
  1678.    5) load !Rayshade
  1679.    6) Drag the text file to the !Rayshade icon on the icon bar.
  1680.    7) Start the raytrace.
  1681.  
  1682.  
  1683.   Adding Fog to a scene
  1684.  
  1685.    Ray3d-Pro allows you to add fog to your scene, to help create a better
  1686.    atmosphere for your pictures. You can create fog as thick as your
  1687.    require, and of any colour.
  1688.  
  1689.    To add fog, select the "fog..." option from the world sub-menu on the
  1690.    main program menu. This will bring up a window very similar to that
  1691.    used for changing the background colour.
  1692.  
  1693.    To change the colour of the fog, either drag the colour bars, or enter
  1694.    the amount of red, green and blue in the percentage fields. The nearest
  1695.    colour in the current mode to the one you have chosen is displayed
  1696.    below.
  1697.  
  1698.    To alter the thickness of the fog, alter the "fog thickness" percentage
  1699.    field below the colour bars.
  1700.  
  1701.  
  1702.    Selecting objects using a view window
  1703.  
  1704.    It is possible to select objects in the world without clicking on
  1705.    their names in the object list, but by clicking on them in the
  1706.    view window while holding down SHIFT.
  1707.  
  1708.    Because each view window only represents two of the three dimensions
  1709.    in the Ray3d-Pro world, the third co-ordinate is taken from the
  1710.    current cursor position.
  1711.  
  1712.    When you click in the window with SHIFT held down, you are
  1713.    specifying a point in the world, and all objects within the current
  1714.    select distance (from the  window) from this point will be
  1715.    selected.
  1716.  
  1717.  
  1718.    Creating CSG objects              
  1719.  
  1720.    It is quite a simple task to create a CSG object, but there are a
  1721.    few rules that have to be observed.
  1722.  
  1723.    All the objects that make up the CSG shape must be contained within
  1724.    their own group. There must not be any other objects in this group.
  1725.  
  1726.    If you were trying to create the bowl shape shown below, you would
  1727.    ceeate it by taking a sphere, chopping off the top with a box, and
  1728.    then cutting the inside away by using a slightly smaller sphere.
  1729.  
  1730.  
  1731.    The group structure would look like this:
  1732.  
  1733.  
  1734.                          Bowl (CSG group)
  1735.                              |
  1736.            -------------------------------------------
  1737.            |                 |                       |
  1738.          big sphere         box                little sphere
  1739.         (key object)
  1740.  
  1741.  
  1742.    The key objects specifies which object you want to subtract the others
  1743.    away from (in the case of the difference operator).
  1744.  
  1745.    To form the CSG shape, you would create the objects and group them
  1746.    as shown above. Now you would click on the CSG icon in the toolbox,
  1747.    or choose "CSG" from the world sub-menu on the main program menu.
  1748.  
  1749.    This brings up a window with two lists. The list on the left indicates
  1750.    which group you want to make a CSG shape. The list on the right lists
  1751.    the objects in that group, and is used to select the key object.
  1752.  
  1753.    So to create the bowl above, you would click on the "bowl" group in
  1754.    the left hand window, and then select the "big sphere" as the key
  1755.    object in the right window.
  1756.  
  1757.    Now because we want to do a difference, click on the difference
  1758.    operator at the foot of the window. You have now created your shape.
  1759.  
  1760.    Nesting CSG shapes
  1761.  
  1762.    If you want to nest CSG shapes then each CSG shape must have it's own
  1763.    group (one would be within the other).
  1764.  
  1765.    eg: If you wanted to create a crescent shape by subtracting a cylinder
  1766.        from another cylinder, and then wanted to remove this crescent
  1767.        from another shape you would need two groups.
  1768.  
  1769.        One group would contain the shape, and also within that group
  1770.        would be a second group containing the cylinders.
  1771.  
  1772.    so, the group structure would look like.
  1773.  
  1774.                                 Cut-away (CSG group)
  1775.                                   |
  1776.                           --------------------
  1777.                           |                  |
  1778.                        Sphere             crescent (CSG group)
  1779.                                              |
  1780.                                      -------------------
  1781.                                      |                 |
  1782.                                  cylinder 1        cylinder 2
  1783.  
  1784.  
  1785.