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
|
*********
Transform
*********
.. reference::
:Mode: Object Mode
:Panel: :menuselection:`Properties --> Object Properties --> Transform`
:Panel: :menuselection:`3D Viewport --> Sidebar --> Transform`
The *Transform* panel in the Sidebar region allows you to view and
manually/numerically control the position, rotation, and other properties of an object, in *Object Mode*.
Each object stores its position, orientation, and scale values.
These may need to be manipulated numerically, reset, or applied.
In *Edit Mode*. It mainly allows you to enter precise coordinates for a vertex,
or median position for a group of vertices (including an edge/face). As each type of object has a different set of
options in its *Transform* panel in *Edit Mode*,
see their respective descriptions in the :doc:`Modeling chapter </modeling/index>`.
Use this panel to either edit or display the object's transform properties such as position,
rotation and/or scaling. These fields change the object's origin and then affect the aspect of
all its *vertices* and faces.
.. figure:: /images/scene-layout_object_properties_transforms_panel.png
:align: center
Transform Properties.
.. _bpy.types.Object.location:
Location
The object's origin location in local coordinates.
.. _bpy.types.Object.rotation:
Rotation
The object's local orientation, relative to the global axes and its own origin.
.. _bpy.types.Object.rotation_mode:
Rotation Mode
Method for calculating rotations, additional information can be found
in the :doc:`manual's appendix </advanced/appendices/rotations>`.
:Euler:
The gizmo handles are aligned to the :term:`Euler` axis,
allowing you to see the discreet XYZ axis underlying the Euler rotation,
as well as possible :term:`Gimbal Lock`.
:Axis Angle:
The X, Y, and Z coordinates define a point relative to the object origin.
This point and the origin define an axis around the W value defines the rotation.
:Quaternion:
X, Y, Z and W correspond to the :term:`Quaternion` components.
.. _bpy.types.Object.scale:
Scale
The object's relative scale along the local axis
(e.g. the *Scale X* value represents the scale along the local X axis).
Each object (cube, sphere, etc.), when created, has a scale of one unit in each local direction.
To make the object bigger or smaller, you scale it in the desired axis.
.. _bpy.types.Object.dimensions:
Dimensions
The size of the object's bounding box
(aligned with the local axes -- think of a cardboard box just big enough to hold the object).
.. _bpy.types.Object.lock:
Transform Properties Locking
When the toggle is locked, the corresponding transformation value
can not be changed in any interactive operation.
But the value can still be changed using non-interactive operations,
like editing the corresponding number field or using Python.
For example, if you locked the *Location X* property
then you cannot use the 3D gizmo to move the object along the global X axis.
But you can still move it using the *Location X* number field.
Consider the locking feature as a rigid constraint only changeable from the panel.
To lock a property, click the padlock icon next to the button.
The button is unlocked if the icon shows an open padlock,
and it is locked if the icon appears as a closed padlock.
.. _bpy.types.Object.delta:
Delta Transforms
================
.. reference::
:Mode: Object Mode
:Panel: :menuselection:`Properties --> Object Properties --> Transform --> Delta Transforms`
Delta Transforms are simply transformations that are applied on top of the transforms described above.
Delta Transforms are particularly useful in animations. For example,
you can animate an object with the primary transforms then move them around with Delta Transforms.
|
