home *** CD-ROM | disk | FTP | other *** search
/ Virtual Reality Homebrewer's Handbook / vr.iso / system / wtkdemo.txt < prev   
Text File  |  1996-06-03  |  9KB  |  202 lines
  1. WorldToolKit for Windows Demo 6/7/94
  2.  
  3. Note: None of the models or textures supplied with this demo can be used for 
  4. any purpose other than this Sense8 demo.
  5.  
  6.  
  7. Credits:  Some of the models/textures shipped with this demo were supplied by 
  8. our customers. We would like to acknowledge their efforts:
  9.  
  10. IST Break Room 
  11. This model was created by the Institute for Simulation and Training, Orlando 
  12. FL, for the US Army. This is the model we use for measuring relative 
  13. performance on various hardware platforms.
  14.  
  15. Meguro City
  16. This model was created by ASAHI Electronics, Japan. It represents a small city 
  17. in Japan.
  18.  
  19.  
  20. WTK Demo
  21. This demo is designed to show some of the more general capabilities of 
  22. WorldToolKit. You can "drag and drop" models and textures into the universe or 
  23. simply use the dialog boxes to load models and apply textures to polygons. You 
  24. can interactively fly around your models and change the color or texture of 
  25. various surfaces or polygons.
  26.  
  27. You can also load AutoCAD DXF, 3D Studio 3DS or Wavefront OBJ files. If you 
  28. load any of these files, there will be an automatic timeout after 90 seconds 
  29. of viewing the files.
  30.  
  31. The demo supports the following features:
  32.     Loading NFF, 3DS, DXF or OBJ model files
  33.     Interactive texturing of surfaces
  34.     Drag and Drop of models or textures
  35.     Changes to ambient light
  36.     Changes to background color
  37.     Moving objects
  38.  
  39. How to use these features is explained below.
  40.  
  41. Loading objects:
  42. If you examine the "models" subdirectory, you will find a dozen files with the 
  43. ".NFF" extension. These are Sense8 Neutral File Format models. You can load 
  44. any of these into WorldToolKit by either dragging them from the File Manager 
  45. window and dropping them into the graphics window, or by using the Universe 
  46. Load or Object Load menu items.
  47.  
  48. The difference between a Universe and an Object is very simple. Universes are 
  49. static, they can not be moved, scaled or stretched and you can only have a 
  50. single Universe entity loaded at one time. Objects, on the other hand, can be 
  51. moved and manipulated. You can also have as many Objects as performance and 
  52. memory permits.
  53.  
  54. Loading a stationary Universe
  55. Step 1: Load a new Universe
  56. Select Load from the Universe menu. This will bring up a file selection dialog 
  57. box.
  58.  
  59. Step 2: Pick a model
  60. Select the "models" directory. This should show you the list of all the NFF 
  61. files included with this demo. You can double-click on any of the listed files 
  62. and it will load into the graphics window.
  63.  
  64. Loading an Object
  65. Step 1: Clear the Universe
  66. Select New from the Universe menu. This should clear the Universe of any 
  67. existing objects.
  68.  
  69. Step 2: Load a new Object
  70. Select Load from the Object menu. This will bring up a file selection dialog 
  71. box.
  72.  
  73. Step 3: Pick a model
  74. Select the "models" directory. This should show you the list of all the NFF 
  75. files included with this demo. You can double-click on any of the listed files 
  76. and it will load into the graphics window.
  77.  
  78. Note: We discovered a bug with some 3D Studio 3DS files that may cause 
  79. problems when loading or quitting the WTK application after loading a 3DS 
  80. file. This only occurs with some 3DS files, so you may not encounter the 
  81. problem.
  82.  
  83. Navigating with the mouse:
  84. You can either use the push-buttons to fly your viewpoint, or you can use the 
  85. mouse directly. If you are using the mouse directly, your viewpoint will 
  86. change based on the position of the cursor in the WorldToolKit graphics 
  87. window. For example, to move closer to an object you click with the left mouse 
  88. button near the top of the graphics window.
  89.  
  90. The following table explains the behaviour of your viewpoint if you are using 
  91. the mouse or the push-buttons:
  92.  
  93. Result                  Mouse equivalent
  94.  
  95. Move forward            Left mouse button near the top of the window.
  96.  
  97. Move backwards          Left mouse button near the bottom of the window.
  98.  
  99. Turn (rotate) left      Left mouse button near the left-side of the window.
  100.  
  101. Turn (rotate) right     Left mouse button near the right-side of the window.
  102.  
  103. Move up                 Right mouse button near the top of the window.
  104.  
  105. Move down               Right mouse button near the bottom of the window.
  106.  
  107. Pan (shift) left        Right mouse button near the left-side of the window.
  108.  
  109. Pan (shift) right       Right mouse button near the right-side of the window.
  110.  
  111. Pitch (look) up         Both mouse buttons near the top of the window.
  112.  
  113. Pitch (look) down       Both mouse buttons near the bottom of the window.
  114.  
  115. Reset pitch             NA
  116.  
  117. Reset initial viewpoint NA
  118.  
  119. You can accelerate your speed when using the push-buttons by clicking with the 
  120. right-mouse button instead of the left. This should more than double your 
  121. speed.
  122.  
  123. If you are navigating using the mouse directly (instead of the push-buttons), 
  124. you can adjust your mouse sensitivity by using the dialog box under the View 
  125. menu item.
  126.  
  127. Picking objects:
  128. You can use the mouse to pick an object that was loaded with either Object New 
  129. or Object Load. Once you have picked an object, you can either move it, change 
  130. its color or texture, delete it or make it spin around any of three axis.
  131.  
  132. Note: You cannot pick a Universe. If you loaded an object with Universe Load, 
  133. you will not be able to pick or move this object.
  134.  
  135. Step 1: Switching to Picking mode
  136. The last item on the menu bar is the "Flying!" item. Select this with the 
  137. cursor. It should change to read "Picking!". This will toggle everytime you 
  138. select it.
  139.  
  140. Step 2: Picking an object
  141. You can use the mouse to select an object. Simply click with the left 
  142. mouse-button when the cursor is moved over the top of an object. You will know 
  143. if you selected the object because a wireframe bounding-box will appear around 
  144. the object.
  145.  
  146. Step 3: Deselecting an object
  147. Clicking with the left-mouse button on a selected object should deselect it. 
  148. You can pick multiple objects.
  149.  
  150. Note: You will not be able to use the mouse to fly if any objects are 
  151. selected. However, the push-buttons should still work.
  152.  
  153.  
  154. Moving objects:
  155. In the WTK Demo, the default mouse movement is attached to the graphics window 
  156. viewpoint. If you then select an object, the mouse will instead be attached to 
  157. the object you selected. Then, when you move the mouse, the object moves with 
  158. it and not your window point of view. This means that instead of your 
  159. viewpoint moving forward, the object will move forward (directly away from 
  160. your viewpoint) and appear to recede from view.
  161.  
  162. For all practical purposes, you can consider the graphics window frame as 
  163. behaving like any other virtual object within that window.
  164.  
  165. You will likely find that simply pressing one or more mouse buttons while 
  166. moving the cursor in the display can tell you how your mouse is affecting 
  167. objects and viewpoints in a given virtual world.
  168.  
  169. Drag & Drop
  170. The WTK Demo lets you drag and drop 3D objects and textures into the graphics 
  171. window from the File Manager. Here's how:  Step 1:      Create a new universe
  172. Select New from the Universe menu. This will empty the universe and clear the 
  173. screen.
  174.  
  175. Step 2: Set up your windows for drag and drop action.
  176. Open the File Manager to one side of the WorldToolKit windows.
  177.  
  178. Select the models subdirectory in the File Manager. This should cause the File 
  179. Manager to display a list of files with the NFF extension.
  180.  
  181. Step 3: Select an object to drag into the graphics window
  182. Click on the file icon for cubostel.nff and drag it onto the graphics window. 
  183. As you drag the icon onto the graphics window, a + sign appears in its icon, 
  184. which means that it can be dropped into the display. When the icon is over the 
  185. graphics window, release the mouse button to see the contents of the file 
  186. displayed in the graphics window.
  187.  
  188. Any 3D model can be dragged and dropped into the WTK Demo in this manner. As 
  189. each one is dropped, they will be added as individual objects to the 
  190. simulation.
  191.  
  192. Step 4: Select a texture to place on a polygon of the cubostel.
  193. Now select the IMAGES directory using the File Manager. You should see a list 
  194. of files with the TGA extension. These are TARGA format pictures or textures.
  195.  
  196. This time, drag a file icon from the IMAGES directory and release it on a 
  197. given facet on the model. The texture appears on the facet on which you 
  198. release it. The model here has a part of the brick4.tga texture on its facets.
  199.  
  200. The rest of the cubostel can also be covered with TGA image files by dragging 
  201. and dropping image files onto the other facets.
  202.