Documentation Center

  • Trial Software
  • Product Updates

Space Mouse Input

Process input from space mouse device

Library

Simulink® 3D Animation™

Description

A space mouse is a device similar to a joystick in purpose, but it also provides movement control with six degrees of freedom. This block reads the status of the space mouse and provides some commonly used transformations of the input. The Space Mouse Input block supports current models of 3–D navigation devices manufactured by 3Dconnexion (http://www.3dconnexion.com). Contact MathWorks® Technical Support (http://www.mathworks.com/support) for further information on the support of older 3Dconnexion devices.

Data Type Support

The Space Mouse Input block outputs signals of type double.

Block Parameters Dialog Box

Port — Serial port to which the space mouse is connected. Possible values are USB1...USB4 and COM1...COM4.

Output Type — This field specifies how the inputs from the device are transformed:

  • Speed — No transformations are done. Outputs are translation and rotation speeds.

  • Position — Translations and rotations are integrated. Outputs are position and orientation in the form of roll/pitch/yaw angles.

  • Viewpoint coordinates — Translations and rotations are integrated. Outputs are position and orientation in the form of an axis and an angle. You can use these values as viewpoint coordinates in VRML.

Dominant mode — If this check box is selected, the mouse accepts only the prevailing movement and rotation and ignores the others. This mode is very useful for beginners using space mouse input.

Disable rotation movement — Fixes the positions at the initial values, allowing you to change rotations only.

Disable position movement — Fixes the rotations at initial values, allowing you to change positions only.

Normalize output angle — Determines whether the integrated rotation angles should wrap on a full circle (360°) or not. This is not used when you set the Output Type to Speed.

Limit position — Determines whether you can limit the upper and lower positions of the mouse.

Position sensitivity — Mouse sensitivity for translations. Higher values correspond to higher sensitivity.

Rotation sensitivity — Mouse sensitivity for rotations. Higher values correspond to higher sensitivity.

Initial position — Initial condition for integrated translations. This is not used when you set the Output Type to Speed.

Initial rotation — Initial condition for integrated rotations. This is not used when you set the Output Type to Speed.

Lower position limit — Position coordinates for the lower limit of the mouse.

Upper position limit — Position coordinates for the upper limit of the mouse.

See Also

Manipulator with SpaceMouseManipulator with SpaceMouse

Was this topic helpful?