Main Content

Space Mouse Input

(To be removed) Process input from space mouse device

Space Mouse Input will be removed in a future release. For more information, see Version History.

  • Space Mouse Input block

Libraries:
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 (https://www.3dconnexion.com).

To open the Block Parameters dialog box, double-click the block.

Ports

Output

expand all

Status of object translation, returned as 0 or false if not pressed and 1 or true if pressed.

Data Types: Boolean

Status of object rotation, returned as 0 or false if not pressed and 1 or true if pressed.

Data Types: Boolean

Status of button, returned as 0 or false if not pressed and 1 or true if pressed.

Data Types: Boolean

Parameters

expand all

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

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 a virtual world.

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.

Fixes the rotations at initial values, allowing you to change positions only.

Fixes the positions at the initial values, allowing you to change rotations only.

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.

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

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

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

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

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

Position coordinates for the lower limit of the mouse.

Position coordinates for the upper limit of the mouse.

Version History

Introduced in R2007b

collapse all

R2023b: To be removed

The Space Mouse Input will be removed in a future release. Instead, use sim3d classes and Simulation 3D blocks to interface MATLAB® and Simulink® with the Unreal Engine® 3D simulation environment. To get started, see Create 3D Simulations in Unreal Engine Environment.