home *** CD-ROM | disk | FTP | other *** search
/ PC World Komputer 1995 November / PCWK1195.iso / inne / win / sieciowe / oiv_demo.lzh / disk1 / DATA.1 / README.TXT < prev   
Text File  |  1995-08-05  |  12KB  |  249 lines
  1. README for Open Inventor and WebSpace Demos
  2. -------------------------------------------
  3.  
  4.     Updated 4-Aug-95
  5.     Copyright (C) Template Graphics Software Inc.
  6.  
  7.  
  8. Requirements
  9.  
  10.     These demos will run under Windows NT or Windows 95 (Intel only).
  11.     All the necessary DLLs are provided with the demo installation.
  12.  
  13.     Using the standard Microsoft OpenGL, all screen resolutions and color
  14.     depths are supported.  Resolution of 1024x768 or higher and color
  15.     depth of 256 or higher is recommended for best appearance.
  16.  
  17.     All 3D accelerator boards compatible with Microsoft OpenGL are
  18.     supported, including boards based on GLint, Oki and AccelGraphics.
  19.  
  20.  
  21. OpenGL DLLs for Windows 95
  22.  
  23.     NOTE: The TGS System directory contains the files opengl32.dll and
  24.     and glu32.dll.  These are the OpenGL DLLs for Windows 95 (Intel only).
  25.     The TGS System directory is located under the directory you selected
  26.     during installation of the Open Inventor Demonstration.
  27.     
  28.     DO NOT copy these files into the system32 directory under Windows NT!
  29.     If you have installed a version of OpenGL under Windows 95 and experience
  30.     problems running the Open Inventor Demonstration, try replacing the
  31.     OpenGL DLLs in your Windows 95 System directory with the OpenGL DLLs in
  32.     the TGS System directory.
  33.  
  34.  
  35. SceneViewer, Slotcar, and Maze Demonstration Programs
  36.  
  37.     The SceneViewer program demonstrates some of the capabilities of the Open
  38.     Inventor class library.  The various viewers, the material and color
  39.     editor dialogs, direct manipulation of scene objects and many other
  40.     features available in SceneViewer are built-in capabilities of the Open
  41.     Inventor class library.  This allows rapid prototyping of applications
  42.     based on Open Inventor -- if you can describe your application's geometry
  43.     in Open Inventor terms, you automatically have the ability to view and
  44.     edit that geomtry.  Here are some suggestions for running the demo:
  45.     
  46.         - Use the File/Open menu to open one or more of the example models
  47.           provided in Inventor format.  These files have a ".iv" extension.
  48.           You can also use "drag and drop" to open Inventor files.
  49.           
  50.           Sceneviewer can also load most VRML (Virtual Reality Modeling
  51.           Language) files, although it does not support the WWWInline, LOD
  52.           or AsciiText nodes.  These files have a ".wrl" extension.  WebSpace
  53.           is a VRML specific viewer that supports all the VRML 1.0 nodes.
  54.           
  55.         - The default mode is "Examiner Viewer".  Hold down the left mouse
  56.           button to spin the model using the "virtual trackball".  Hold
  57.           down the middle mouse button to translate the model.
  58.  
  59.         - Use the View menu to change to a "Walk Viewer" or "Fly Viewer".
  60.           In the Walk Viewer, hold down the left mouse button and move the
  61.           mouse to "walk" forward or backward and to turn.
  62.  
  63.           In the Fly Viewer, click the left mouse button to accelerate and
  64.           the middle mouse button to slow down.  Current speed is displayed
  65.           by a bar graph at the bottom of the window.  Move the mouse to
  66.           change your direction of travel.
  67.  
  68.         - Use the Light menu to create a new light in the scene.  A 3D icon
  69.           will appear indicating the light's position (and direction if
  70.           appropriate).  Put the cursor on the light icon, then press and
  71.           hold the left mouse button to move the light.  For directional and
  72.           spot lights you can also interactively change the direction by
  73.           moving the light icon's arrowhead.
  74.  
  75.         - Press the ESC key to toggle between "viewing" (the default) and
  76.           "selection" modes.  In viewing mode the cursor is a red hand.  In
  77.           selection mode the cursor is an arrow.  In selection mode you can
  78.           select any object in the scene by clicking on it.  A red highlight
  79.           box will appear around the selected object.
  80.  
  81.         - With an object selected, use the Editors menu to bring up the
  82.           Material Editor dialog or the Color Editor dialog.  Notice that
  83.           Inventor automatically changes the appearance of the selected
  84.           object when you make changes in the dialog box.
  85.  
  86.         - With an object selected, use the Manips menu to attach an Inventor
  87.           "manipulator" to the object.  For example, the Trackball manipulator
  88.           allows you to rotate the selected object (move the cursor onto the
  89.           trackball, then press and hold the left mouse button).
  90.  
  91.     Slotcar is a simple "game" that demonstrates using Open Inventor to create
  92.     a virtual world and simulating the physics of a slotcar race.  When the
  93.     first window appears, click in the rectangle labeled "Start".  When your
  94.     car appears in the race window:
  95.  
  96.         - Click the left and right mouse buttons to change lanes
  97.  
  98.         - Your speed is determined by the position of the mouse cursor in
  99.           the window -- the closer to the top of the window, the faster you
  100.           go.  Watch out for those tight curves!
  101.  
  102.         - Use the arrow keys to adjust the position of the camera relative
  103.           to your slotcar.
  104.  
  105.         - The car will automatically reset (back on the track) after a crash.
  106.  
  107.     Maze is a simple "game" that demonstrates using Open Inventor to create a
  108.     virtual world and directly manipulate an object (the maze board) in 3D.
  109.     Hold down the left mouse button and move the mouse to change the tilt of
  110.     the maze board.  Try to roll the ball to the exit in lower right corner.
  111.  
  112.  
  113. WebSpace
  114.  
  115.     WebSpace is a VRML (Virtual Reality Modeling Language) browser that works
  116.     with your HTML browser (Netscape, Mosaic, etc) to display 3D scenes you
  117.     find on the Internet.  You will need to have an HTML browser installed in
  118.     order to access VRML files on the Internet.  WebSpace uses your HTML
  119.     browser to fetch files.  You do not need an HTML browser if you just use
  120.     WebSpace to view local files.  You will need an HTML browser to display
  121.     the WebSpace help files (which are in HTML format).  You will need to
  122.     configure your HTML browser so it knows to use WebSpace as the viewer for
  123.     files with the MIME type "x-world/x-vrml" (also "application/x-inventor"
  124.     if you want to view Inventor files).  WebSpace can also view Open Inventor
  125.     files and/or VRML files containing Inventor nodes.
  126.  
  127.     Note: A copy of gzip.exe is provided with some versions of the demo
  128.     installation (Intel and ?).  When available, WebSpace uses gzip to
  129.     automatically decompress VRML files that have been compressed (these
  130.     files normally have the extension ".wrl.gz").
  131.  
  132.  
  133. Inventor Wizard
  134.  
  135.     The Inventor Wizard will modify source code generated by the Microsoft
  136.     AppWizard to create a skeleton Open Inventor application.  The Inventor
  137.     Wizard is automatically added to the Visual C++ 2.0 tools menu by the
  138.     setup program (INTEL and ALPHA versions only).  For MIPS it is necessary
  139.     to manually add the    Inventor Wizard to the tools menu.  Also for MIPS, you
  140.     must manually add the Inventor include and lib directories to the lib and
  141.     include directory search paths in Visual C++ 2.0. This is done by selecting
  142.     the Tools/Options menu and clicking on the directories tab.  These are
  143.     updated automatically in the INTEL and ALPHA versions if Visual C++ was
  144.     installed when you ran the TGS Open Inventor Demonstration setup program.
  145.  
  146.     To use the Inventor Wizard create a new project using the AppWizard, 
  147.     and close the project.  NOTE: It is important that you close the project
  148.     before running the Inventor Wizard.  If you modify a project with Inventor
  149.     Wizard while Visual C++ has the project file open, Visual C++ will overwrite
  150.     the changes made by Inventor Wizard.  These problems will be solved when
  151.     we integrate the Inventor Wizard with the AppWizard extensions under 
  152.     Visual C++ 4.0.
  153.  
  154.     This demonstration distribution includes all of the necessary header files
  155.     and import libraries to build the viewers generated by the demonstration
  156.     version    of the Inventor Wizard.  The demonstration version only generates
  157.     code for Render Area, Walk, Fly, and Examiner viewers.  The full TGS Open
  158.     Inventor SDK is required to generate a SceneViewer application.  In addition,
  159.     this demonstration version does not provide the header files and import
  160.     libraries for developing full Open Inventor programs.  The complete TGS Open
  161.     Inventor SDK is required to write code that uses the Open Inventor Class
  162.     Library directly.  Only the TGS Inventor Framework library is provided with
  163.     this demonstration.
  164.  
  165.     NOTE: This version of the demo installation does not include the Open
  166.     Inventor debugging DLLs -- so you cannot build the Debug target for your
  167.     Inventor Wizard generated application.  You must build the Release target.
  168.  
  169.  
  170. SceneViewer OCX (Intel and Alpha only)
  171.  
  172.     The SceneViewer OCX provides an OLE control wrapper for the Open Inventor
  173.     SceneViewer application.  The OCX provides all of the functionality of the
  174.     SceneViewer through a set of OLE interfaces.  It is not necessary to have
  175.     the Open Inventor SDK to develop applications using the SceneViewer OCX,
  176.     only the runtime Open Inventor DLL's are required.
  177.  
  178.     To use the SceneViewer OCX you must first register the control. Click on
  179.     the Register SceneViewer Control icon to register the control.
  180.  
  181.     To experiment with the SceneViewer OCX start the Test Container, then:
  182.  
  183.       1. Select Insert OLE Control from the Edit menu, and pick Ocxsv Control.
  184.  
  185.       2. Resize the control to the desired dimensions.
  186.  
  187.       3. Select Invoke Methods from the Edit menu.
  188.  
  189.       4. From the Name drop box select the LoadFile method and click on Invoke.
  190.  
  191.       5. Use the File Dialog to select an Inventor File (Barcelona.iv is
  192.        a good model for experimenting with the Walk and Fly Viewers, bird.iv
  193.        is good for the Examiner Viewer).
  194.  
  195.       6. From the Name drop box select the showViewDialog method, and click 
  196.        on Invoke.
  197.  
  198.       7. Select the desired viewer and click on Ok.
  199.  
  200.       8. Click on Close to exit the Invoke Control Method Dialog.
  201.  
  202.       9. For the Fly Viewer, click the left mouse button to accelerate, middle mouse
  203.        button to decelerate, and left-middle to stop.
  204.  
  205.        For the Walk Viewer, press and hold the left mouse button while moving
  206.        the mouse in the desired direction of motion.  Use the up and down arrow
  207.        keys to change elevation.
  208.  
  209.        Use the controls of the Fly or Walk viewer to move to a new viewing
  210.        position, the bring up the Invoke Control Methods Dialog. Invoke the
  211.        showNewCameraDialog method.  Click on create, select View All, and
  212.        click on Apply.  Up to ten cameras can be created.  Picking a camera
  213.        from the Camera List will install that camera as the current camera.
  214.  
  215.        For the Examiner Viewer, press and hold the left mouse button to spin the
  216.        camera around the object.  Pressing the right mouse button brings up
  217.        a popup menu that can be used to toggle viewing mode.  Turn off viewing
  218.        mode, place the mouse pointer over a piece of the model (i.e. the head
  219.        of the bird) and click the left mouse button.  A bounding box will 
  220.        appear around the selected component.  Bring up the Invoke Control Methods 
  221.        dialog, invoke the manipTrackball method and close the dialog.  Grab
  222.        the trackball with the mouse pointer by pressing and holding the left 
  223.        mouse button.
  224.  
  225.        For a detailed description of the viewer controls see the Open Inventor 
  226.        Help File.
  227.        
  228.    10. Invoke the lightAddDirect method to create a directional light.  Turn 
  229.        of viewing mode and grab the light icon arrow head with the mouse.  
  230.        Use the mouse to change the direction of the light.  Invoke the 
  231.        lightHideAll method to hide the light icon.
  232.  
  233.  
  234.  
  235. To contact TGS about purchasing the Open Inventor SDK:
  236.  
  237.     Template Graphics Software Inc.
  238.     9920 Pacific Heights Blvd
  239.     San Diego, CA  92121
  240.  
  241.     Tel: 619-457-5359
  242.  
  243.     Fax: 619-452-2547
  244.  
  245.     Email: info@tgs.com
  246.  
  247.     WWW: http://www.sd.tgs.com/~template
  248.  
  249.