1rtcSetSceneBuildQuality(3)Embree Ray Tracing Kernels 3rtcSetSceneBuildQuality(3)
2
3
4
5 NAME
6 rtcSetSceneBuildQuality - sets the build quality for
7 the scene
8
9 SYNOPSIS
10 #include <embree3/rtcore.h>
11
12 void rtcSetSceneBuildQuality(
13 RTCScene scene,
14 enum RTCBuildQuality quality
15 );
16
17 DESCRIPTION
18 The rtcSetSceneBuildQuality function sets the build quality (quality
19 argument) for the specified scene (scene argument). Possible values
20 for the build quality are:
21
22 · RTC_BUILD_QUALITY_LOW: Create lower quality data structures, e.g.
23 for dynamic scenes. A two-level spatial index structure is built
24 when enabling this mode, which supports fast partial scene updates,
25 and allows for setting a per-geometry build quality through the rtc‐
26 SetGeometryBuildQuality function.
27
28 · RTC_BUILD_QUALITY_MEDIUM: Default build quality for most usages.
29 Gives a good compromise between build and render performance.
30
31 · RTC_BUILD_QUALITY_HIGH: Create higher quality data structures for fi‐
32 nal-frame rendering. For certain geometry types this enables a spa‐
33 tial split BVH.
34
35 Selecting a higher build quality results in better rendering perfor‐
36 mance but slower scene commit times. The default build quality for a
37 scene is RTC_BUILD_QUALITY_MEDIUM.
38
39 EXIT STATUS
40 On failure an error code is set that can be queried using rtcGetDe‐
41 viceError.
42
43 SEE ALSO
44 [rtcSetGeometryBuildQuality]
45
46
47
48 rtcSetSceneBuildQuality(3)