RTCINVOKEOCCLUDEDFILTERFROMGEOMETRY(3embree4)

💖 rtcInvokeOccludedFilterFromGeometry — from the Embree Ray Tracing Kernels 4 manual, bestie 💖

okay so picture this: you're deep in a user geometry callback, vibing, and you need the occlusion filter that's registered on your geometry to actually do its thing. That's literally this function. Its whole name is rtcInvokeOccludedFilterFromGeometry, which is a mouthful but honestly? iconic. Let's get into it. 🦋

✨ NAME ✨

rtcInvokeOccludedFilterFromGeometry — the function that invokes the occlusion filter function from the geometry. That's it, that's the job. No cap. 💅

🌸 SYNOPSIS 🌸

First things first, you gotta pull in the header:

#include <embree4/rtcore.h>

Then here's the signature, character for character, don't @ me:

void rtcInvokeOccludedFilterFromGeometry(
  const struct RTCOccludedFunctionNArguments* args,
  const struct RTCFilterFunctionNArguments* filterArgs
);

🎀 DESCRIPTION 🎀

So the tea is: rtcInvokeOccludedFilterFromGeometry is the function you call inside an RTCOccludedFunctionN user geometry callback function when you wanna invoke the occlusion filter that's registered to the geometry. Like, you're already in there, you just need to hand off to the filter. Go off, king. 👑

To do that you have to create an RTCFilterFunctionNArguments structure (peep rtcSetGeometryIntersectFilterFunction for the deets on that one, bestie — it's giving homework but it's fine). That struct basically consists of:

• a valid mask ✨
• a hit packet to filter 🎯
• the corresponding ray packet 🌈
• the packet size 📏

And here's the part you CANNOT skip, fr fr: after the invocation of rtcInvokeOccludedFilterFromGeometry, only rays that are still valid (valid mask set to -1) should signal an occlusion. Everything else? Not it. Don't be out here signaling occlusion for rays that already got filtered out, that's embarrassing. 😭

💀 EXIT STATUS 💀

For performance reasons, this function does not do any error checks. Zero. None. So on failure it will not set any error flags. It's lowkey just built different — speed over safety, and you're expected to keep up. 🫶

👑 SEE ALSO 👑

• rtcInvokeIntersectFilterFromGeometry
• rtcSetGeometryOccludedFunction

and that's the whole page, babe — rtcInvokeOccludedFilterFromGeometry(3), straight from the Embree Ray Tracing Kernels 4 manual. slay, go filter those occlusions, and remember: valid mask -1 or it didn't happen 💅✨🦋