JReality

JavaTM Virtual Reality Applications
"CM Surveyor"TM Usage Howto

Browser Layout

Browser Layout

The CM Surveyor Virtual Reality browser main window consists of eight regions: title bar, menu bar, 3D virtual reality (VR) view, end view, top view, side view, text fields, and message popup window.
         ______________________________________________________________
#1 Title |                       CM Surveyor                          |
         |------------------------------------------------------------|
#2 Menus | File Personal Environ Section Fidelity View           Help |
         |------------------------------------------------------------|
         |                                                            |
#3 3D VR |                                                            |
   View  |       _____________________________                        |
         |      |     CM Surveyor Message     |                       |
     #8 Message |-----------------------------|                       |
        Popup   |                            ||                       |
         |      |____________________________||                       |
         |      |        Hide  Clear          |                       |
         |      |_____________________________|                       |
         |                                                            |
         |____________________________________________________________|
         | >         || >                              || >          ||
         |           ||                                ||            ||
#4 End   |           ||                                ||            ||
#5 Top   |           ||                                ||            ||
#6 Side  |           ||                                ||            ||
2D Views |___________||________________________________||____________||
         |-----------  --------------------------------  -------------|
         |End View (X)            Top View (Y)           Side View (Z)|
         |  _______    ________    ________    _______     _______    |
#7 Text  | |_______|X |________|Y |________|Z |_______|Az |_______|El |
   Fields|____________________________________________________________|

Region #1: Window Border and Title Bar

         ______________________________________________________________
#1 Title |                       CM Surveyor                          |
         |------------------------------------------------------------|
         |                                                            |
Purpose: Provides ability to resize and iconify CM Surveyor.

Usage:

  • To Resize: grab corner of main window with mouse, then drag.
  • To Iconify: use menu or button on title bar (operating system dependent)
  • To Deiconify: mouse click or mouse press on icon (operating system dependent)

Notes: Appearance varies with host operating system.

Region #2: Menu Bar

         ______________________________________________________________
         |                       CM Surveyor                          |
         |------------------------------------------------------------|
#2 Menus | File Personal Environ Section Fidelity View           Help |
         |-----------------------------------------------------|---------------
         |                                                     | On-Line Help |
                                                               ----------------
Purpose: Provides user controls for browser display options.

Usage: Described in dedicated sections, except for Help which is described here.

Clicking Help displays the On-Line Help menu item, which provides a link to a copy of this documentation when CM Surveyor is run as an applet. This link is inactive when run standalone; however the documentation is supplied with the distribution and may be read with any conventional web browser.

Region #3: Virtual Reality Window

         |                                                          |
         |----------------------------------------------------------|
         |                                                          |
#3 3D VR |                                                          |
   View  |                                                          |
         |                                                          |
         |                                                          |
         |                                                          |
         |                                                          |
         |                                                          |
         |                                                          |
         |                                                          | 
         |__________________________________________________________|
         |                                                          |
Purpose: Displays the 3D virtual reality view corresponding to the location and view angle of the avatar in the 2D section views.

Usage:

Notes: VR window is non-interactive (output only). All user interaction is via the other regions of the browser.

Region #4: End View Window

         |______________
         | >         || 
#4 End   |           || 
2D View  |           || 
         |           || 
         |___________||_
         |-----------  -
         |End View (X)  
         | 
Purpose: Provides scene background context for navigation in vertical (Y) direction, and for elevation view angle. The window displays a projection or cross section view of the scene along the X axis. For a Compartmentalized Model (CM) defined with standard orientation, window shows an end (front/back or bow/stern) view along the longitudinal axis of the CM.

Usage:

  • To Scroll Image Vertically: slide right scrollbar using mouse.
  • To Scroll Image Horizontally: slide bottom scrollbar using mouse.
  • To Get Keyboard Focus: click mouse in window to enable keyboard-driven avatar movement. in this view.

Notes: Fixed size window; cannot be resized with current browser layout (alternate layouts possible, but not yet implemented).

Region #5: Top View Window

                   ________________________________________
                     || >                              || 
#5 Top               ||                                || 
2D View              ||                                || 
                     ||                                || 
                   __||________________________________||__
                   --  --------------------------------  --
                                  Top View (Y)
Purpose: Provides scene background context for navigation in horizonal (X-Z) plane, and for azimuth view angle. The window displays a projection or cross section view of the scene along the Y axis. For a Compartmentalized Model (CM) defined with standard orientation, window shows a top (floorplan or deck) view along the vertical axis of the CM. This is the primary navigation window -- the avatar will usually be moved via the top view.

Usage:

  • To Resize Horizontally: resize the main CM Surveyor window. See Region #1: Window Border and Title Bar. The top section window grows and shrinks in length with the main CM Surveyor window.
  • To Scroll Image Vertically: slide right scrollbar using mouse.
  • To Scroll Image Horizontally: slide bottom scrollbar using mouse.
  • To Get Keyboard Focus: click mouse in window to enable keyboard-driven avatar movement. in this view.

Notes: Fixed size vertically; cannot be resized in depth with current browser layout (alternate layouts possible, but not yet implemented).

Region #6: Side View Window

                                           _________________|  
                                             || >          ||
#6 Side                                      ||            ||
2D View                                      ||            ||
                                             ||            ||
                                           __||____________||
                                           --  -------------|
                                               Side View (Z)|
Purpose: Provides scene background context for navigation in vertical (Y) direction, and for elevation view angle. The window displays a projection or cross section view of the scene along the Z axis. For a Compartmentalized Model (CM) defined with standard orientation, window shows a side (left/right or port/starboard) view along the transverse axis of the CM.

Usage:

  • To Scroll Image Vertically: slide right scrollbar using mouse.
  • To Scroll Image Horizontally: slide bottom scrollbar using mouse.
  • To Get Keyboard Focus: click mouse in window to enable keyboard-driven avatar movement. in this view.

Notes: Fixed size window; cannot be resized with current browser layout (alternate layouts possible, bot not yet implemented).

Region #7: Text Fields

         |  _______    ________    ________    _______     _______    |
#7 Text  | |_______|X |________|Y |________|Z |_______|Az |_______|El |
   Fields|____________________________________________________________|
Purpose: Provides precise view position and view angle control of avatar. Displays avatar position and angle coordinates in real time.

Usage:

  • To Give Keyboard Focus to a Text Field: click mouse in the desired text field.
  • To Set View X Coordinate: give keyboard focus to X text field, type new X coordinate, then press the Enter key. Avatar immediately moves to the new X coordinate in all three section views, and the VR view updates to the new location.
  • To Set View Y Coordinate: similar to Set View X Coordinate, except use Y text field.
  • To Set View Z Coordinate: similar to Set View X Coordinate, except use Z text field.
  • To Set View Azimuth Angle: similar to Set View X Coordinate, except use Az text field.
  • To Set View Elevation Angle: similar to Set View X Coordinate, except use El text field.

Notes: Azimuth angle is rotation about Y axis, i.e., side-to-side head movement. Elevation angle is rotation about a line in X-Z plane perpendicular to azimuth view direction, i.e., up-and-down head movement.

Entering a coordinate that is beyond the display limits of the 2D section views will cause the avatar to move to that location and disappear from one or more of the section windows.

Entering data that is not a valid decimal value will cause the Message Window to pop up with an error message, and the avatar will not be moved.

Region #8: Message Window

                 _____________________________
                |     CM Surveyor Message     |
     #8 Message |-----------------------------|
        Popup   |                            ||
                |____________________________||
                |        Hide  Clear          |
                |_____________________________|
Purpose: Display informational messages and error messages.

Usage:

  • To Scroll Messages: slide scrollbar on right using mouse.
  • To Clear Messages: click Clear button with mouse.
  • To Make Message Window Disappear: click Hide button with mouse.

Notes: There is no control for making the Message Window reappear after pressing Hide. The Message Window reapears only when CM Surveyor has a new message to display.


Overview - Browser Layout - Avatar Movement
File Menu - Personal Menu - Environ Menu - Section Menu
Fidelity Menu - View Menu - Hyperlinking

Copyright (C) 2000-2003 LDJ Trust