1% rtcOccludedNp(3) | Embree Ray Tracing Kernels 3
2
3#### NAME
4
5    rtcOccludedNp - finds any hits for a SOA ray stream of size N
6
7#### SYNOPSIS
8
9    #include <embree3/rtcore.h>
10
11    void rtcOccludedNp(
12      RTCScene scene,
13      struct RTCIntersectContext* context,
14      struct RTCRayNp* ray,
15      unsigned int N
16    );
17
18#### DESCRIPTION
19
20The `rtcOccludedNp` function checks whether there are any hits for a
21SOA ray stream (`ray` argument) of size `N` (basically a large ray
22packet) with the scene (`scene` argument). The `ray` argument points
23to a structure of pointers with one pointer for each ray component.
24Each of these pointers points to an array with the ray component data
25for each ray. This way the individual components of the SOA ray stream
26do not need to be stored sequentially in memory, which makes it
27possible to have large varying size ray packets in SOA layout. See
28Section [rtcOccluded1] for a description of how to set up and trace
29occlusion rays.
30
31``` {include=src/api/inc/context.md}
32```
33
34``` {include=src/api/inc/reorder.md}
35```
36
37A ray in a ray stream is considered inactive if its `tnear` value is
38larger than its `tfar` value.
39
40The stream size `N` can be an arbitrary positive integer including 0.
41Each ray component array must be aligned to 16 bytes.
42
43#### EXIT STATUS
44
45For performance reasons this function does not do any error checks,
46thus will not set any error flags on failure.
47
48#### SEE ALSO
49
50[rtcIntersectNp]
51