===========================================================================
IMPORTANT:

Please add the current directory to the 'auto_path' variable before running
the demos.  you will need to be in this directory to run some of the demos
(smscene, smtexture, smvrml) that look for data files (texture and VRML files)
in the current directory.

To run the demos, just type the name of the the demo (smviewport, smcanvas,
etc.) at the smsh prompt.

If you're relatively new to Tcl/Tk, the following command sequence should
get you started:

>cd demos				# set current directory to demos/
>../src/smsh				# start smsh
%lappend auto_path [pwd]		# append current directory to auto_path
%<name of the demo>			# run demo


===========================================================================

In this directory you will find the following demos:

- smviewport
  This demo populates a cell with the primitive model types (sphere, cone,
  disk, polygon, line, and point) and attaches a viewport widget to it. Users
  can navigate in this cell with the mouse. <Control> and <Shift> keys
  select between different navigational modes.

- smcanvas
  This demo populates a cell with the primitive model types (sphere, cone,
  disk, polygon, line, and point) and attaches a canvas viewport item to it.
  A label widget is created for each model type and is placed beneath it on
  the same canvas.

- smscene
  This demo generates a simple scene containing a few geometric objects. It
  demonstrates the creation of texture maps from images and their use.
  Users can navigate in this cell with the mouse. <Control> and <Shift> keys
  select between different navigational modes.

- smtexture
  This demo displays a texture-mapped cube that the user may manipuate with
  the mouse button.  It also demonstrates how textures may be created either
  from images or from pixel data supplied on the command line.

- smvrml
  This demo renders the scene described by a VRML file (demo.wrl). Users can
  navigate in this scene with the mouse. <Control> and <Shift> keys select
  between different navigational modes.

  NOTE: The demo VRML file (an office) came courtesy of the folks at the IICM
	and is one of the example files for the VRweb VRML browser
	(http://hyperg.iicm.tu-graz.ac.at/vrweb). You can find more sample VRML
	scenes created at the IICM at:

		http://hyperg.iicm.tu-graz.ac.at/vrweb.examples.
