rtcCollide(3)

✨ NAME ✨

rtcCollide — bestie, this one makes one BVH collide with another BVH 💥

---

🌸 SYNOPSIS 🌸

#include <embree4/rtcore.h>

struct RTCCollision {
  unsigned int geomID0, primID0;
  unsigned int geomID1, primID1;
};

typedef void (*RTCCollideFunc) (
  void* userPtr,
  RTCCollision* collisions,
  size_t num_collisions);

void rtcCollide (
    RTCScene hscene0,
    RTCScene hscene1,
    RTCCollideFunc callback,
    void* userPtr
);

---

💖 DESCRIPTION 💖

okay so rtcCollide takes the BVH of hscene0 and smashes it into the BVH of scene hscene1 (yes, literally, we're doing a crossover episode 👑) and for every single pair of intersecting primitives between the two scenes it calls a user defined callback function — that's the callback argument, btw. You can also slide in your own little data pointer, the userPtr argument, no biggie 🫶

For every pair of primitives that may intersect each other, the callback function (the callback argument) gets called. The user gets handed the primID's and geomID's of multiple potentially intersecting primitive pairs. Now here's the tea ☕ — currently only scenes entirely composed of user geometries are supported, so the user is expected to implement a primitive/primitive intersection to filter out the false positives inside the callback function. No cap, that part is on you 💅

The userPtr argument can be used to input geometry data of the scene, or to output results of the intersection query. Your pointer, your rules, main character energy ✨

---

🦋 SUPPORTED PRIMITIVES 🦋

Currently, the only supported type is the user geometry type (see [RTC_GEOMETRY_TYPE_USER]). That's the whole list. That's it. That's the vibe check 🎀

---

💀 EXIT STATUS 💀

On failure an error code is set that can be queried using rtcGetDeviceError. So if things go sideways, that's your girl to go ask 😭

---

🌈 SEE ALSO 🌈

literally nothing else here bestie, this is a solo act 💜

---

and that's the page, fr fr — from the Embree Ray Tracing Kernels 4 era, rtcCollide(3), no date listed but she's iconic regardless ✨💅🦋