Nodes Rotation Socket Documentation #104584

Merged
Dalai Felinto merged 15 commits from Sam-Aldhaher/blender-manual:blender-v4.0_rotation_nodes into blender-v4.0-release 2023-10-23 12:19:41 +02:00
17 changed files with 223 additions and 1 deletions

View File

@ -17,6 +17,7 @@ Take, for instance, any three values for X, Y and Z rotation. Perform each one o
Depending on the order in which you perform these, you will end up with different final orientations. Depending on the order in which you perform these, you will end up with different final orientations.
So proper rotation coordinate systems are needed. So proper rotation coordinate systems are needed.
.. _euler mode:
Euler Modes Euler Modes
=========== ===========
@ -56,6 +57,7 @@ This particular loss of axis is known as the "gimbal lock".
One advantage of this mode is that animation curves are easy to understand and edit. One advantage of this mode is that animation curves are easy to understand and edit.
However, special attention must be done when the middle axis approaches values close to 90° (or equivalent angles). However, special attention must be done when the middle axis approaches values close to 90° (or equivalent angles).
.. _axis angle mode:
Axis Angle Mode Axis Angle Mode
=============== ===============
@ -81,6 +83,7 @@ along the defined rotation axis, i.e. it points towards the direction defined by
The axis-angle system is free from gimbal lock, but animation curves in this mode are not intuitive at all The axis-angle system is free from gimbal lock, but animation curves in this mode are not intuitive at all
when animating axis and angle at the same time, in which case they are difficult to understand and edit. when animating axis and angle at the same time, in which case they are difficult to understand and edit.
.. _quaternion mode:
Quaternion Mode Quaternion Mode
=============== ===============

BIN
manual/images/node-types_FunctionNodeAxisAngleToRotation.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
manual/images/node-types_FunctionNodeEulerToRotation.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
manual/images/node-types_FunctionNodeInvertRotation.png (Stored with Git LFS) Normal file

Binary file not shown.

Binary file not shown.

BIN
manual/images/node-types_FunctionNodeRotateVector.png (Stored with Git LFS) Normal file

Binary file not shown.

BIN
manual/images/node-types_FunctionNodeRotationToEuler.png (Stored with Git LFS) Normal file

Binary file not shown.

Binary file not shown.

View File

@ -0,0 +1,28 @@
.. index:: Geometry Nodes; Axis Angle to Rotation
.. _bpy.types.FunctionNodeAxisAngleToRotation:
***************************
Axis Angle to Rotation Node
***************************
.. figure:: /images/node-types_FunctionNodeAxisAngleToRotation.png
:align: right
:alt: Axis Angle to Rotation node.
The *Axis Angle to Rotation* node converts a :ref:`axis angle <axis angle mode>` rotation to a standard rotation value.
Inputs
======
Axis
Unit vector representing the axis to rotate around.
Angle
The rotation angle around the axis.
Outputs
=======
Rotation
Standard rotation value.

View File

@ -0,0 +1,25 @@
.. index:: Geometry Nodes; Euler to Rotation
.. _bpy.types.FunctionNodeEulerToRotation:
**********************
Euler to Rotation Node
**********************
.. figure:: /images/node-types_FunctionNodeEulerToRotation.png
:align: right
:alt: Euler to Rotation node.
The *Euler to Rotation* node creates a rotation value from an Euler rotation.
Inputs
======
Euler
The :term:`Euler` rotation.
Outputs
=======
Rotation
Standard rotation value.

View File

@ -8,3 +8,10 @@
align_euler_to_vector.rst align_euler_to_vector.rst
rotate_euler.rst rotate_euler.rst
rotate_vector.rst
axis_angle_to_rotation.rst
euler_to_rotation.rst
rotation_to_euler.rst
rotation_to_quaternion.rst
quaternion_to_rotation.rst
invert_rotation.rst

View File

@ -0,0 +1,24 @@
.. index:: Geometry Nodes; Invert Rotation
.. _bpy.types.FunctionNodeInvertRotation:
********************
Invert Rotation Node
********************
.. figure:: /images/node-types_FunctionNodeInvertRotation.png
:align: right
:alt: Invert Rotation node.
The *Invert Rotation* node inverts a rotation.
Inputs
======
Rotation
Standard rotation value.
Outputs
=======
Rotation
The inverted rotation.

View File

@ -0,0 +1,31 @@
.. index:: Geometry Nodes; Quaternion to Rotation
.. _bpy.types.FunctionNodeQuaternionToRotation:
***************************
Quaternion to Rotation Node
***************************
.. figure:: /images/node-types_FunctionNodeQuaternionToRotation.png
:align: right
:alt: Quaternion to Rotation node.
The *Quaternion to Rotation* node converts a :ref:`quaternion rotation <quaternion mode>` to a standard rotation.
Inputs
======
W
The W value of the quaternion.
X
The X value of the quaternion.
Y
The Y value of the quaternion.
Z
The Z value of the quaternion.
Outputs
=======
Rotation
Standard rotation value.

View File

@ -16,7 +16,7 @@ Inputs
====== ======
Rotation Rotation
The Euler rotation to rotate. The :term:`Euler` rotation to rotate.
Rotate By Rotate By
Specifies how much an Euler rotation is rotated. This input is only available Specifies how much an Euler rotation is rotated. This input is only available

View File

@ -0,0 +1,27 @@
.. index:: Geometry Nodes; Rotate Vector
.. _bpy.types.FunctionNodeRotateVector:
******************
Rotate Vector Node
******************
.. figure:: /images/node-types_FunctionNodeRotateVector.png
:align: right
:alt: Rotate Vector node.
The *Rotate Vector* node rotates a vector by a given rotation value.
Inputs
======
Vector
The vector to rotate.
Rotation
Standard rotation value.
Outputs
=======
Vector
The rotated vector.

View File

@ -0,0 +1,25 @@
.. index:: Geometry Nodes; Roation to Euler
.. _bpy.types.FunctionNodeRotationToEuler:
**********************
Rotation to Euler Node
**********************
.. figure:: /images/node-types_FunctionNodeRotationToEuler.png
:align: right
:alt: Rotation to Euler node.
The *Rotation to Euler* node converts a standard rotation socket value to an Euler rotation.
Inputs
======
Rotation
Standard rotation socket value.
Outputs
=======
Euler
The :term:`Euler` rotation.

View File

@ -0,0 +1,31 @@
.. index:: Geometry Nodes; Rotation to Quaternion
.. _bpy.types.FunctionNodeRotationToQuaternion:
***************************
Rotation to Quaternion Node
***************************
.. figure:: /images/node-types_FunctionNodeRotationToQuaternion.png
:align: right
:alt: Rotation to Quaternion node.
The *Rotation to Quaternion* node converts a standard rotation socket value to a :ref:`quaternion rotation <quaternion mode>` rotation.
Inputs
======
Rotation
Standard rotation socket value.
Outputs
=======
W
The W value of the quaternion.
X
The X value of the quaternion.
Y
The Y value of the quaternion.
Z
The Z value of the quaternion.