The Stage window consists of a menu bar and a view of the simulated world.
The world view shows part of the simulated world. You can zoom the view in and out, and scroll it to see more of the world. Simulated robot devices, obstacles, etc., are rendered as colored polygons. The world view can also show visualizations of the data and configuration of various sensor and actuator models. The View menu has options to control which data and configurations are rendered.
API: Stg::WorldGui
speedup 1
window ( size [ 400 300 ] # camera options center [ 0 0 ] rotate [ 0 0 ] scale 1.0 # perspective camera options pcam_loc [ 0 -4 2 ] pcam_angle [ 70 0 ] # GUI options show_data 0 show_flags 1 show_blocks 1 show_clock 1 show_footprints 0 show_grid 1 show_trailarrows 0 show_trailrise 0 show_trailfast 0 show_occupancy 0 show_tree 0 pcam_on 0 screenshots 0 )
Left-click and drag on the background to move your view of the world.
Scroll the mouse wheel to zoom in or out on the mouse cursor.
You can save the current pose of everything in the world, using the File/Save menu item. Warning: the saved poses overwrite the currentworld file. Make a copy of your world file before saving if you want to keep the old poses. Alternatively the File/Save As menu item can be used to save to a new world file.
The simulation can be paused or resumed by pressing the 'p' key. Run one simulation step at a time by pressing the '.' (period) key. Hold down the '.' key to step repeatedly. Stepping leaves the simulation paused, so press 'p' to resume running. The initial paused/unpaused state can be set in the worldfile using the "paused" property.
Models can be selected by clicking on them with the left mouse button. It is possible to select multiple models by holding the shift key and clicking on multiple models. Selected models can be moved by dragging or rotated by holding the right mouse button and moving the mouse. Selections can be cleared by clicking on an empty location in the world. After clearing the selection, the last single model selected will be saved as the target for several view options described below which affect a particular model.
The View menu provides access to a number of features affecting how the world is rendered. To the right of each option there is usually a keyboard hotkey which can be pressed to quickly toggle the relevant option.
Sensor data visualizations can be toggled by the "Data" option (shortcut 'd'). The filter data option (shortcut shift-'d') opens a dialog which enables turning on and off visualizations of particular sensors. The "Visualize All" option in the dialog toggles whether sensor visualizations are enabled for all models or only the currently selected ones.
The "Follow" option keeps the view centered on the last selected model.
The "Perspective camera" option switches from orthogonal viewing to perspective viewing.
To save a sequence of screenshots of the world, select the "Save screenshots" option from the view menu to start recording images and then select the option from the menu again to stop.