---
name: "rtcInitRayQueryContext"
section: "3"
platform: "linux"
package: "libembree-dev"
version: "4.3.3+dfsg-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/rtcInitRayQueryContext"
---

# rtcInitRayQueryContext(3)

### NAME

-

  ```
  rtcInitRayQueryContext - initializes the ray query context
  ```

### 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
  );
  ```

### DESCRIPTION

The `rtcInitRayQueryContext` function initializes the intersection context to default values and should be called to initialize every ray query context.

It is guaranteed that the pointer to the ray query context (`RTCRayQueryContext` type) is passed to the registered callback functions. This way it is possible to attach arbitrary data to the end of the ray query context, such as a per-ray payload.

Inside the user geometry callback the ray query context can get used to access the `instID` stack to know which instance the user geometry object resides.

If not ray query context is specified when tracing a ray, a default context is used.

### EXIT STATUS

No error code is set by this function.

### SEE ALSO

\[rtcIntersect1\], \[rtcIntersect4/8/16\], \[rtcOccluded1\], \[rtcOccluded4/8/16\]