rtcFilterIntersection(3)

💅 rtcFilterIntersection 💅

okay bestie, so this one is a function from Embree Ray Tracing Kernels 3 (manual page rtcFilterIntersection(3), iykyk) and it's literally the glow-up your intersection callback needs. let's get into it 🫶

✨ NAME ✨

rtcFilterIntersection — invokes the intersection filter function 💖

✨ SYNOPSIS ✨

#include <embree4/rtcore.h>

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

look at her. two struct pointers, zero drama. 🎀

✨ DESCRIPTION ✨

so here's the tea 🍓: you call rtcFilterIntersection from inside an RTCIntersectFunctionN callback function, and what it does is invoke the intersection filter that's registered to the geometry and stored inside the context. it's giving "middle management for your hits", no cap.

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

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

then after the invocation of rtcFilterIntersection, only the rays that are still valid (as in, the valid mask is set to -1) should update a hit. that's the rule, periodt. 💅

bestie pls remember: valid mask = -1 → still valid → allowed to update a hit. anything else? not invited to the function. 🙈

✨ EXIT STATUS ✨

for performance reasons this function does not do any error checks, so it will not set any error flags on failure. she's fast and she's not sorry about it 😭🔥

no error flags, no warnings, no little red text. if it goes wrong, it goes wrong quietly. that's the tradeoff for the speed, ngl. 💀

✨ SEE ALSO ✨

• rtcFilterOcclusion 🦋
• rtcSetGeometryIntersectFunction 🧚

and that's the whole page, bestie!! 💜 this was rtcFilterIntersection(3) from the Embree Ray Tracing Kernels 3 manual — no date on the page, just the source and the version, so that's all we got and we're obsessed with it anyway ✨👑🎀 slay, go filter those intersections 🌈💖