rtcSetGeometryMask(3)

💖 rtcSetGeometryMask(3) 💖

okay bestie, welcome to the Embree Ray Tracing Kernels 4 manual, and today's main character is rtcSetGeometryMask — she sets the geometry mask, and honestly? she ate. 🎀

---

✨ NAME ✨

rtcSetGeometryMask — sets the geometry mask. that's it, that's the girl. 👑

---

🌸 SYNOPSIS 🌸

#include <embree4/rtcore.h>

void rtcSetGeometryMask(
  RTCGeometry geometry,
  unsigned int mask
);

---

🦋 DESCRIPTION 🦋

so rtcSetGeometryMask sets a 32-bit geometry mask — that's the mask argument, bestie — for the geometry you point at with the geometry argument. literally just handing your geometry a little 32-bit name tag. 💅

and here's the tea ☕: this geometry mask gets used together with the ray mask that lives inside the mask field of the ray. the primitives of the geometry get hit by the ray only if the bitwise and operation of the geometry mask with the ray mask is not 0. no bits matching? no hit. periodt.

the way this is useful?? you can use it to disable selected geometries for specifically tagged rays — like, for example, to disable shadow casting for certain geometries. iconic behaviour honestly. 🌈✨

---

💀 EXIT STATUS 💀

if something goes wrong, an error code gets set, and you can go ask about it with rtcGetDeviceError. she'll tell you what happened, no cap. 🫶

---

👑 SEE ALSO 👑

• [RTCRay]
• [rtcGetDeviceProperty]

---

k bye bestie, go set some masks, you're doing amazing sweetie 💜🌸 — with love from the Embree Ray Tracing Kernels 4 manual, section 3, rtcSetGeometryMask(3). mwah. 😭💖