This CD contains code samples and demos which have not been thoroughly
tested or reviewed, but which may still be of value to ScriptX
developers. Some known restrictions and problems will be noted in the
"readme.txt" files found in individual directories, but more may be
lurking. ENJOY AT YOUR OWN RISK!

This directory contains ScriptX binaries and source code for
Dreamscape, a large, extendable ScriptX design example.

Dreamscape can be thought of as an open-ended platform for plugging
together dynamically loaded interactive multimedia objects. It includes
a map editor for connecting rooms, a gestural throwing interface for
navigation by avatar, a stimulus-and-response utility, a time-based
score, and many objects to play with and plug together like Legos.

Documentation is included in HTML format in the "about" directory.
Begin by loading the the "index.htm" file into your preferred Web
browser.

Note that this is a "technology demonstration" rather than
product-quality code!
        
To run Dreamscape:

    1) Make sure the latest versions of ScriptX and the KMP are installed.
    (There are new versions of both executables on this CD-ROM.) Make
    sure they are given enough memory to run Dreamscape. (See "Known
    Problems" below.)
    
    2) Create a "dream" directory on a local hard disk.
    
    3) Copy dream.sxt, dreamimp.sxl, dream.sxl, and the "products"
    and "rooms" directories to your new "dream" directory.
    
    4) Read the Dreamscape documentation, particularly the notes
    on "how to run Dreamscape". Many surprises await you, though!
    A few extra hints: Clicking on an object usually toggles its
    standard action. To plug objects together, their registration
    points must meet; when they do, you'll hear a clicking sound.

    5) Run dream.sxt using the latest version of the KMP.

Source code and media may be found in the "source" directory.

KNOWN PROBLEMS:
    - As is, will only build on Macintosh systems, since the PICT
    importer is used, and the Windows PICT importer is not supported.
    - Large memory footprint, dependent on number of products and rooms
    plugged in at runtime. With the default products and rooms, 16 MB
    of memory is recommended for the KMP.
    - The code has not been redesigned to take advantage of V1.5
    features.
    - Note that this is ScriptX V1.5 code, and will not build on V1.0.
    
See the "goodies" directory for some Macintosh-only Dreamscape add-ons.