IMMERSION / STEALTH E-MOUSE

Description

The Immersion and Stealth E-Mouse are free-hand devices for moving the cursor in the XYZ directions in VrTwo. One of two models may be used which include the original Immersion Mouse with the Immersion Interface Box (IBox) or the Stealth E-Mouse which emulates the Immersion format. 20 user definable buttons are available. The Vr Mapping Immersion driver allows any button to be programmed to emit a predefined VrOne key press from 0 to 11 or any VrOne key-in which may include key-ins, macros and (or) function keys.

Hardware

The Immersion / Stealth E-Mouse are connected to the computer via a standard serial (RS-232) interface. Power is supplied to the Immersion Interface Box or the Stealth E-Mouse via a power adapter.

Driver Installation

There is no driver installation required for either the Immersion or Stealth E-Mouse. The drivers are included in VrTwo.

Vr Configuration

Vr may be configured to use the Immersion/Stealth E-Mouse from the Vr Configuration program (VrCfig). From the Configuration pull-down, the “VrTwo 3D input” item may be selected which will bring up to following dialog box.

Immersion/Stealth E-Mouse - Vr Button Assignments

Any button on the Z-Mouse may be programmed to emit one of the following:

A VrOne button press with a value from 0 to 11 (b0-b11). Button press 10 is the Vr * key, button press 11 is the 0 key (used to condition snap) and button press 11 is the # key which is normally used to terminate a VrOne application.
Any valid VrOne key-in. These key-ins may include a VrOne key-in, Macro or Function Key. Multiple key-ins may be placed on a single key up to 64 characters.
A pre-defined function which include the Clutch and fast X and Y motion commands.

To configure button assignments the Input->Device Controls->Immersion/Stealth E-Mouse may be selected or type DevImm (Device Immersion) while in VrOne or VrTwo.

The Z-Mouse button numbers are displayed in the left column and reference the Z-Mouse buttons as shown in the image above. The right columns contain the user defined key definitions that will be executed when the button is pressed.

All button assignments will emit a command when the button is pressed and will not emit another until the button is raised and pressed again.

Possible button assignments are:

B0-b11 - VrOne button presses 1-12.
Any valid VrOne key-in
Clutch – When pressed, the XY motion of the Z-Mouse are disconnected. The Clutch / Shift button is predefined and cannot be assigned to another key.
+X, -X, +Y, -Y – Pressing and holding one of these keys will move the stereo plotter in this frame motion. The speed of the instrument will increase as the button is held down (ramping).

VrOne key-ins may be placed on any key simply by typing the desired VrOne command or commands up to 64 characters. Multiple commands are separated by a comma. For example;

ZooA, SetLayMacro, RoadFuncKey

Could be entered which would perform a Zoom All then run the SetLayMacro macro then start the RoadFuncKey function key. Of course, SetLayMacro and RoadFuncKey are defined by the user.

The Serial Port number specifies the serial port number in which the Immersion Mouse Interface Box or the Stealth E-Mouse is connected. If the serial cable is connected to the COM1 port on the computer then the Serial Port number would be 1.

The Read Wait Delay may be set to slow down the input from the mouse with by pausing between each read. This parameter is entered as milliseconds where 1000 is one second.

Z-Mouse Xy and Z scale factors may also be set with this dialog box. A scale factor of 1 is no scale factor. Reversing the sign of a scale factor reverses the input motion.