Basic Instructions for SMVR (Simple Minded Virtual Reality)
by Oguz Yetkin (oyetkin@yahoo.com)

These commands can be issued from the smvr> prompt either by you         
or by your program.  The return value (i.e., what's printed by SMVR) will either
 be                                                                             

+OK <commandname> ...

or 
-ERR <commandname> ...

 
Using these, you can synchronize your program.

Note that by issuing a bunch of display programs, you can 
animate your objects.  (A more sophisticated approach is using
3-4 versions of the same object posed differently, and using
display and undisplay to switch between these.)     

<br>
1) Initialization State
   
  
      
   >init 
  
   >load <objectname> <filename>
   
   [load can be repeated as many times as necessary.  Currently, you will
   be limited to objects you load at this time.  ]

   Loads an object from a wavefront .obj file
   load will overwrite previous definition if it exists.

   >endinit

   2) Display State 
  
    >locate <objectname> <x> <y> <z>
    
    >display <objectname> #defaults to origin 
    >display <objectname> <x> <y> <z> 
    >display <objectname> <x> <y> <z> <sx> <sy> <sz> <ro> <theta> <phi> 
    >display <objectname> <x> <y> <z> <sx> <sy> <sz> <ro> <theta> <phi> <r> <g> <b>
 
   where <objectname> is the string assigned to the object
   in block 2, and <x> <y> <z> are coordinates of the object
   In the cave, x E [-5,5] y E [0,10] z E [-5,5].  Positive z is
   towards the user, x is horizontal, and y is vertical

   >undisplay <objectname> 

   Stops objectname from being displayed.  Nothing happens
   if object has not been displayed. In SMVR, all objects 
   are unique.  It is also the users responsibility to 
   keep track of locations (display by itself is not defined)

   >color <objectname> <r> <g> <b>

   causes <objectname> to have the colors specified by the
   r,g,b pairs when displayed.  r, g, and b are floats between
   [0,1]

   >write <filename>

   writes a script file that includes the commands to generate
   the current scene.  By default, the current scene is saved
   under session.smvr.  Note that the WaveFront .obj 
   files used to create the scene must still be present 

--the following features may be unsupported as of current release

   >move <objectname> <x2> <y2> <z2>  (unsupported)
   >move <objectname> <x1> <y1> <z1> <x2> <y2> <z2> (unsupported)

   Displays an animated <objectname> moving from x1,y1,z1
   to x2,y2, z2.  This feature might not be implemented yet

   >scale <objectname> <sx> <sy> <sz>

   objects are initially scaled to 1 by 1 by 1
   this scales/distorts the x,y,z dimensions

   >rotate <objectname> <ro> <theta> <phi>

   Rotates object ro degrees around x, theta degrees around y, and phi degrees around z.  Must have all 3 arguments.
<p>

More to come.  keep bugging me about this.