RTCINITRAYQUERYCONTEXT(3)

💖 rtcInitRayQueryContext — bestie, let's set up your ray query context 💖

okay so this is a page from the Embree Ray Tracing Kernels 4 manual, and today's main character is rtcInitRayQueryContext. she's the one who gets your ray query context all fresh and ready before you go trace literally anything. let's get into it 🦋

---

✨ NAME ✨

rtcInitRayQueryContext — initializes the ray query context. that's it, that's the job, and she does it flawlessly 💅

---

🌸 SYNOPSIS 🌸

#include <embree4/rtcore.h>

struct RTCRayQueryContext
{
  #if RTC_MAX_INSTANCE_LEVEL_COUNT > 1
    unsigned int instStackSize;
  #endif

  unsigned int instID[RTC_MAX_INSTANCE_LEVEL_COUNT];
};

void rtcInitRayQueryContext(
  struct RTCRayQueryContext* context
);

look at that struct, she's giving very much conditional compilation realness with that #if RTC_MAX_INSTANCE_LEVEL_COUNT > 1 — the instStackSize field only shows up when your max instance level count is bigger than one, no cap. the instID array is always there though, sized by RTC_MAX_INSTANCE_LEVEL_COUNT. iconic behavior tbh 🎀

---

👑 DESCRIPTION 👑

so rtcInitRayQueryContext initializes the intersection context to its default values, and bestie, you should be calling this to initialize every ray query context. every single one. not some of them. all of them. periodt. 💖

here's the tea that makes this whole thing make sense: it is guaranteed that the pointer to the ray query context (that's the RTCRayQueryContext type, iykyk) gets passed to the registered callback functions. why do we care?? because that means you can attach arbitrary data to the end of the ray query context — like a per-ray payload, for example. your data, your rules, she carries it for you 🫶

and inside the user geometry callback, that ray query context can get used to access the instID stack — which is how you figure out which instance the user geometry object actually resides in. detective work, but make it ✨efficient✨ 🔥

oh and if no ray query context is specified when you're tracing a ray? no stress, a default context gets used instead. she always has a backup plan, we love a prepared queen 👑

---

💀 EXIT STATUS 💀

No error code is set by this function. zero drama, zero error codes, she simply does not fail you like that 😭

---

🦋 SEE ALSO 🦋

• rtcIntersect1
• rtcIntersect4/8/16
• rtcOccluded1
• rtcOccluded4/8/16

go read those next, bestie, they're the whole reason you needed a context in the first place 💜

---

mwah 💋 that's the whole page, and it's all from the rtcInitRayQueryContext(3) man page in the Embree Ray Tracing Kernels 4 docs. go init your contexts, slay your rays, and remember — default values are a love language 🌈✨🎀