rtcFilterIntersection(3)

✨ rtcFilterIntersection(3) ✨

okay bestie, welcome to Embree Ray Tracing Kernels 3 🎀 — this is the manual page for rtcFilterIntersection, and yes it's giving niche-but-iconic. sit down, hydrate, let's go 💖

💫 NAME 💫

rtcFilterIntersection — invokes the intersection filter function

🌸 SYNOPSIS 🌸

#include <embree3/rtcore.h>

void rtcFilterIntersection(
  const struct RTCIntersectFunctionNArguments* args,
  const struct RTCFilterFunctionNArguments* filterArgs
);

🦋 DESCRIPTION 🦋

so, the way that rtcFilterIntersection works is that you call it inside an RTCIntersectFunctionN callback function, and its whole job is to invoke the intersection filter that's registered to the geometry and stored inside the context. like, you're the middleman and this is the handoff 🤝

for that, you gotta create an RTCFilterFunctionNArguments structure (peep rtcSetGeometryIntersectFilterFunction for the deets). and what's in that lil struct? basically:

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

then, after the invocation of rtcFilterIntersection, only rays that are still valid (valid mask set to -1) should update a hit. that's the vibe check: -1 or you're not updating anything, periodt 💅

💀 EXIT STATUS 💀

for performance reasons, this function does not do any error checks, so it will not set any error flags on failure. no cap. it's fast because it's unbothered 🙈

👑 SEE ALSO 👑

• rtcFilterOcclusion
• rtcSetGeometryIntersectFunction

and that's the whole page, bestie!! this was rtcFilterIntersection(3) from Embree Ray Tracing Kernels 3 — go forth, filter those intersections, and slay ✨🫶🌸