rtcGetGeo...hreadSafe(3)

✨ rtcGetGeo...hreadSafe(3) ✨

okay bestie, welcome to the Embree Ray Tracing Kernels 3 manual, section 3, page rtcGetGeo...hreadSafe. yes the title is abbreviated with dots because the real name is a whole mouthful — it's rtcGetGeometryThreadSafe and we're gonna talk about her. 🎀

💖 NAME 💖

rtcGetGeometryThreadSafe — returns the geometry bound to the specified geometry ID

🌸 SYNOPSIS 🌸

#include <embree3/rtcore.h>

RTCGeometry rtcGetGeometryThreadSafe(RTCScene scene, unsigned int geomID);

🦋 DESCRIPTION 🦋

so, rtcGetGeometryThreadSafe hands you back the geometry that's bound to the geometry ID you pass in (that's the geomID argument, queen) inside the scene you specify (the scene argument, obviously 💅). that's the whole gig.

important tho: this function just looks up the handle and does not increment the reference count. it's giving window shopping, not buying. so if you actually want to own that handle — like, take custody, be responsible for it — you gotta additionally call rtcRetainGeometry. no cap. 🫶

and here's the vibe check: this function is thread safe, but it should NOT get used during rendering. i'm so serious. 😭 if you need a fast non-thread-safe version to use during rendering, please use the [rtcGetGeometry] function instead. that's literally what she's there for.

🌈 EXIT STATUS 🌈

if things go wrong, NULL is returned and an error code gets set — you can go query that error code using rtcGetDeviceError. 🙈

⭐ SEE ALSO ⭐

• [rtcAttachGeometry]
• [rtcAttachGeometryByID]
• [rtcGetGeometry]

okay that's the whole page, bestie, you ate that reading session 💅✨ this little cutie comes from the Embree Ray Tracing Kernels 3 collection, section 3, and the page signs off as rtcGetGeo...hreadSafe(3) — mwah, go call rtcGetGeometry during render like a good main character 👑🌸