dual_quat_trans_point_3dπ
Short descriptionπ
dual_quat_trans_point_3d β Transform a 3D point with a unit dual quaternion.
Signatureπ
dual_quat_trans_point_3d( dual_quaternion DualQuaternion, point3d.x Px, point3d.y Py, point3d.z Pz, out point3d.x Tx, out point3d.y Ty, out point3d.z Tz )
Descriptionπ
The operator dual_quat_trans_point_3d transforms a 3D point
\((\textrm{Px}, \textrm{Py}, \textrm{Pz})\) by a 3D rigid
transformation that is given by the unit dual quaternion
DualQuaternion and returns the transformed 3D point in
\((\textrm{Tx}, \textrm{Ty}, \textrm{Tz})\).
For a brief introduction to dual quaternions, see [``Solving machine vision tasks > Machine vision basics
Transformations > 3D Transformations Dual quaternionsββ](https://docs.mvtec.com/hdevelopevo/26.11/content/mvtasks/machine_vision_basics/transformations/3d/dual_quaternions/index.html).
Attentionπ
dual_quat_trans_point_3d returns meaningful results only if
DualQuaternion is a unit dual quaternion.
Execution informationπ
Execution information
-
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
-
Multithreading scope: global (may be called from any thread).
-
Automatically parallelized on internal data level.
Parametersπ
DualQuaternion (input_control) dual_quaternion β (real / integer)
Unit dual quaternion representing the transformation.
Px (input_control) point3d.x(-array) β (real / integer)
Input point(s) (x coordinate).
Default: 64
Suggested values: 0, 16, 32, 64, 128, 256, 512, 1024
Py (input_control) point3d.y(-array) β (real / integer)
Input point(s) (y coordinate).
Default: 64
Suggested values: 0, 16, 32, 64, 128, 256, 512, 1024
Pz (input_control) point3d.z(-array) β (real / integer)
Input point(s) (z coordinate).
Default: 64
Suggested values: 0, 16, 32, 64, 128, 256, 512, 1024
Tx (output_control) point3d.x(-array) β (real)
Output point(s) (x coordinate).
Ty (output_control) point3d.y(-array) β (real)
Output point(s) (y coordinate).
Tz (output_control) point3d.z(-array) β (real)
Output point(s) (z coordinate).
Exampleπ
(HDevelop)
* dual_quat_trans_point_3d (DualQuat, Px, Py, Pz, Tx, Ty, Tz)
* is equivalent to the following code:
dual_quat_to_hom_mat3d (DualQuat, HomMat3D)
affine_trans_point_3d (HomMat3D, Px, Py, Pz, Tx, Ty, Tz)
Combinations with other operatorsπ
Combinations
Possible predecessors
dual_quat_compose, pose_to_dual_quat, screw_to_dual_quat
Alternatives
dual_quat_to_hom_mat3d, affine_trans_point_3d
See also
dual_quat_to_pose, dual_quat_normalize, serialize_dual_quat, deserialize_dual_quat, quat_rotate_point_3d, dual_quat_trans_line_3d
Moduleπ
Foundation