Operator Reference

HALCON Operator Reference / Transformations / Quaternions
ClassesClasses | | Operators

quat_rotate_point_3dT_quat_rotate_point_3dQuatRotatePoint3dQuatRotatePoint3dquat_rotate_point_3d (Operator)

quat_rotate_point_3dT_quat_rotate_point_3dQuatRotatePoint3dQuatRotatePoint3dquat_rotate_point_3d — Perform a rotation by a unit quaternion.

Signature

quat_rotate_point_3d( : : Quaternion, Px, Py, Pz : Qx, Qy, Qz)

Herror T_quat_rotate_point_3d(const Htuple Quaternion, const Htuple Px, const Htuple Py, const Htuple Pz, Htuple* Qx, Htuple* Qy, Htuple* Qz)

void QuatRotatePoint3d(const HTuple& Quaternion, const HTuple& Px, const HTuple& Py, const HTuple& Pz, HTuple* Qx, HTuple* Qy, HTuple* Qz)

double HQuaternion::QuatRotatePoint3d(double Px, double Py, double Pz, double* Qy, double* Qz) const

static void HOperatorSet.QuatRotatePoint3d(HTuple quaternion, HTuple px, HTuple py, HTuple pz, out HTuple qx, out HTuple qy, out HTuple qz)

double HQuaternion.QuatRotatePoint3d(double px, double py, double pz, out double qy, out double qz)

def quat_rotate_point_3d(quaternion: Sequence[float], px: float, py: float, pz: float) -> Tuple[float, float, float]

Description

Given a rotation quaternion (e.g., generated by axis_angle_to_quataxis_angle_to_quatAxisAngleToQuatAxisAngleToQuataxis_angle_to_quat), the operator quat_rotate_point_3dquat_rotate_point_3dQuatRotatePoint3dQuatRotatePoint3dquat_rotate_point_3d can be used to rotate a 3D point (PxPxPxpxpx, PyPyPypypy, PzPzPzpzpz). The rotated point is returned in (QxQxQxqxqx, QyQyQyqyqy, QzQzQzqzqz).

The rotation of a point x by an unit quaternion q is given by

corresponds to the conjugation of a quaternion q (see quat_conjugatequat_conjugateQuatConjugateQuatConjugatequat_conjugate). Note that x will be transformed into quaternion form to perform the rotation. This is done by setting the real part to zero and the three imaginary components to the three components of x.

Attention

The operator quat_rotate_point_3dquat_rotate_point_3dQuatRotatePoint3dQuatRotatePoint3dquat_rotate_point_3d does not check whether QuaternionQuaternionQuaternionquaternionquaternion is a unit quaternion. If QuaternionQuaternionQuaternionquaternionquaternion is not a unit quaternion, the result of this operator is not defined.

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Processed without parallelization.

Parameters

QuaternionQuaternionQuaternionquaternionquaternion (input_control)  quaternion → HQuaternion, HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Rotation quaternion.

PxPxPxpxpx (input_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

X coordinate of the point to be rotated.

PyPyPypypy (input_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Y coordinate of the point to be rotated.

PzPzPzpzpz (input_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Z coordinate of the point to be rotated.

QxQxQxqxqx (output_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

X coordinate of the rotated point.

QyQyQyqyqy (output_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Y coordinate of the rotated point.

QzQzQzqzqz (output_control)  real → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Z coordinate of the rotated point.

Possible Predecessors

axis_angle_to_quataxis_angle_to_quatAxisAngleToQuatAxisAngleToQuataxis_angle_to_quat

See also

axis_angle_to_quataxis_angle_to_quatAxisAngleToQuatAxisAngleToQuataxis_angle_to_quat, quat_to_hom_mat3dquat_to_hom_mat3dQuatToHomMat3dQuatToHomMat3dquat_to_hom_mat3d, quat_composequat_composeQuatComposeQuatComposequat_compose, quat_normalizequat_normalizeQuatNormalizeQuatNormalizequat_normalize, quat_conjugatequat_conjugateQuatConjugateQuatConjugatequat_conjugate, quat_interpolatequat_interpolateQuatInterpolateQuatInterpolatequat_interpolate, dual_quat_trans_point_3ddual_quat_trans_point_3dDualQuatTransPoint3dDualQuatTransPoint3ddual_quat_trans_point_3d, dual_quat_trans_line_3ddual_quat_trans_line_3dDualQuatTransLine3dDualQuatTransLine3ddual_quat_trans_line_3d

Module

Foundation

ClassesClasses | | Operators