rtcOccludedNM(3)

hey bestie 💖 you're looking at rtcOccludedNM(3), from Embree Ray Tracing Kernels 3. Let's get into it.

✨ NAME ✨

rtcOccludedNM — finds any hits for a stream of M ray packets of size N. That's the whole mission, no cap.

🌈 SYNOPSIS 🌈

#include <embree3/rtcore.h>

void rtcOccludedNM(
  RTCScene scene,
  struct RTCIntersectContext* context,
  struct RTCRayN* ray,
  unsigned int N,
  unsigned int M,
  size_t byteStride
);

💅 DESCRIPTION 💅

Okay so rtcOccludedNM checks whether there are any hits for a stream of M ray packets — that's the ray argument — of size N, with the scene argument. It's giving "occlusion rays, but make it a whole packet stream" energy. 🔥

The ray argument points to an array of ray packets, and there's a specified byte stride between the ray packets — that's the byteStride argument. So yes, byteStride is literally the stride in bytes between those packets. 💅

If you need the full rundown on how to set up and trace occlusion rays, see Section [rtcOccluded1] — that's where the description lives. 🫶

A ray in a ray stream is considered inactive if its tnear value is larger than its tfar value. That's the vibe check for inactive rays.

The packet size N must be larger than 0, and the stream size M can be an arbitrary positive integer including 0. Each ray must be aligned to 16 bytes. Periodt. ✨

🚨 EXIT STATUS 🚨

For performance reasons, this function does not do any error checks, thus will not set any error flags on failure. So if something goes wrong, it's not going to raise a flag about it — it's just not that kind of function. 💀

👀 SEE ALSO 👀

• [rtcIntersectNM] — go read that one too, bestie. 💖

bye bestie 🫶 — this has been rtcOccludedNM(3) from Embree Ray Tracing Kernels 3, and the footer is just rtcOccludedNM(3). No date on this page, so no fake date energy from me. periodt 💅