Topics
• Getting Started
• Cmd Line Opts
• Tcl/Tk Version
• X/Motif Version
• NS Plugin Version
• ActiveX Version
•   Embed in IE
•   Embed in PPT
•   Navigation
• Configuration
• Creating Data
• OAA Interface
   
• Go to FAQ
 

Digital Earth > TerravisionTM > User Guide > ActiveX

Navigation Support for TerraVision ActiveX Control

Mouse Controls

You can navigate around the 3-D environment using a mouse by moving the cursor into the viewer window and using the mouse buttons as follows.
  • Middle Mouse Button: In 3-D mode, rotates the current viewpoint as you drag the mouse but does not change your location, i.e. this can be considered analagous to simply moving your head to look around the environment. In 2-D mode, dragging the middle mouse button is analagous to panning over the terrain at a constant elevation. You can also use this button to stop if you are currently moving.

  • Left Mouse Button: In 3-D mode, accelerates you through the environment. In 2-D mode, zooms into the terrain. You can move the mouse while you are moving forward to change your trajectory.

  • Right Mouse Button: In 3-D mode, decelerates your forward momentum, eventually moving you backwards through the environment once you reach zero velocity. In 2-D mode, zooms out from the terrain. You can move the mouse while you are moving forward to change your trajectory.
If you depress one of the SHIFT keys on the keyboard, then the behaviour of the mouse navigation changes to give you viewer-centric navigation as follows:
  • SHIFT + Middle Mouse Button: slides the current viewpoint to the left or right, up or down, depending upon how you move the mouse from the initial mouse click. You can think of this as equivalent to side-stepping or bobbing your head up or down.

  • SHIFT + Left Mouse Button: accelerates you forward along the direction that you are currently facing. You can move the mouse while you are moving forward in order to slide the viewpoint during the motion.

  • SHIFT + Right Mouse Button: decelerates your forward momentum, eventually moving you backwards from the way that you are currently facing. Again, you can move the mouse while you are moving forward in order to slide the viewpoint during the motion.

TerraVision emulates the middle mouse button whenever you depress the left and right mouse buttons at the same time. This lets you fully control TerraVision even if you only have a two button mouse.

Keyboard Controls

You can press a number of keys while the mouse is over the ActiveX control window in order to quickly access a number of features. In order to detect keyboard events under Windows, you may need to first click inside the TerraVision canvas so that it gains keyboard focus. Currently, the following key strokes are supported:

  • 'O' - return to the default (Origin) viewpoint

  • '2' - switch to 2-D constrained viewing mode

  • '3' - switch to 3-D viewing mode

  • 'W' - toggle wireframe mode

  • 'H' - toggle the display of the Heads Up Display

  • 'L' - toggle the terrain lighting

  • SHIFT + 'L' - toggle the display of the SRI logo

  • SHIFT+'O' - toggle the display of dataset outlines

  • '-' - toggle the Z-buffer hack for multiple datasets

  • SPACE - stop flying

  • PGUP - jump to the previous bookmark

  • PGDN - jump to the next bookmark

Heads Up Display

The Heads Up Display (HUD) provides a textual overlay in the bottom-left corner of the display with various useful pieces of information. There are two HUD modes, debug and normal. The debug mode provides a lot more information, while the normal mode provides a more concise readout. The following information is displayed in the debug HUD, with only the first two items being shown under normal circumstances.

  • The (latitude, long, elevation) of your viewpoint

  • Your (yaw, pitch, roll) orientation

  • The effective near and far clipping planes.

  • The current frame number and the number of tiles in the scene

  • The 1 second data burst rate into the application (MBit/s) and the total amount of data read so far

  • The frame rate of the graphics system (instantaneous and averaged over 5 second)

You can toggle the display of the HUD by pressing 'H' on the keyboard. Currently there is not a way to display the debug HUD in the ActiveX control.

 

 

Copyright ©2000 SRI International. All rights reserved.

For more information, please contact: digital-earth@ai.sri.com.
Last updated: Friday, 09-Mar-2001 13:56:33 PST.