blob: 547163a3f819445976d4df6e765ce6a432808b01 (
plain)
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
|
// Copyright (C) 2021 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only
/*!
\page studio-3d-node.html
\previouspage studio-3d-view.html
\nextpage studio-3d-group.html
\title Node
You can set properties for 3D components that are based on the
\uicontrol Node component in \uicontrol Properties > \uicontrol Node
and \uicontrol Transform.
\section1 Setting Node Opacity and Visibility
You can set the opacity and visibility of 3D components that are based on
the \uicontrol Node component in \uicontrol Properties > \uicontrol Node.
\image studio-3d-properties-node.png "Node properties"
All components have an \uicontrol Opacity value applied to them. The opacity
of 100 makes a component fully opaque, while the opacity of 0 prevents a
component from rendering at all.
Just as modifying the position or rotation of a parent component affects
all child components, opacity is multiplicatively cumulative through
the transform hierarchy. A cube that is 50\% opaque inside a group that
is 80\% opaque renders with an equivalent apperance of 40\% opacity
(\c{0.8 * 0.5 = 0.4}). Setting the opacity of a group to 0 prevents
any descendants within the group from rendering.
The \uicontrol Visibility property provides an alternative way to hide and
show components. It is useful when you want to show a component in a
particular state, but hide it in another state, for example.
The \uicontrol {Static flags} property is currently not used.
\section1 Managing 3D Transformations
You can manage 3D transformations for components that are based on the
\uicontrol Node component in \uicontrol Transform.
\image studio-3d-properties-transform.png "Transform properties"
The value of the \uicontrol Translation property contains the position
translation of the component in the local coordinate space established by
the parent component. The \uicontrol Orientation property specifies whether
the left-handed or right-handed coordinate system is used.
In the y-up left-handed coordinate system, increasing the value of x
moves the component to the right, as seen from the default camera location,
whereas increasing the value of y moves the component up. Increasing the
value of z moves the component away from the camera.
The value of the \uicontrol Rotation parameter sets the local rotation of
the component in the space established by the parent component. The
\uicontrol {Rotation order} property specifies whether the left-handed or
right-handed (the values with \e r) rotation about the x, y, and z axes
is applied, and the order in which the rotation is applied on each axis.
The value of the \uicontrol Scale property sets the local scale of the
component in the space established by the parent component. An odd number
of negative scale values causes the component to render \e {inside-out},
which cannot be seen due to backface-culling.
The value of the \uicontrol Pivot property sets the local pivot offset for
the component. You can think of the pivot as offsetting the geometry for the
component away from the origin, allowing a component to rotate and scale
around a point other than its local origin. Pivot values are applied before
scaling and rotation values.
A line is drawn in \uicontrol {3D Editor} from the pivot point to the center
of the component to provide a visual connection between them.
*/
|
