Visual Simulation Environment Keyboard and Mouse
Glossary Item Box
Microsoft Robotics Developer Studio | Send feedback on this topic |
Visual Simulation Environment Keyboard and Mouse
The Visual Simulation Environment (VSE) simulation window provides keyboard and mouse operations that can be used to control the view and elements in the simulation environment.
Using the Keyboard
The following keys control the movement and orientation of the camera in the simulation environment when the Simulation pane has input focus. When the Simulation pane has input focus, it is surrounded by a blue border. Click inside the pane or press the Tab key until the blue border appears.
Key | Action |
---|---|
w or Up Arrow | Move forward |
s or Down Arrow | Move backward |
a or Left Arrow | Move to the left (slide sideways) |
d or Right Arrow | Move to the right (slide sideways) |
q or Page Up | Move up |
e or Page Down | Move down |
Home | Reset to initial position |
Note that you can also use the numeric keypad, as long as it is not in numeric mode. In this case the numeric keys 2, 4, 6 and 8 act as arrow keys.
If you press the Shift key with these keys, the movement keys move 20 times faster.
Key | Action |
---|---|
F2 | Change the render mode |
F3 | Toggle the physics engine enable |
F5 | Toggle between Edit Mode and Run Mode |
F8 | Change the active camera |
When the simulator is in Edit mode the navigation keys work the same but some additional options are available when the left Ctrl key is held down. When the left Ctrl key is pressed, the currently selected entity will be highlighted if it has a valid bounding sphere associated with it. While the Ctrl key is pressed, the following additional keys are available:
Key | Action |
---|---|
Up Arrow | View the selected object from above (a positive Y distance from the object) |
Shift+Up Arrow | View the selected object from below (a negative Y distance from the object) |
Left Arrow | View the selected object from a positive X distance from the object |
Shift+Left Arrow | View the selected object from a negative X distance from the object |
Right Arrow | View the selected object from a positive Z distance from the object |
Shift+Right Arrow | View the selected object from a negative Z distance from the object |
Using the Mouse
In most cases, dragging the mouse cursor through the Graphics pane by holding down the left button and moving the mouse causes the camera viewpoint to change. In general, keyboard commands affect the position of the camera while mouse movement affects the orientation of the camera.
When the simulator is in Edit mode and the left control key is held down, the mouse behavior can be different. If an entity is selected and the Position property is selected in the Property window, the mouse movement affects the position of the entity. If any component of the position vector is selected, the entity is constrained to move only along that axis. Similarly, if the rotation property is selected in the Property window, the mouse movement affects the orientation of the entity. If any component of the rotation vector is selected, the entity is constrained to rotate only along that axis.
Using an Xbox Controller
If you have an Xbox Controller connected to your PC, you can use it to control the camera as well. The two thumbsticks on the controller can be used to move the camera around. Note that you must press and hold the Left Shoulder button (just above the left thumbstick) while you are moving the camera. This is not immediately obvious.
The movement of the camera is controlled using the left thumbstick and the right thumbstick is used to pan and tilt the camera as follows (with Left Shoulder held down):
Thumbstick | Direction | Action |
---|---|---|
Left | Up | Move forward |
Left | Down | Move backward |
Left | Left | Move to the left (slide sideways) |
Left | Right | Move to the right (slide sideways) |
Right | Up | Rotate (tilt) up |
Right | Down | Rotate (tilt) down |
Right | Left | Rotate (pan) left |
Right | Right | Rotate (pan) right |
IMPORTANT NOTE: If you are using another application that uses the Xbox Controller, such as the Simple Dashboard, you must make sure that the Simulation window has the input focus in order to use the controller to move the camera. Click inside the simulation window with the mouse to give it focus. A blue border appears around the simulation area when it has focus. If another application has the focus, then you cannot control the simulation camera using the Xbox Controller.
The simulation coordinate system
The simulator uses a right-handed coordinate system. The +Y axis represents elevation above the ground plane. The X and Z axes are parallel to the ground plane. When facing in the +X direction, the +Z axis is to the right. Some modeling tools use a different coordinate system and it is important to export the models rotated in such a way that they appear correct in the simulation environment.
© 2012 Microsoft Corporation. All Rights Reserved.