1rtcSetSceneFlags(3) Embree Ray Tracing Kernels 4 rtcSetSceneFlags(3)
2
3
4
5 NAME
6 rtcSetSceneFlags - sets the flags for the scene
7
8 SYNOPSIS
9 #include <embree4/rtcore.h>
10
11 enum RTCSceneFlags
12 {
13 RTC_SCENE_FLAG_NONE = 0,
14 RTC_SCENE_FLAG_DYNAMIC = (1 << 0),
15 RTC_SCENE_FLAG_COMPACT = (1 << 1),
16 RTC_SCENE_FLAG_ROBUST = (1 << 2),
17 RTC_SCENE_FLAG_FILTER_FUNCTION_IN_ARGUMENTS = (1 << 3)
18 };
19
20 void rtcSetSceneFlags(RTCScene scene, enum RTCSceneFlags flags);
21
22 DESCRIPTION
23 The rtcSetSceneFlags function sets the scene flags (flags argument) for
24 the specified scene (scene argument). Possible scene flags are:
25
26 • RTC_SCENE_FLAG_NONE: No flags set.
27
28 • RTC_SCENE_FLAG_DYNAMIC: Provides better build performance for dynamic
29 scenes (but also higher memory consumption).
30
31 • RTC_SCENE_FLAG_COMPACT: Uses compact acceleration structures and
32 avoids algorithms that consume much memory.
33
34 • RTC_SCENE_FLAG_ROBUST: Uses acceleration structures that allow for
35 robust traversal, and avoids optimizations that reduce arithmetic ac‐
36 curacy. This mode is typically used for avoiding artifacts caused by
37 rays shooting through edges of neighboring primitives.
38
39 • RTC_SCENE_FLAG_FILTER_FUNCTION_IN_ARGUMENTS: Enables scene support
40 for filter functions passed as argument to the traversal functions.
41 See Section [rtcInitIntersectArguments] and [rtcInitOccludedArgu‐
42 ments] for more details.
43
44 Multiple flags can be enabled using an or operation,
45 e.g. RTC_SCENE_FLAG_COMPACT | RTC_SCENE_FLAG_ROBUST.
46
47 EXIT STATUS
48 On failure an error code is set that can be queried using rtcGetDe‐
49 viceError.
50
51 SEE ALSO
52 [rtcGetSceneFlags]
53
54
55
56 rtcSetSceneFlags(3)