rtcRetainBVH(3)

💖 rtcRetainBVH(3) 💖

okay bestie, welcome to the Embree Ray Tracing Kernels 4 corner of the manual, where we're talking about rtcRetainBVH and honestly? it's giving "tiny function, big responsibility". 🫶

✨ NAME ✨

rtcRetainBVH — increments the BVH reference count 💅

✨ SYNOPSIS ✨

#include <embree4/rtcore.h>

void rtcRetainBVH(RTCBVH bvh);

✨ DESCRIPTION ✨

so here's the tea, bestie: BVH objects are reference counted. that's just how they live. 🦋

the rtcRetainBVH function increments the reference count of the BVH object you pass in (that's the bvh argument, she's the main character here 👑).

and the way this function vibes with rtcReleaseBVH? iconic duo fr fr. together they let you use the internal reference counting inside a C++ wrapper class to handle the ownership of the object. no cap. ✨

✨ EXIT STATUS ✨

if something goes wrong, an error code gets set, and you can go query it with rtcGetDeviceError. so like, if it's acting up, that's where the receipts are. 😭

✨ SEE ALSO ✨

• [rtcNewBVH]
• [rtcReleaseBVH]

and that's the whole page, periodt. 💖 this lil masterpiece lives in Embree Ray Tracing Kernels 4, page rtcRetainBVH(3) — go forth and manage your ownership responsibly, bestie 🎀🌸