Virtual Reality Toolbox    

Virtual Reality Toolbox Viewer

The Virtual Reality Toolbox contains a viewer as the default method for viewing virtual worlds. You can use this viewer on any supported operating system. For a list of supported operating systems, see System Requirements. The following topic provides an overview of the features and controls of the viewer.

  1. Open a virtual world by selecting a Virtual Reality demo or by clicking the View button in the Block Parameters dialog box of a Virtual Reality block.
  1. The Virtual Reality Toolbox viewer is loaded and becomes active. It displays the virtual scene with a control panel at the bottom.

Viewpoint Control

There are three buttons on the control panel that affect the viewpoint of the scene. The center circular button resets the camera to the current viewpoint. This button is useful when you have been moving about the scene and need to reorient yourself. The keyboard equivalents of this button are Home and R. The Esc key resets the camera to the default viewpoint.

You can use the right and left arrows associated with viewpoint control to browse through predefined viewpoints. These buttons are inactive if other viewpoints are not specified by the author. You can also use the Page Up and Page Down keys to navigate through these viewpoints.

Control Menu

Access the control menu by right-clicking in the viewer window. You can use the control menu to specify a predefined viewpoint or change the appearance of the control panel. You can also control the navigation method, speed, and rendering of the virtual world. For more information about navigation methods, see Navigation. For more information about rendering, see Rendering.

Changing the Navigation Speed

  1. In the viewer window, right-click.
  2. Point to Navigation.
  3. Point to Speed, then select Very Slow.
  1. Your navigation speed within the virtual world is much slower than before.

Consider setting a higher speed for large scenes and a slower speed for more controlled navigation in smaller scenes.

Rendering

You can change the rendering of the scene through the control panel or the control menu. The vrpend demo is used to demonstrate the viewer's functionality.

You can turn the antialiasing of the scene on or off. Antialiasing is a technique that attempts to smooth the appearance of jagged lines. These jagged lines are the result of a printer or monitor's not having enough resolution to represent a line smoothly. When Antialiasing is on, the jagged lines are surrounded by shades of gray or color. Therefore, the lines appear fuzzy rather than jagged.

You can turn the camera headlight and the lighting of the scene on or off. When Headlight is off, the camera does not emit light. Consequently, the scene can appear dark. For example, the following figure depicts the vrpend demo with Headlight(on).

The scene looks darker when Headlight is set to off.

When Lighting is off, the virtual world appears as if lit in all directions. Shadows disappear and the scene loses some of its three-dimensional quality. The following is the vrpend demo with Lighting(off).

If Textures is off, objects do not have texture in the virtual scene.

If Transparency is off, transparent objects are rendered as solid objects.

Turning Wireframe on changes the scene's objects from solid to wireframe renderings.

Navigation

You can navigate around a virtual scene using the control panel, control menu, mouse, and keyboard. The vrbounce demo is used to demonstrate the viewer's functionality.

Control Panel -- The center navigation wheel and two curved buttons on either side move you about the scene. Experiment by moving backward and forward and side to side until you become comfortable with the controls.

Control Menu -- Right-click in the viewer window to access the control menu. Point to Navigation and a new menu is displayed.

From this menu, you can reset the camera so that it is pointed straight ahead by choosing Straighten up. You can also return to the current viewpoint by choosing Go to current viewpoint. This option is useful if you are navigating about the scene and want to reorient yourself.

Mouse -- Navigation with the mouse depends on the navigation method you select and the navigation zone you are in when you first click and hold down the mouse button. You can set the navigation method using the W, E, or F buttons on the control panel or by right-clicking in the viewer. Point to Navigation. Next, point to Method and click Walk, Examine, or Fly.

To view the navigation zones for a scene, right-click in the viewer and point to Navigation. Then click Show navigation zones (off). The navigation zones are toggled on and appear in the virtual scene.

For example, using the vrbounce demo with Method set to Fly, there are three navigation zones.

The following table summarizes the behavior associated with the movement modes and navigation zones when you use your mouse to navigate through a virtual world. Turn the navigation zones on and experiment by clicking and dragging your mouse in the different zones of a virtual world.

Mouse Navigation
Movement Mode
Zone and Description
Walk
Outer -- Click and drag the mouse up, down, left, or right to move the camera in any of these directions in a single plane.
Inner -- Click and drag the mouse up and down to move forward and backward. Drag the mouse left and right to turn left or right.
Examine

Outer -- Click and drag the mouse up and down to move forward and backward. Drag the mouse left and right to pan left or right.
Inner -- Click and drag the mouse to rotate the viewpoint about the origin of the scene.

Fly
Outer -- Click and drag the mouse to tilt the view either left or right.
Inner -- Click and drag the mouse to move the camera up, down, left, or right within the scene.
Center -- Click and drag the mouse up and down to move forward and backward. Move the mouse left or right to turn in either of these directions.

If your virtual world contains sensors, these sensors take precedence over mouse navigation at the sensor's location.

Example of How Sensors Affect Mouse Navigation

  1. In the MATLAB Command Window, type
  1. at the MATLAB command prompt. The inverted pendulum demo starts, and the viewer displays the following scene.

  1. In the Simulink model window, from the Simulation menu, choose Start.
  1. The demo starts running.

  1. Click in the viewer window inside and outside the sensor area. Notice that the sensor takes precedence over navigation with the left mouse button. The shape of your pointer changes when it is located over the sensor area.

If the sensor covers the entire navigable area, mouse navigation is effectively disabled. In this case, use the control panel or the keyboard to move about the scene. For a three-button mouse or a mouse with a clickable wheel, you can always use the middle button or the wheel to move about the scene. The middle mouse button and wheel do not trigger sensors within the virtual world.

Keyboard -- It is also possible to use the keyboard to navigate through a virtual world. It can be faster and easier to issue a keyboard command, especially if you want to move the camera repeatedly in a single direction. The following table summarizes the keyboard commands and their associated navigation functions. Note that the letters presented do not need to be capitalized in order to perform their intended function.

Keyboard Navigation  
Keyboard Command
Navigation Function
0
Reset the camera so that it is pointed straight ahead
B
Toggle the alpha blending on/off. If alpha blending is on, objects that have a set alpha value are displayed as transparent.
F/G
Zoom in/out
H
Toggle the headlight on/off
I
Show/hide information on viewpoint name and camera position
L
Toggle the lighting on/off
T
Toggle the object textures on/off
V
Toggle the navigation zones on/off
W
Toggle the wireframe option on/off
Esc
Return to default viewpoint
R, Home
Return to current viewpoint
Page Up, Page Down
Move between preset viewpoints
S,X, <, >
Rotate the viewpoint about the origin of the scene
Left Arrow, Right Arrow
Move the camera left and right
Up Arrow, Down Arrow
Move the camera forward and backward
N,M
Tilt the camera right and left
\
Camera is bound/unbound from the viewpoint
Shift-W
Set the navigation method to Walk
Shift-E
Set the navigation method to Examine
Shift-F
Set the navigation method to Fly
A, Z
Pan up and down
Shift-A, Shift-Z
Slide up and down
O,P
Pan right and left
Shift-O, Shift-P
Slide right and left


  Viewing a Virtual World blaxxun Contact VRML Plug-in