rtcNewBuffer(3)

💖 rtcNewBuffer(3) — the Embree Ray Tracing Kernels 3 era 💖

okay bestie, so this is rtcNewBuffer(3) from the Embree Ray Tracing Kernels 3 manual, section 3, and she's a lil function that hands you a fresh data buffer. let's get into it ✨

---

🌸 NAME 🌸

rtcNewBuffer — creates a new data buffer 💅

---

🎀 SYNOPSIS 🎀

#include <embree3/rtcore.h>

RTCBuffer rtcNewBuffer(
  RTCDevice device,
  size_t byteSize
);

like. that's it. that's the whole vibe. 🦋

---

✨ DESCRIPTION ✨

so rtcNewBuffer literally creates a brand new data buffer object, of the size you specify in bytes (that's the byteSize argument, bestie, it's giving very self-explanatory 👑), and that buffer gets bound to the device you pass in (the device argument, yup).

here's the tea tho 🍓: the buffer object is reference counted, with an initial reference count of 1. so when you're done with it, you release that returned buffer object using the rtcReleaseBuffer API call. that's the whole cycle. she's self-sufficient. main character energy fr fr.

and the way that the specified number of bytes get allocated at buffer construction time and deallocated when the buffer is destroyed</>? no cap, that's just how she operates. 💀

---

😭 EXIT STATUS 😭

if it fails, you get NULL back, and an error code gets set — which you can query using rtcGetDeviceError. so like, if you get NULL, don't panic, just go check the error code, she'll tell you what happened 🫶

ngl, always check for NULL okay?? it's giving "I warned you" energy if you don't 🙈

---

👑 SEE ALSO 👑

• rtcRetainBuffer
• rtcReleaseBuffer

iykyk, the retain/release duo is iconic and you'll be seeing them a lot 🌈

---

aaaand that's the page babes 💜 this one comes from the Embree Ray Tracing Kernels 3 manual, page rtcNewBuffer(3). go forth and buffer responsibly, mwah 🎀✨