rtcOccluded1Mp(3)

rtcOccluded1Mp(3) 💖

okay bestie, welcome to the Embree Ray Tracing Kernels 3 corner of the manual, where we talk about rtcOccluded1Mp — the girl who can check a whole stream of rays for hits in one go and she does it with her whole chest 💅

✨ NAME ✨

rtcOccluded1Mp — find any hits for a stream of M pointers to single rays 🦋

✨ SYNOPSIS ✨

#include <embree3/rtcore.h>

void rtcOccluded1M(
  RTCScene scene,
  struct RTCIntersectContext* context,
  struct RTCRay** ray,
  unsigned int M
);

✨ DESCRIPTION ✨

so, rtcOccluded1Mp literally checks whether there are any hits for a stream of M single rays (that's your ray argument) with the scene (that's your scene argument, bestie). 🌸

and here's the lil detail that matters: the ray argument points to an array of pointers to rays. not rays, pointers to rays. periodt. if you wanna know how to set up and trace occlusion rays in the first place, run don't walk to section [rtcOccluded1] 💜

a ray in a ray stream is considered inactive if its tnear value is larger than its tfar value. so like... that ray is not giving. it's off the clock. 🙈

the stream size M can be an arbitrary positive integer including 0 — yes, zero is allowed, she contains multitudes. and every single ray must be aligned to 16 bytes. not 8, not "close enough", sixteen. do not test her on this. 😭

✨ EXIT STATUS ✨

for performance reasons this function does no error checks at all. she's too busy slaying. so on failure it will not set any error flags — you will simply Not Be Told. that's the trade-off, and honestly? iconic behavior. 👑

✨ SEE ALSO ✨

• [rtcIntersect1Mp] — her sibling, go say hi 🫶

and that's the whole page, bestie!! this was rtcOccluded1Mp(3) from the Embree Ray Tracing Kernels 3 manual. mwah, go trace something gorgeous. 💖✨🎀🦋🌸