WELCOME TO THE NEW PLATFORM FOR THE OPENSIM DOCUMENTATION

Remember to update your bookmarks with our new URL.
If you find missing content or broken links, let us know: opensim@stanford.edu


Navigating the Visualizer Window

The topics in this section include:

A Visualizer window is shown here.

The Toolbar is in the upper left corner.

The expandable View Controls Menu is in the upper right corner.


The sections below describe the keys/shortcuts supported by the Visualizer window, the Toolbar, and the View Controls Menu.

The Visualizer (3D View) window comes with a built-in set of key bindings that you can use to navigate within the window and to perform rotation, pan, and zoom operations. The key bindings differ depending on whether you are running OpenSim on a Windows or Mac platform. You can translate and rotate in the 3D View window using the following:

rotate

To rotate the view, left-click and hold (PC or mouse) or single-finger click and hold (Mac trackpad) in the Visualizer window and drag the cursor.

translate

To translate the view, right-click and hold (PC or mouse) or two-finger click and hold (Mac trackpad) in the Visualizer window and drag the cursor.

zoom

To zoom in or out, scroll up or down in the Visualizer window with the mouse or trackpad. Alternatively on a trackpad, pinch or expand.

The Visualizer window comes equipped with a set of standard buttons to make it convenient to orient the objects in the 3D View according to your preferences. These buttons appear in a Toolbar, which is located by default at the top left corner of the visualizer window. The following buttons are available in the Toolbar:

Look at the model from the world's –X direction. Note that multiple models could be loaded and each model could have its own concept of "front," but there's one unambiguous –X direction within the world's coordinate system. Similarly, = +X, = -Y, = +Y, = -Z, = +Z.

Toggle the display of world coordinate axes on and off.

Take a snapshot of the view. When you click this button, a file browser is brought up and you are prompted for the name of a .png file in which to save an image of the 3D View.

Record a movie. Clicking this icon toggles movie recording on and off.

Zoom-in.
Zoom-out.
Fit the model in the Visualizer Window using the current camera orientation.

The following set of hot keys are available and can be used to achieve some of the same functionality that is available through the Toolbar:

Button

Function

i

Zoom in

o

Zoom out

Arrow keysReposition camera field of view

Selecting objects in the visualizer View is a fundamental part of the graphical editing capabilities available in OpenSim. It makes it easier to perform tasks, such as moving muscle attachment points. The following operations are supported:

select

Select an object using single click. An object that has been selected will be indicated by a yellow wireframe bounding box around it, and its name will appear in the status bar. If there is a node corresponding to the selected object in the Navigator tree, it will be selected. Selection is possible only on the current model. Objects can also be selected by double clicking on them in the Navigator. The top image shows scene light-source with an attached selection triad.

clear

Clear all selections with a left mouse click in an empty area of the view.

drag

Drag objects by selecting them, if dragging is allowed you'll see a triad attached to the selection box. Use the left mouse to click and drag the object to its new location using the arrows of the triad. Currently only dragging of muscle points and markers is supported.

At the upper right corner is an expandable menu of options to further customize the Visualizer window. You can expand the menu (collapsed by default) by clicking the "Open View Controls" button.

The following table describes the names and functions of these options:

OptionFunction
Backdrop: Background ColorSelect solid background color from popup.
Backdrop: ImageSelect from a preset list of images to serve as a backdrop or select nobackground for solid/no-image backdrop.
Floor: TextureSelect from a preset list of textures for floor material or no floor at all
Floor: HeightUse this slider to move the floor up/down as needed. Models project shadow on the floor by default.
Lighting: Select Scene LightPicking this option will show a triad attached to the light source used to generate shadows, use the triad to position the light source as needed.
Lighting: Model LightThis slider controls the intensity of the light source placed by default on top of all your models.
Snapshot QualityThis slider controls the quality of images generated using the "snapshot" button. Values range from (1-4) where 4 is max resolution/quality.



OpenSim is supported by the Mobilize Center , an NIH Biomedical Technology Resource Center (grant P41 EB027060); the Restore Center , an NIH-funded Medical Rehabilitation Research Resource Network Center (grant P2C HD101913); and the Wu Tsai Human Performance Alliance through the Joe and Clara Tsai Foundation. See the People page for a list of the many people who have contributed to the OpenSim project over the years. ©2010-2024 OpenSim. All rights reserved.