1rtcSetGeometryTransformQuaEtmebrrneieonR(a3y)TracingrtKceSrenteGlesom4etryTransformQuaternion(3)
2
3
4
5   NAME
6              rtcSetGeometryTransformQuaternion - sets the transformation for a particular
7                time step of an instance geometry as a decomposition of the
8                transformation matrix using quaternions to represent the rotation.
9
10   SYNOPSIS
11              #include <embree4/rtcore.h>
12
13              void rtcSetGeometryTransformQuaternion(
14                RTCGeometry geometry,
15                unsigned int timeStep,
16                const struct RTCQuaternionDecomposition* qd
17              );
18
19   DESCRIPTION
20       The  rtcSetGeometryTransformQuaternion function sets the local-to-world
21       affine transformation (qd parameter) of an instance geometry  (geometry
22       parameter) for a particular time step (timeStep parameter).  The trans‐
23       formation is specified as a [RTCQuaternionDecomposition],  which  is  a
24       decomposition of an affine transformation that represents the rotation‐
25       al component of an affine transformation as a quaternion.  This  allows
26       interpolating rotational transformations exactly using spherical linear
27       interpolation (such as a turning wheel).
28
29       For more information about the decomposition see [RTCQuaternionDecompo‐
30       sition].  The quaternion given in the RTCQuaternionDecomposition struct
31       will be normalized internally.
32
33       For correct results, the transformation matrices  for  all  time  steps
34       must  be  set  either  using rtcSetGeometryTransform or rtcSetGeometry‐
35       TransformQuaternion.   Mixing  both  representations  is  not  allowed.
36       Spherical linear interpolation will be used, iff the transformation ma‐
37       tizes are set with rtcSetGeometryTransformQuaternion.
38
39       For an example of this feature  see  the  tutorial  [Quaternion  Motion
40       Blur].
41
42   EXIT STATUS
43       On  failure  an  error  code is set that can be queried using rtcGetDe‐
44       viceError.
45
46   SEE ALSO
47       [rtcInitQuaternionDecomposition], [rtcSetGeometryTransform]
48
49
50
51                                          rtcSetGeometryTransformQuaternion(3)