rtcRetainBVH(3)

💖 rtcRetainBVH 💖

okay bestie, we're doing rtcRetainBVH(3) today — that's a page straight out of the Embree Ray Tracing Kernels 3 era, and yes, it's giving very much "tiny function, big responsibility" energy. 🦋

---

✨ NAME ✨

rtcRetainBVH — increments the BVH reference count

like... it literally just bumps the count up by one. that's the whole job. and she does it flawlessly. 💅

---

🌸 SYNOPSIS 🌸

#include <embree3/rtcore.h>

void rtcRetainBVH(RTCBVH bvh);

look at her. one include, one function, zero drama. 👑

---

🎀 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 hand it — that's the bvh argument, right there in the signature, no mystery. every call is you saying "yeah, I'm holding onto this one too." 💖

and the way that it works together with rtcReleaseBVH?? iconic. those two are a duo. this function plus rtcReleaseBVH lets you use the internal reference counting inside a C++ wrapper class to handle the ownership of the object. that's the whole point, that's the vibe, no cap. 🧚

lowkey important: retain and release are a matched set. you retain, you release, the object knows when it's done. don't ghost the release. 😭

---

⚠️ EXIT STATUS ⚠️

on failure, an error code is set that can be queried using rtcGetDeviceError.

so if something goes sideways, that's where you go looking. don't just sit there wondering — ask rtcGetDeviceError. she'll tell you. 💀

---

🌈 SEE ALSO 🌈

• rtcNewBVH
• rtcReleaseBVH

(the whole BVH friend group, fr fr 🍓)

---

and that's the page!! rtcRetainBVH(3), brought to you by the Embree Ray Tracing Kernels, version 3 — mwah, slay, periodt. 💜✨🎀