Welcome to Scene3DX

Scene3DX will convert any Sculpt3D object or scene file to an
X-Specs 3D, 32 color scene using polygon shading techniques.
Scene3DX is run from the CLI with the command:

   Run Scene3DX <Input Scuplt3D Scene file> [<Output ILBM file>]

In order for Scene3DX to run, a copy of xspecs.library (ver 1.2)
must be placed in the libs directory of your boot disk.  Once the
program is running, the ten function keys are used to control
orientation and rendering of the object or scene.  A summary of
the function key commands is given below.

F1:   F1 starts a 3D line drawing of the object or scene.

F2:   F2 starts fast polygon rendering of the object or scene. 
      Fast polygon rendering uses the blitter to quickly draw each
      of the shaded polygons (triangular faces) making up the
      object or scene.  The technique is very fast, but because
      entire faces are drawn at once, some overlap of faces may
      obscure small details of the scene.  Also, faces that
      overlap screen boundaries will not be rendered.  Use fast
      polygon rendering for simple objects that do not overlap
      screen boundaries.

F3:   F3 starts scanned polygon rendering of the object or scene.
      Scanned polygon rendering draws the object or scene line by
      line.  Although it is much slower, it produces a much better
      rendering of complex objects or objects that overlap screen
      boundaries.

F4:   Once a rendering is complete, F4 will save an IFF ILBM
      file for future viewing.  These ILBM files can be viewed
      using IFF viewer programs which are able to process an
      interlaced 352 X 480 low resolution overscanned image.  The
      only additional requirement is that the program "flipglas"
      be running concurrently in order to switch the X-Specs 3D
      lenses.  From the CLI type "run flipglas."  Then use your
      IFF viewer program to view the three dimensional scene. Note
      that you cannot save an ILBM file if you did not specify an
      output filename when starting Scene3DX from the CLI.

F5:   F5 (and F10) will interrupt a rendering in process and
      return you to a line drawing of the object.  These interrupt
      requests may take several seconds to operate depending on
      the size of the object or scene.  Be patient.

F6:   The initial orientation or placement of the object or scene
      may require adjustment.  F6 allows you to choose to either 
      rotate or to shift the position of the object or scene.
      If you can visualize a coordinate system with the X
      axis being left and right, the Y axis being up and down,
      and the Z axis being in and out of the screen, these
      movements are easily understood.  Typing F6 alternately
      chooses "Rotate" or "Shift" which allows the numerical keypad
      to be used as follows:

   ROTATE:   Keys 2 and 8 cause rotation about X axis
             Keys 4 and 6 cause rotation about Y axis
             Keys 3 and 9 cause rotation about Z axis

   SHIFT:    Keys 4 and 6 cause shift along X axis
             Keys 3 and 9 cause shift along Y axis
             Keys 2 and 8 cause shift along Z axis 

             Repeated use of the "2" key in Shift mode will bring
             the object out of the monitor and into the space
             in front of the monitor.


F7:   F7 reduces the size of the object or scene by shrinking it
      about it's geometric center.

F8:   F8 expands the size of the object or scene about it's 
      geometric center.

F9:   Once rendering has begun, F9 can be used to push Scene3DX
      into the background via multitasking.  You can then use the
      Amiga for other tasks concurrently.  CAUTION.  Once you have
      pushed Scene3DX into the background, you cannot communicate
      with Scene3DX until rendering is complete.  At that time,
      Scene3DX will return.  If your concurrent program uses 
      excessive memory, Scene3DX will not be able to return and
      your rendering will be lost.

F10:  F10 (and F5) will interrupt a rendering in process and
      return you to a line drawing of the object.  These interrupt
      requests may take several seconds to operate depending on
      the size of the object or scene.  Be patient.


ESC:  The escape Key terminates the program.  Escape will not interrupt
      rendering in process.  Use F5 or F10.


LIMITATIONS:

The following simplifications have been made regarding Sculpt 3D
objects or scenes.  Background (sky) must be a solid color.  All
lamps are assumed to be white light.  The Sculpt3D automatic
ground plane is not recognized. You can, however draw your own
ground plane as a part of the scene.