1rtcNewSharedBuffer(3)    Embree Ray Tracing Kernels 3    rtcNewSharedBuffer(3)
2
3
4
5   NAME
6              rtcNewSharedBuffer - creates a new shared data buffer
7
8   SYNOPSIS
9              #include <embree3/rtcore.h>
10
11              RTCBuffer rtcNewSharedBuffer(
12                RTCDevice device,
13                void* ptr,
14                size_t byteSize
15              );
16
17   DESCRIPTION
18       The rtcNewSharedBuffer function creates a new shared data buffer object
19       bound to the specified device (device argument).  The buffer object  is
20       reference counted with an initial reference count of 1.  The buffer can
21       be released using the rtcReleaseBuffer function.
22
23       At construction time, the pointer to the user-managed buffer data  (ptr
24       argument)  including  its size in bytes (byteSize argument) is provided
25       to create the buffer.  At buffer construction time no  buffer  data  is
26       allocated,  but  the  buffer  data provided by the application is used.
27       The buffer data must remain valid for as long  as  the  buffer  may  be
28       used,  and  the  user  is  responsible  to free the buffer data when no
29       longer required.
30
31       The data pointer (ptr argument) must be aligned to 4  bytes;  otherwise
32       the rtcNewSharedBuffer function will fail.
33
34   EXIT STATUS
35       On  failure  NULL  is  returned  and  an  error code is set that can be
36       queried using rtcGetDeviceError.
37
38   SEE ALSO
39       [rtcRetainBuffer], [rtcReleaseBuffer]
40
41
42
43                                                         rtcNewSharedBuffer(3)