1rtcGetGeometryTransform(3)Embree Ray Tracing Kernels 4rtcGetGeometryTransform(3)
2
3
4
5 NAME
6 rtcGetGeometryTransform - returns the interpolated instance
7 transformation for the specified time
8
9 SYNOPSIS
10 #include <embree4/rtcore.h>
11
12 void rtcGetGeometryTransform(
13 RTCGeometry geometry,
14 float time,
15 enum RTCFormat format,
16 void* xfm
17 );
18
19 DESCRIPTION
20 The rtcGetGeometryTransform function returns the interpolated local to
21 world transformation (xfm parameter) of an instance geometry (geometry
22 parameter) for a particular time (time parameter in range [0, 1]) in
23 the specified format (format parameter).
24
25 Possible formats for the returned matrix are:
26
27 • RTC_FORMAT_FLOAT3X4_ROW_MAJOR: The 3×4 float matrix is laid out in
28 row-major form.
29
30 • RTC_FORMAT_FLOAT3X4_COLUMN_MAJOR: The 3×4 float matrix is laid out in
31 column-major form.
32
33 • RTC_FORMAT_FLOAT4X4_COLUMN_MAJOR: The 3×4 float matrix is laid out in
34 column-major form as a 4×4 homogeneous matrix with last row equal to
35 (0, 0, 0, 1).
36
37 This function is supposed to be used during rendering, but only sup‐
38 ported on the CPU and not inside SYCL kernels on the GPU. Inside a
39 SYCL kernel the rtcGetGeometryTransformFromScene function has to get
40 used.
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 [RTC_GEOMETRY_TYPE_INSTANCE], [rtcSetGeometryTransform], [rtcGetGeome‐
48 tryTransformFromScene]
49
50
51
52 rtcGetGeometryTransform(3)