rtcOccludedNp(3)

✨ rtcOccludedNp(3) ✨

ok so bestie, we're in the Embree Ray Tracing Kernels 3 manual, and today's main character is rtcOccludedNp — the function that finds any hits for a SOA ray stream of size N. no cap, she's giving efficiency queen energy 💅

---

🎀 NAME 🎀

rtcOccludedNp — finds any hits for a SOA ray stream of size N

---

🦋 SYNOPSIS 🦋

#include <embree3/rtcore.h>

void rtcOccludedNp(
  RTCScene scene,
  struct RTCIntersectContext* context,
  struct RTCRayNp* ray,
  unsigned int N
);

---

🌸 DESCRIPTION 🌸

so rtcOccludedNp literally checks whether there are any hits for a SOA ray stream (that's the ray argument, and she's of size N — basically a big ol' ray packet) against the scene (the scene argument). 🫶

here's the tea about ray: it points to a structure of pointers, with one pointer for each ray component. and each one of those pointers points to an array holding the ray component data for every single ray. the way this slaps is that the individual components of the SOA ray stream do not need to be stored sequentially in memory — which is exactly what makes it possible to have large, varying size ray packets in SOA layout. iconic behavior, honestly. ✨

if you wanna know how to actually set up and trace occlusion rays, go look at Section [rtcOccluded1], she has the full breakdown. 📖

heads up bestie: a ray in a ray stream is considered inactive if its tnear value is larger than its tfar value. 👀

the stream size N can be an arbitrary positive integer, including 0 (yes, zero counts, she's valid). and every single ray component array must be aligned to 16 bytes — that part is not a vibe, that part is a requirement. 😭

---

💀 EXIT STATUS 💀

for performance reasons, this function does not do any error checks, so she will not set any error flags on failure. periodt. no notes, just speed. 🔥

---

🌈 SEE ALSO 🌈

• [rtcIntersectNp]

---

and that's the whole page, bestie! 💖 this one came straight out of the Embree Ray Tracing Kernels 3 manual, and the page is rtcOccludedNp(3). go forth and trace those occlusion rays, you absolute legend 👑 🧚 ⭐