- Qt 3D Studio
- Studio Index
- Studio: Toolbar
- Qt 3D Studio 2.8 Manual

# Studio: Toolbar

## Selection Modes

The Selection Mode buttons control what item is selected in the timeline palette when you click on items in the scene view. You can toggle mode with shortcut key `Q`.

- Clicking on an item using Group Select mode will select the highest group or component owning the item you clicked on. This mode is useful when you want to move a group of items at once.
- Clicking on an item using Item Select mode will select the item you clicked on. If the item is not present in the Timeline palette (if it is inside a component) then the component is selected instead.

With either tool, if you double-click on an item in the scene view then the item itself will be selected (changing which component is displayed in the timeline palette as necessary).

## Manipulator Modes

The Manipulator Mode buttons control what manipulator is shown in the rendered scene when an item is selected, and what happens when you drag on the selected item.

- The Position mode (keyboard shortcut: `W`) adjusts the position of the selected item. Left-dragging on the item will adjust the selected item's position in the plane of the render camera; right-dragging will adjust the selected item's position along the view axis of the camera.
- The Rotation mode (keyboard shortcut: `E`) adjusts the rotation of the selected item. Left-dragging on the item will tumble the selected item; right-dragging rotate the item around the view axis of the camera.
- The Scale mode (keyboard shortcut: `R`) adjusts the scale of the selected item. Left-dragging on the item will uniformly scale the selected item; right-dragging will adjust only the local Z scale of the item.

By default the manipulators affect the local transformation of the item. For example, selecting an unrotated cube inside a rotated group with the Position manipulator mode active will show rotated axes. Dragging on the red arrow of the manipulator will affect only the X position of the item.

The Local/Global Manipulators mode (right-most icon above) changes this behavior to affect the global transform of the selected item instead. In global mode, the manipulators always transform with respect to the global space. In the example above, turning on global mode will show the red arrow for the position manipulator aligned with the screen (assuming an unrotated camera). Dragging on the red arrow may affect two or three of the position values for the selected item in order to move it in global space.

## Keyframing

The Autoset Keyframes toggle (keyboard shortcut: `K`) controls whether keyframes are automatically created at the current playhead time in the timeline whenever a value with animation enabled has its value changed.

The following example illustrates the use of this toggle:

1. Create an object positioned at 0,0,0
2. Move the playhead to time 0.
3. Turn on the animation toggle for the Position property in the Inspector palette. A keyframe is created at time 0.
4. Move the playhead to a new time (e.g. 1 second).
5. Turn off the `Autoset Keyframes` toggle.
6. Adjust the object position to 100,200,0. The object moves in the scene view, but no keyframe is created.
7. Move the playhead to a new time (e.g.2 seconds). The object snaps back to position 0,0,0, since no new keyframe was created for the new position.
8. Turn on the `Autoset Keyframes` toggle.
9. Adjust the position to 100,200,0. As soon as you stop editing one of the position values a new keyframe is created. Each time you change a value at this time the keyframe is updated.

Without the `Autoset Keyframes` mode on, you must set change keyframes manually by selecting Timeline > Set Changed Keyframes from the menu (Shortcut key: `Ctrl + Shift + K`). to create a new keyframe.

## Edit Cameras

By default the rendered scene looks through the camera in each layer and shows the composited result. Sometimes you want to instead move around the 3D space of your scene without adjusting the final rendered view. Studio calls this concept Edit Cameras, and it is controlled by the section of the toolbar displayed above.

You can navigate in Edit Camera Mode by zooming, panning and orbiting:

Action | Shortcut keyboard | Desctiption
--- | --- | ---
Zoom | `Alt`+Right mouse button | Clicking and dragging anywhere in the rendered view for the edit camera will zoom the view in/out as you drag up/down.
Pan | `Alt`+Middle mouse button | Clicking and dragging anywhere in the rendered view for the edit camera will slide the view around.
Orbit | `Alt`+Left mouse button | Clicking and dragging anywhere in the rendered view for the edit camera will rotate the view. (This is not available for the predefined, axis-aligned orthographic views.)

Note: When Edit Camera is in use it only makes sense to show the contents of one layer at a time. To control which layer's items you are viewing, select any item inside the desired layer in the timeline palette.

- The Edit Camera Mode drop-down menu controls the view.
  - The Perspective View and Orthographic view are free-form cameras that you can use to rotate around the scene.
  - The Top/Bottom/Left/Right/Front/Back axis-aligned presets are orthographic cameras that may be panned and zoomed, but not orbited.
- The Scene Camera View entry at the bottom of the menu switches out of edit camera mode and returns to displaying the final composited result from the cameras in each layer of the presentation.
- The Fit Selected command (keyboard shortcut: `F`) will ensure that whatever is selected fills the view of the active edit camera. If no item is selected, this command ensures that the contents of the active layer are all visible in the edit camera.

  - Note: If you want to drop your selection, but cannot find any empty space in the view to click on, you can click on empty space in the Slides palette to cause no items to be selected. This may seem a little weird, but it is effective.)

  - When using the default `Scene Camera View` mode, this command will instead downscale the appearance of the presentation to fit within the available space in Studio.
- The Helper Grid toggle (shortcut: `Ctrl + Shift + H`) toggles the visibility of the helper grid.
- The Shading Mode toggle (shortcut: `L`) toggles a `headlamp' attached to your edit camera. When enabled (the default) items are lit by the edit camera such that they are always easy to see. When disabled, the lighting from the final rendering is used. If you have a black ambient lighting in your scene (the default) then objects viewed from behind may not be visible without turning on your headlamp.

## Preview

The preview toolbar buttons are used to preview your presentation.

- The Filter Variants button (keyboard shortcut: `F7`) will open the variant tags panel. Read more in the Using Variant Tags section.
- The Preview with OpenGL Runtime button (keyboard shortcut: `F5`) will launch the OpenGL Runtime Viewer application and preview the application for the presentation.
- The Remote Preview button (keyboard shortcut: `F6`)will launch the presentation on the connected remote device Qt 3D Studio Viewer application. This button is only enabled if you are connected to a remote device.

Note: If there is no `.uia` file in the folder for the presentation, then the presentation will be previewed by itself (no sub-presentations).