rtcRetainDevice(3)

✨ NAME ✨

rtcRetainDevice — bestie, it increments the device reference count 💅

🦋 SYNOPSIS 🦋

#include <embree3/rtcore.h>

void rtcRetainDevice(RTCDevice device);

🌸 DESCRIPTION 🌸

okay so real talk: device objects are reference counted. That's just how they live. 🫶

The rtcRetainDevice function increments the reference count of the device object you hand it (the device argument). That's it. That's the whole job. She's doing one thing and doing it flawlessly, main character energy honestly.

And like — why do you care? Because this function, paired up with rtcReleaseDevice, is literally the move that lets you use the internal reference counting inside a C++ wrapper class to manage the ownership of the object. So your wrapper stays cute, your ownership story stays clean, everybody wins. ✨

🎀 EXIT STATUS 🎀

If something goes wrong, an error code gets set — and you can go query it with rtcGetDeviceError. So if it's giving silence but you're suspicious, that's where you check. 😭

💜 SEE ALSO 💜

• [rtcNewDevice]
• [rtcReleaseDevice]

okay that's the whole page, you ate that 🍓 stay hydrated, go retain some devices responsibly, and remember: every retain wants its release, no cap. 🧚‍♀️

this lil writeup lives in the Embree Ray Tracing Kernels 3 manual — mwah, bye bestie 💖