1rtcSetSharedGeometryBufferE(m3b)ree Ray Tracing Kernelrstc3SetSharedGeometryBuffer(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 <embree3/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 us‐
25       er-managed data buffer (ptr argument) to a  geometry  buffer  type  and
26       slot (type and slot argument) of the specified geometry (geometry argu‐
27       ment).
28
29       One can specify the start of the first buffer element in  bytes  (byte‐
30       Offset  argument),  the  byte stride between individual buffer elements
31       (byteStride argument), the format of the buffer elements (format  argu‐
32       ment), and the number of elements to bind (itemCount).
33
34       The  start  address  (byteOffset argument) and stride (byteStride argu‐
35       ment) must be both aligned to 4 bytes; otherwise the rtcSetSharedGeome‐
36       tryBuffer function will fail.
37
38       The  buffer  data  must  remain  valid for as long as the buffer may be
39       used, and the user is responsible for freeing the buffer data  when  no
40       longer required.
41
42       Sharing buffers can significantly reduce the memory required by the ap‐
43       plication, thus we recommend using this  feature.   When  enabling  the
44       RTC_SCENE_FLAG_COMPACT  scene  flag, the spatial index structures index
45       into the vertex buffer, resulting in even higher memory savings.
46
47   EXIT STATUS
48       On failure an error code is set that can  be  queried  using  rtcGetDe‐
49       viceError.
50
51   SEE ALSO
52       [rtcSetGeometryBuffer], [rtcSetNewGeometryBuffer]
53
54
55
56                                                 rtcSetSharedGeometryBuffer(3)