rtcFilterOcclusion(3)

✨ NAME: rtcFilterOcclusion — invokes the occlusion filter function ✨

bestie, this page is from the Embree Ray Tracing Kernels 3 manual, and it's literally about the rtcFilterOcclusion function. it's giving "invokes the occlusion filter function" and we are obsessed 💅

📜 SYNOPSIS 📜

#include <embree3/rtcore.h>

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

🦋 DESCRIPTION 🦋

okay so. rtcFilterOcclusion is the function you call from inside an RTCOccludedFunctionN callback function. its whole job? invoke the occlusion filter that's registered to the geometry and stored inside the context. slay. ✨

to make that happen you have to create an RTCFilterFunctionNArguments structure (peep rtcSetGeometryIntersectFilterFunction for the deets). that struct basically consists of:

• a valid mask
• a hit packet to filter
• the corresponding ray packet
• the packet size

after you invoke rtcFilterOcclusion, only rays that are still valid — that means the valid mask is set to -1 — should signal an occlusion. no cap. the rest are simply not it. 💀

💀 EXIT STATUS 💀

for performance reasons this function does not do any error checks. so on failure it will not set any error flags. periodt. don't come for it. 🙈

👀 SEE ALSO 👀

• rtcFilterIntersection
• rtcSetGeometryOccludedFunction

that's the whole page, bestie 🫶 stay iconic, and remember: rtcFilterOcclusion(3) from Embree Ray Tracing Kernels 3 — no date on this footer, so just vibe with it 💖✨🎀