README for TGS 3D Graphics Tools ------------------------------------- Updated 05-FEB-96 Copyright (C) 1995, 1996 Template Graphics Software Inc. All Rights Reserved. ************************************************************** IMPORTANT: The TGS software programs called "The TGS 3D Graphics Tools" provided on the Microsoft Visual C++ 4.x product CD are for use on the system for which you have installed a license of Microsoft Visual C++ 4.x. TGS offers no warranty for the software. Commercial versions of the software can be obtained directly from TGS. The TGS 3D Graphics Tools set includes: IVF AppWizard - IVF is a 3D extension to Microsoft MFC. IVF is a small part of the Open Inventor(tm) 3D C++ library licensed from Silicon Graphics by TGS. You can use the IVF AppWizard to develop 3D applications that support the VRML 1.0 subset of Open Inventor. You'll want the full Open Inventor SDK from TGS for more robust applications. Visual 3Space Browser Control - The V3Space control is a complete VRML 1.0 browser control which was modeled after the popular SceneViewer 3D viewing application. You can use the V3Space control to add 3D/VRML browsing into your application. It supports local 3D as well as Internet access via a DDE interface. This version supports the VRML 1.0 subset of Open Inventor. Contact TGS to enable the commercial features of this product. SceneViewer for Win32 - SceneViewer is a viewer application developed by Silicon Graphics using Open Inventor. It is a useful general purpose 3D viewer/editor and demonstrates many of the classes available with the Open Inventor SDK and the V3Space control. Other Stuff - Also included in this distribution are help files and local HTML files of the TGS WWW site. If you have an HTML browser installed please visit http://www.tgs.com or http://www.sd.tgs.com. *************************************************************** *---------------------------------------------------------* | Welcome to the TGS World of C++ 3D Graphics! | | | | Template Graphics Software encourages you to try our | | 3D Graphics Tools with Microsoft Visual C++ 4.x. | | If you like the sample software provided on this CD, | | be sure to contact TGS for information on our complete | | line of products, including: | | | | Open Inventor(TM) for Win32 (special offer) | | Visual 3Space(TM) Control (special offer) | | WebSpace(TM) Navigator VRML Browser | | | | You'll be suprised at how easy 3D can be when you use | | graphics tools from Template Graphics Software! | *---------------------------------------------------------* Special Offer to Visual C++ 4.1 Customers: For a limited time TGS is offering a 3D developers bundle: Open Inventor for Win32 SDK List $1,495.00 (U.S.) Visual 3Space Control (Intel) List $ 495.00 (U.S.) ----------------------------- Special Bundle Price! $1,250 U.S./$1,600 Int'l ************************* -OR- ********************************* Take advantage of our current promotional pricing: Open Inventor for Win32 SDK* $995 U.S./$1,250 Int'l. Visual 3Space Browser Control $395 U.S./$500 Int'l (* Specify Intel, MIPS, Alpha or PPC versions!) Call or contact TGS via: Tel: 800.544.4847 or 619.457.5359, x251 Fax: 619.452.2547 Email: info@tgs.com WWW: http://www.tgs.com or http://www.sd.tgs.com ****************************************************************** Worldwide TGS and G5G Contacts: TGS World Headquarters Template Graphics Software Inc. 9920 Pacific Heights Blvd., Suite 200 San Diego, CA 92121 Tel: 619.457.5359 Fax: 619.452.2547 Email: info@tgs.com WWW: http://www.sd.tgs.com/ or http://www.tgs.com Europe G5G, A TGS Company in Europe Buromaster 18 avenue Francois Sommer 92167 ANTONY Cedex FRANCE Tel: (33)1-42 37 66 66 Fax: (33)1-42 37 27 15 Email: europe@tgs.com ************************ TGS 3D Graphics Tools for Visual C++ ******************** Requirements TGS 3D Graphics Tools will run under Windows NT or Windows 95. All the necessary DLLs are provided with the TGS installation, including OpenGL(R) for Windows 95 by Microsoft. Using the standard Microsoft OpenGL, all screen resolutions and color depths are supported. Resolution of 1024x768 or higher and color depth of 256 or higher is recommended for best appearance. All 3D accelerator boards compatible with Microsoft OpenGL are supported, including boards based on GLINT, E&S, Oki and AccelGraphics. The TGS 3D Graphics Tools are fully integrated with Visual C++ 4.0! *-------------------------------------------------------------* | SceneViewer - 3D Desktop Utility | | | | SceneViewer, developed by SGI using the Open Inventor | | SDK, demonstrates many of the classes available | | for developing interactive 3D applications. This version | | of SceneViewer only supports the VRML 1.0 subset of the | | Open Inventor file format. | | | | Almost every feature, from direct manipulation of objects | | to the popup material editor, demonstrates functions that | | are predefined in the full Open Inventor for Win32 SDK by | | TGS. | *-------------------------------------------------------------* SceneViewer Program The SceneViewer program demonstrates some of the capabilities of the Open Inventor Class Library. The various viewers, material and color editor dialogs, direct manipulation of scene objects and many other features available in SceneViewer are built-in capabilities of the Open Inventor Class Library. This allows rapid prototyping of applications based on Open Inventor -- if you can describe your application's geometry in Open Inventor terms, you automatically have the ability to view and edit that geometry! Here are some suggestions for running the demo: - Use the File/Open menu to open one or more of the example models provided in the "models" directory. These files have a ".iv" or ".wrl" extension. You can also use "drag and drop" from the filemanager to put these files into the drawing area of the SceneViewer. - The default mode is "Examiner Viewer". Hold down the left mouse button to spin the model using the "virtual trackball". Hold down the middle mouse button to translate the model. - Use the View menu to change to a "Walk Viewer" or "Fly Viewer". In the Walk Viewer, hold down the left mouse button and move the mouse to "walk" forward or backward and to turn. In the Fly Viewer, click the left mouse button to accelerate and the middle mouse button to slow down. Current speed is displayed by a bar graph at the bottom of the window. Move the mouse to change your direction of travel. - Use the Light menu to create a new light in the scene. A 3D icon will appear indicating the light's position (and direction if appropriate). Put the cursor on the light icon, then press and hold the left mouse button to move the light. For directional and spot lights you can also interactively change the direction by moving the light icon's arrowhead. - Press the ESC key to toggle between "viewing" (the default) and "selection" modes. In viewing mode the cursor is a red hand. In selection mode the cursor is an arrow. In selection mode you can select any object in the scene by clicking on it. A red highlight box will appear around the selected object. - With an object selected, use the Editors menu to bring up the Material Editor dialog or the Color Editor dialog. Notice that Inventor automatically changes the appearance of the selected object when you make changes in the dialog box. - With an object selected, use the Manips menu to attach an Inventor "manipulator" to the object. For example, the Trackball manipulator allows you to rotate the selected object (move the cursor onto the trackball, then press and hold the left mouse button). *---------------------------------------------------------* | IVF AppWizard - 3D Custom AppWizard! | | | | Check out the custom application wizard to embed | | 3D Walk, Render, Fly and Examiner viewers into your | | application. Your application will be able to read | | in 3D data files with ease! | *---------------------------------------------------------* IVF AppWizard The IVF AppWizard is a custom AppWizard. Just as the MFC AppWizard generates a functional skeleton MFC application, the IVF AppWizard generates a fully functional skeleton Open Inventor (MFC) application. IVF is TGS's 3D extension to Microsoft MFC. It encapsulates the Open Inventor Component Library into MFC classes. TGS also supports Win32 and libSoXt (UNIX) versions of the Open Inventor Component Library in the full SDK product. The TGS 3D Graphics Tools installation program will add the IVF AppWizard to Visual C++ 4.0 in your Developer Studio environment. Using the IVF AppWizard is just like using any other AppWizard: - Pull down the File menu and select "New" - In the "New" dialog box: Select "Project Workspace" and click OK. - In the "New Project Workspace" dialog: Select "IVF AppWizard" (you will probably have to scroll down to the bottom of the list), enter the project name (and optionally location) and click OK. - Notice that the first five steps (first three steps for a dialog based application) are the same as the standard MFC AppWizard. You can click "Finish" at any time to go directly to the final dialog box, or you can click "Next" to go to the next step. - In step six you may specify the type of viewer that the application will use (see SceneViewer discussion concerning viewer types), the default window size and other options. - In step seven: Click "Finish" - In the final dialog: Click "OK" The TGS 3D Graphics Tools distribution includes all of the necessary headers and import libraries to build the viewers generated by this version of the TGS IVF AppWizard. The 3D Tools version generates code for Render- Area, Walk, Fly, and Examiner viewers. The full Open Inventor for Win32 SDK is required to generate a SceneViewer application. Note: The full Open Inventor SDK is required to write code that uses the Open Inventor Class Library directly. Contact TGS at 619.457.5359 (http://www.sd.tgs.com) for the full SDK. *-------------------------------------------------------------* | Visual 3Space Control - In the OCX Gallery! | | | | Check out the Visual 3Space Control, the first ever OLE | | Custom Control for 3D and VRML 1.0! Process, transform | | and modify your 3D data in ways your never thought | | possible on a PC! | *-------------------------------------------------------------* Visual 3Space(TM) Control - 3D/VRML OCX The Visual 3Space Control provides an OLE control wrapper for VRML 1.0 and the Open Inventor SceneViewer application. The OCX provides all of the functionality of the SceneViewer through a set of OLE interfaces. It is not necessary to have the Open Inventor SDK to develop applications using the Visual 3Space Control, only the runtime Open Inventor DLL's are required. The version of the Visual 3Space Control provided on the Visual C++ CD supports the VRML 1.0 subset of Open Inventor. Please contact TGS for the commercial version of the OCX. To use the Visual 3Space Control you must first register the control. Click on the Register Visual3Space Control icon to register the control. To experiment with the Visual 3Space Control start the Test Container, then: 1. Select Insert OLE Control from the Edit menu, and pick Ocxsv Control. 2. Resize the control to the desired dimensions. 3. Select Invoke Methods from the Edit menu. 4. From the Name drop box select the LoadFile method and click on Invoke. 5. Use the File Dialog to select a VRML file (Barcelona.wrl is a good model for experimenting with the Walk and Fly Viewers, bird.iv is good for the Examiner Viewer). 6. From the Name drop box select the showViewDialog method, and click on Invoke. 7. Select the desired viewer and click on Ok. 8. Click on Close to exit the Invoke Control Method Dialog. 9. For the Fly Viewer, click the left mouse button to accelerate, middle mouse button to decelerate, and left-middle to stop. For the Walk Viewer, press and hold the left mouse button while moving the mouse in the desired direction of motion. Use the up and down arrow keys to change elevation. Use the controls of the Fly or Walk viewer to move to a new viewing position, the bring up the Invoke Control Methods Dialog. Invoke the showNewCameraDialog method. Click on create, select View All, and click on Apply. Up to ten cameras can be created. Picking a camera from the Camera List will install that camera as the current camera. For the Examiner Viewer, press and hold the left mouse button to spin the camera around the object. Pressing the right mouse button brings up a popup menu that can be used to toggle viewing mode. Turn off viewing mode, place the mouse pointer over a piece of the model (i.e. the head of the bird) and click the left mouse button. A bounding box will appear around the selected component. Bring up the Invoke Control Methods dialog, invoke the manipTrackball method and close the dialog. Grab the trackball with the mouse pointer by pressing and holding the left mouse button. For a detailed description of the viewer controls see the Open Inventor Help File. 10. Invoke the lightAddDirect method to create a directional light. Turn of viewing mode and grab the light icon arrow head with the mouse. Use the mouse to change the direction of the light. Invoke the lightHideAll method to hide the light icon. *-------------------------------------------------------------* | About Open Inventor | | | | Open Inventor for Win32 is a C++ class library for 3D | | graphics applications, developed by Silicon Graphics | | and licensed by Template Graphics Software. TGS has moved | | this powerful 3D development toolkit to Windows NT and | | Windows 95, as well as non-SGI UNIX systems. Contact | | TGS for more information on Open Inventor and our other | | graphics tools products. | *-------------------------------------------------------------* About TGS Template Graphics Software, based in San Diego, California, has provided cross-platform graphics software since 1982. G5G, a TGS Company in Europe, provides direct sales, marketing, development, and support for Europe, Eastern Europe, Russia and Africa. TGS has regional sales/support offices in San Diego, San Jose, Houston, Atlanta, Montreal and Paris. TGS is represented by distribution partners in Japan, the Pacific Rim and Europe. TGS also provides the following additional graphics software: Open Inventor(TM) for Win32 (Intel, Alpha, MIPS and PPC) Open Inventor for UNIX (Sun, IBM, HP and DEC) Visual 3Space(TM) Browser Control - 3D/VRML browser OCX PHIGS+ - GPHIGS cross-platform UNIX and PC Charting Tools - Cross Platform FIGraph and PHIGURE OpenGL(R) - Apple, HP and Sun WebSpace(TM) Navigator - 3D Browser for the Internet OpenGL is a registered trademark and Open Inventor and WebSpace are trademarks of Silicon Graphics, Inc. Visual 3Space is a trademark of Template Graphics Software, Inc. Windows is a registered trademark and Visual C++ is a trademark of Microsoft Corporation. Other copyrights belong to their respective companies. Copyright 1996. All Rights Reserved.