Space Mouse Input
Process input from space mouse device
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
Translation — Status of object translation
1
or true
| 0
or false
Status of object translation, returned as 0
or
false
if not pressed and 1
or
true
if pressed.
Data Types: Boolean
Rotation — Status of object rotation
1
or true
| 0
or false
Status of object rotation, returned as 0
or
false
if not pressed and 1
or
true
if pressed.
Data Types: Boolean
Buttons — Status of button
1
or true
| 0
or false
Status of button, returned as 0
or
false
if not pressed and 1
or
true
if pressed.
Data Types: Boolean
Parameters
Port — Serial port where mouse is connected
COM1
(default) | COM2
| COM3
| COM4
| USB1
| USB2
| USB3
| USB4
| USB
Serial port to which the space mouse is connected. Possible values are
USB1
...USB4
and
COM1
...COM4
.
Output type — Type of output
Speed
(default) | Position
| Viewpoint coordinates
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.
Dominant mode — Option to accept only prevailing movement and rotation
off
(default) | on
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 position movement — Option to fix rotations at initial values
off
(default) | on
Fixes the rotations at initial values, allowing you to change positions only.
Disable rotation movement — Option to fix positions at initial values
off
(default) | on
Fixes the positions at the initial values, allowing you to change rotations only.
Normalize output angle — Option to determine whether rotation angles should wrap in a full circle
off
(default) | on
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 — Option to limit position of mouse
off
(default) | on
Determines whether you can limit the upper and lower positions of the mouse.
Position sensitivity — Mouse sensitivity for translations
0.0001
(default)
Mouse sensitivity for translations. Higher values correspond to higher sensitivity.
Rotation sensitivity — Mouse sensitivity for rotations
0.00001
(default)
Mouse sensitivity for rotations. Higher values correspond to higher sensitivity.
Initial position — Initial condition for translations
[0 0 0]
(default)
Initial condition for integrated translations. This is not used when you
set the Output Type to
Speed
.
Initial rotation — Initial condition for rotations
[0 0 0]
(default)
Initial condition for integrated rotations. This is not used when you set
the Output Type to
Speed
.
Lower position limit — Lower limit of mouse
[-100 -100 -100]
(default)
Position coordinates for the lower limit of the mouse.
Upper position limit — Upper limit of mouse
[100 100 100]
(default)
Position coordinates for the upper limit of the mouse.
Version History
Introduced in R2007b
MATLAB Command
You clicked a link that corresponds to this MATLAB command:
Run the command by entering it in the MATLAB Command Window. Web browsers do not support MATLAB commands.
Select a Web Site
Choose a web site to get translated content where available and see local events and offers. Based on your location, we recommend that you select: .
You can also select a web site from the following list:
How to Get Best Site Performance
Select the China site (in Chinese or English) for best site performance. Other MathWorks country sites are not optimized for visits from your location.
Americas
- América Latina (Español)
- Canada (English)
- United States (English)
Europe
- Belgium (English)
- Denmark (English)
- Deutschland (Deutsch)
- España (Español)
- Finland (English)
- France (Français)
- Ireland (English)
- Italia (Italiano)
- Luxembourg (English)
- Netherlands (English)
- Norway (English)
- Österreich (Deutsch)
- Portugal (English)
- Sweden (English)
- Switzerland
- United Kingdom (English)