1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
|
/****************************************************************************
**
** Copyright (C) 2020 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the Qt Design Studio documentation.
**
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file. Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
**
****************************************************************************/
/*!
\contentspage index.html
\previouspage studio-3d-design-mode.html
\page studio-3d-editor.html
\nextpage studio-3d-view.html
\title Working in the 3D Editor
To project a 3D scene to a 2D viewport, it is necessary to view the scene
from a \l{Using Scene Camera}{camera}. Select the \uicontrol {Toggle
Perspective/Orthographic Projection} button (1) on the 3D editor toolbar to
switch between a \e {perspective camera} and an \e {orthographic camera}.
A perspective camera uses field of view and near and far clip planes to
specify the projection, whereas an orthographic camera can be thought of
as a 2D camera. Both of them are free-form cameras that you can use to
orbit around the scene.
When you import 3D scenes from files that you exported from 3D graphics
tools, you also import the camera, light, model, and materials. If your
scene did not contain them, you can add the corresponding Qt Quick 3D
types from the \uicontrol Library.
You can use the manipulator mode toolbar buttons (2) to show the move, rotate,
or scale manipulator in the rendered scene when an item is selected and
to determine what happens when you drag the selected item. Select the
\uicontrol {Toggle Local/Global Orientation} button (3) to determine whether
the manipulators affect only the local transforms of the item or whether
they transform with respect to the global space.
\image studio-3d-editor.png "3D Editor"
For example, in local orientation mode, selecting an unrotated cube inside
a rotated group in the move mode shows rotated axes. Dragging on the red
arrow of the move manipulator affects only the x position of the item.
In global mode, the manipulators always transform with respect to the global
space. In the example above, switching to global mode will show the red
arrow for the move 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.
The \e pivot of the component is used as the origin for position, scale,
and rotation operations. You can set a \l{Setting Transform Properties}
{local pivot offset} for an item in the \uicontrol Properties view to
manipulate the component around a point other than its local origin. A
line is drawn in the 3D editor from the pivot point to the center of the
component to provide a visual connection between them.
\section1 Controlling the Edit View Camera
You can add 3D camera types to the scene to project the view you see in
the View3D type in the application. While editing scenes, you can use
a separate \e {edit view camera} (4) to project the scene to the 3D edit
view in the Design mode.
You can navigate the scene by rotating, panning, and zooming the edit view
camera.
To zoom, use the mouse wheel or press \key Alt and right-click anywhere in
the rendered view to zoom the view in or out as you drag up or down.
To pan, press \key Alt and use the middle mouse button to click anywhere in
the rendered view to slide the view around.
To orbit, press \key Alt and click anywhere in the rendered view to rotate
the view.
To scale the edit view camera and to focus it on the selected items, select
\uicontrol {Fit Selected} button or press \key F.
The world axis helper (5) shows the direction of the world axes in respect
to the edit view camera. To point the camera at the currently selected
component in the direction of an axis, click the axis. If no component
is selected, the camera is pointed at the world origin. This does not
affect the camera zoom level.
For more information about using the cameras in the scene, the available
3D camera types, and their properties, see \l{Using Scene Camera}.
\section1 Selecting Items
To move, rotate, or scale items in the scene, you need to select them first.
The selection mode buttons determine how items are selected when you click
them in the 3D editor.
\list
\li In the \inlineimage item_selection_selected.png
(\uicontrol {Select Item}) mode, a single item is selected.
\li In the \inlineimage group_selection_selected.png
(\uicontrol {Select Group}) mode, the top level parent of the item
is selected. This enables you to move, rotate, or scale a group of
items.
\endlist
To toggle the selection mode, press \key Q.
\section1 Moving Items
\image studio-3d-editor-move.png "3D editor in move mode"
You can move items in relation to their coordinate system, along the x, y,
or z view axis or on the top, bottom, left, and right clip planes of the
render camera.
To move items, select \inlineimage move_selected.png
or press \key W.
To move items along an axis, click the axis and drag the item along the
axis.
To move items on a plane, select the plane handle and drag the item on
the plane.
To move an item freely in the editor, select the handle at the center of
the item.
\section1 Rotating Items
You can rotate items around the view axes of the camera.
\image studio-3d-editor-rotate.png "3D editor in rotate mode"
To rotate items, select \inlineimage rotate_selected.png
or press \key E.
To rotate an item around an axis, select the axis and drag in the direction
you want to rotate the item in.
To freely rotate the item, select the gray circle.
\section1 Scaling Items
\image studio-3d-editor-scale.png "3D editor in scale mode"
To scale items, select \inlineimage scale_selected.png
or press \key R.
You can use the scale handles to adjust the local x, y, or z scale of an
item. You can adjust the scale across one, two, or three axes, depending
on the handle.
To adjust the scale across one axis, select the scale handle attached to
the axis. To uniformly scale an item across all axes, select the handle
at the center of the item.
To adjust the scale across a plane, select the plane handle and drag the
item on the plane.
\section1 Using Edit View Light
You use 3D light types to light the models in the scene. While editing
scenes, you can use a separate \e {edit view light} to illuminate the
portions of the scene that the scene lights do not hit. To switch the edit
view light on and off, select the \uicontrol {Toggle Edit Light} button (6).
For more information about the available scene light types and their
properties, see \l{Using Lights}.
*/
|