1rtcSetGeometryMask(3)    Embree Ray Tracing Kernels 3    rtcSetGeometryMask(3)
2
3
4
5   NAME
6              rtcSetGeometryMask - sets the geometry mask
7
8   SYNOPSIS
9              #include <embree3/rtcore.h>
10
11              void rtcSetGeometryMask(
12                RTCGeometry geometry,
13                unsigned int mask
14              );
15
16   DESCRIPTION
17       The rtcSetGeometryMask function sets a 32-bit geometry mask (mask argu‐
18       ment) for the specified geometry (geometry argument).
19
20       This geometry mask is used together with the ray mask stored inside the
21       mask  field  of the ray.  The primitives of the geometry are hit by the
22       ray only if the bitwise and operation of the geometry mask with the ray
23       mask is not 0.  This feature can be used to disable selected geometries
24       for specifically tagged rays, e.g. to disable shadow casting  for  cer‐
25       tain geometries.
26
27       Ray masks are disabled in Embree by default at compile time, and can be
28       enabled through the EMBREE_RAY_MASK parameter in CMake.  One can  query
29       whether  ray  masks  are  enabled  by  querying  the RTC_DEVICE_PROPER‐
30       TY_RAY_MASK_SUPPORTED device property using rtcGetDeviceProperty.
31
32   EXIT STATUS
33       On failure an error code is set that can  be  queried  using  rtcGetDe‐
34       viceError.
35
36   SEE ALSO
37       [RTCRay], [rtcGetDeviceProperty]
38
39
40
41                                                         rtcSetGeometryMask(3)