Man page - rtcsetgeometrytransformquaternion(3)

Packages contains this manual

Package: libembree-dev
apt-get install libembree-dev

Documentations in package:

libembree-dev

Manual

rtcSetGeometryTransformQuaternion

NAME
SYNOPSIS
DESCRIPTION
EXIT STATUS
SEE ALSO

NAME

rtcSetGeometryTransformQuaternion - sets the transformation for a particular
  time step of an instance geometry as a decomposition of the
  transformation matrix using quaternions to represent the rotation.

SYNOPSIS

#include <embree4/rtcore.h>


void rtcSetGeometryTransformQuaternion(
  RTCGeometry geometry,
  unsigned int timeStep,
  const struct RTCQuaternionDecomposition* qd
);

DESCRIPTION

The rtcSetGeometryTransformQuaternion function sets the local-to-world affine transformation ( qd parameter) of an instance geometry ( geometry parameter) for a particular time step ( timeStep parameter). The transformation is specified as a [RTCQuaternionDecomposition], which is a decomposition of an affine transformation that represents the rotational component of an affine transformation as a quaternion. This allows interpolating rotational transformations exactly using spherical linear interpolation (such as a turning wheel).

For more information about the decomposition see [RTCQuaternionDecomposition]. The quaternion given in the RTCQuaternionDecomposition struct will be normalized internally.

For correct results, the transformation matrices for all time steps must be set either using rtcSetGeometryTransform or rtcSetGeometryTransformQuaternion . Mixing both representations is not allowed. Spherical linear interpolation will be used, iff the transformation matizes are set with rtcSetGeometryTransformQuaternion .

For an example of this feature see the tutorial [Quaternion Motion Blur].

EXIT STATUS

On failure an error code is set that can be queried using rtcGetDeviceError .