feedc0de/qt-creator
1
0
Fork 0
forked from qt-creator/qt-creator
Code Pull Requests Activity

Doc: Describe 3D Editor local and global orientation mode

Browse Source 
Change-Id: Ibe281ba6d06c68a9c5f36a743563b6fc40fe7e0a
Reviewed-by: Miikka Heikkinen <miikka.heikkinen@qt.io>
Reviewed-by: Mahmoud Badri <mahmoud.badri@qt.io>
Reviewed-by: Leena Miettinen <riitta-leena.miettinen@qt.io>
This commit is contained in:
Johanna Vanhatapio
2020-04-29 15:07:51 +03:00
parent d08e5c33ff
commit 00200d8b90
1 changed files with 24 additions and 16 deletions
Download Patch File Download Diff File Expand all files Collapse all files

40
doc/qtdesignstudio/src/qtquick3d-editor/qtdesignstudio-3d-editor.qdoc
View File

@@ -45,25 +45,16 @@
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.
You can use the toolbar buttons (2) to show the \e transformation
gizmo in the \uicontrol {3D Editor} when an item is selected
and to determine what happens when you drag the selected item.
Transformation refers to moving, rotating, or scaling of an object.
Select the \uicontrol {Toggle Local/Global Orientation} button (3) to
determine whether the gizmos affect only the local transformations 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
@@ -153,6 +144,23 @@
To freely rotate the item, select the gray circle.
\section1 Using Global and Local Orientation
To switch between global and local orientation, select \uicontrol
{Toggle Local/Global Orientation}.
In global orientation mode, transformation of a selected object is presented
with respect to the global space. For example, while the move tool is
selected, selecting a cube will show its move gizmo aligned with the axes
of global space. Dragging on the red arrow of the gizmo moves the object in
the global x direction.
In local orientation mode, the position of a selected object is shown
according to local axes specific to the selected object. For example,
selecting a rotated cube will show its axes rotated, and not aligned with
the axes of global space. Dragging on the red arrow of the gizmo
moves the object in the local x direction in relation to the object.
\section1 Scaling Items
\image studio-3d-editor-scale.png "3D editor in scale mode"