1rtcSetSharedGeometryBufferE(m3b)ree Ray Tracing Kernelrstc4SetSharedGeometryBuffer(3)
2
3
4
5   NAME
6              rtcSetSharedGeometryBuffer - assigns a view of a shared data buffer
7                to a geometry
8
9   SYNOPSIS
10              #include <embree4/rtcore.h>
11
12              void rtcSetSharedGeometryBuffer(
13                RTCGeometry geometry,
14                enum RTCBufferType type,
15                unsigned int slot,
16                enum RTCFormat format,
17                const void* ptr,
18                size_t byteOffset,
19                size_t byteStride,
20                size_t itemCount
21              );
22
23   DESCRIPTION
24       The  rtcSetSharedGeometryBuffer function binds a view of a shared user-
25       managed data buffer (ptr argument) to a geometry buffer type  and  slot
26       (type and slot argument) of the specified geometry (geometry argument).
27
28       One  can  specify the start of the first buffer element in bytes (byte‐
29       Offset argument), the byte stride between  individual  buffer  elements
30       (byteStride  argument), the format of the buffer elements (format argu‐
31       ment), and the number of elements to bind (itemCount).
32
33       The start address (byteOffset argument) and  stride  (byteStride  argu‐
34       ment) must be both aligned to 4 bytes; otherwise the rtcSetSharedGeome‐
35       tryBuffer function will fail.
36
37       The buffer data must remain valid for as long  as  the  buffer  may  be
38       used,  and  the user is responsible for freeing the buffer data when no
39       longer required.
40
41       Sharing buffers can significantly reduce the memory required by the ap‐
42       plication,  thus  we  recommend  using this feature.  When enabling the
43       RTC_SCENE_FLAG_COMPACT scene flag, the spatial index  structures  index
44       into the vertex buffer, resulting in even higher memory savings.
45
46   EXIT STATUS
47       On  failure  an  error  code is set that can be queried using rtcGetDe‐
48       viceError.
49
50   SEE ALSO
51       [rtcSetGeometryBuffer], [rtcSetNewGeometryBuffer]
52
53
54
55                                                 rtcSetSharedGeometryBuffer(3)