                       Cyberware Color 3D Digitizer

  Demonstration Software for the Silicon Graphics 4D Series Workstations

                                3 May 1991


This tape contains an assortment of programs and images which you can use
to evaluate the Cyberware Color 3D Digitizer.

1.  Load the tape.

    If you have a cartridge tape drive on the local system:

        tar xvo

    A directory named 'cyberware_demo' will be created. About 10 Megabytes
    will be required to load the entire tape.

    If the cartridge tape drive is on another Iris try the following
    command or contact your system manager.  Replace the word 'host' with
    the hostname of the workstation that has a drive.

        tar xvof host:/dev/tape

2.  The simplest demo is performed as follows:

        cd cyberware_demo/easy        (or as required)
        demo

    The windows may be individually terminated with the menu obtained when
    the right mouse button is depressed while in the window.

3.  Other images are in the directory cyberware_demo/images.  They may be
    viewed with the 'ipaste' command available on most SGI systems.

        cd cyberware_demo/images        (or as required)
        ipaste steve_closeup
        ipaste heidi
        (et cetra)

4.  The most powerful demo is accomplished with the program 'cyberware' and
    the digitizer image files in the directory 'data'.

    Your workstation must have RGB Bit-planes and Z-buffer for proper
    operation of this demo.  More than the standard 8 Megabytes of memory
    will greatly speed the demo.

        cd cyberware_demo        (or as required)
        cyberware

        Cyberware Color 3d Digitizer - Demonstration Software

        Cyberware> _

    Various commands may be typed at the prompt.  The command 'help' will
    display a list of the available commands.  The commands fetch, display
    and exit are the most used.  Read in an image file with the fetch
    command.  For example:

        Cyberware> fetch heidi

    Where 'heide' could be the name of any file in the data directory.  The
    file will be read for the image header information and surface data.  
    The 'display' command will display the image.

        Cyberware> display

    The 'Help' window will be displayed.  The program then computes the
    surface normals for the lighting computations.  A 4D with less than 12
    megabytes of RAM may require more than 1 minute for this computation.

    Cyberware then displays the data in both wireframe and smooth shaded
    form. Both the 'Wireframe' and 'Render' windows have pop-up menus.  The
    menu is displayed with the RIGHT MOUSE BUTTON.  A selection is made
    when the button is released.

    We use 'walking menus'.  When a menu item has an arrow, push the mouse
    to the item and then right.  A second menu will appear.  Select from
    this menu by the same method.

    If the image has color information (some do and some do not), the
    natural surface will initially be displayed; otherwise, a lighting
    model will be used.  In either case, you can use the "Surface Material"
    and "Texture Map Functions" menus in a variety of combinations to
    change the lighting and color representation of the image.

    TRANSFORMATIONS:

    The transformation selections operate by selecting them from the menu
    and then moving the mouse about.  The LEFT MOUSE BUTTON will terminate
    the particular transformation and allow another selection to be made.

    It is quickest to do your transforms in the wireframe window, then
    redraw the shaded view.

    HELP:

    Watch the 'Help' window for clues as to what the program is expecting
    from you at any particular time.

    The standard GT 4Sight technique of holding the CTRL or ALT key during
    mouse movements will lend some sanity to mouse movements that cause the
    cursor to leave the window.

    Experimentation is best.  We could explain it all here with several
    thousand words, but you might as well go ahead and experiment until we
    write them...

    Complete documentation is online.  At the Cyberware> prompt type 'man
    man' or 'man display'.  The command 'help' will display a list of all
    commands available in this version.  The documentation covers all
    versions, and will search for keywords (e.g. try 'man mill').  Actually
	the documentation isn't 100% complete.

	STEREO DISPLAY:

	If you have the stereo option StereoView or CrystalEyes you can put
	this demo in stereo mode.  At the Cyberware> prompt type:

		Cyberware> stereo

	This sets some parameters in the software by reading the file
	source/stereo.  When you then use the display option the monitor will
	switch to stereo mode.  Only one window will be displayed at any one
	time.  To switch between the wireframe and render windows use the
	menu selections provided.

	The Meter feature does not work properly in stereo mode.  The
	Perspective control works, but not is properly designed for stereo.
	There is no way to return the demo to non-stereo mode except to
	exit the demo and restart it.

	You may want to put the Render Window into Doublebuffer mode.  The
	Oscillate selection on the Render Window Transform menu is interesting
	on the faster workstations (GT...VGX).

5.  The directory 'convert' contains some conversion utilities which will
    convert the cyberware range maps into other industry-popular formats.
    See the README file in that directory for further information.

6.  If we have sent you special data it will be in a directory named
    'custom', 'siggraph' or another name specific to your tape.

    Use the Unix command 'file' to determine what type of file has been
    provided.  The response of 'file *' will indicate:

        data         A Cyberware file, use the program 'cyberware'.
        SGI...       A SGI imagelib image, use 'ipaste'.
        ascii text   Probably a Cyberware file converted to some other
                     format.
        directory    Another directory level, use 'cd' and 'file' again.

    Color Cyberware images will have two files.  One contains the geometry
    and the other contains the color or texture map.  This file will have
    the extension .color.  The color files are in standard Silicon Graphics
    RGB format.  Try the command 'ipaste heidi.color' for an example.  
    Support for this format is found on most workstations in the directory
    named /usr/people/4Dgifts/iristools/imgtools.

If you have any questions or would like to be talked through any part
of this demo please call us at Cyberware for assistance.

Related Products:

4020 Rapid 3D Digitizer
4020 Color 3D Digitizer
3030 Rapid 3D Digitizer
3030 Color 3D Digitizer
BK Digitizer
HAND Digitizer
PS & MS Motion Platforms
Echo Digitizing Software
Echo Machining Software
Echo Portrait Sculpture
Plexus Software

Contact your local representative or:

Cyberware Laboratory Inc.
8 Harris Court #3D
Monterey, California 93940

Phone:  (408) 373-1441 8am-5pm Pacific Time
Fax:    (408) 373-3582
E-Mail: dabro@cs.nps.navy.mil
