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. for
23         dynamic scenes.  A two-level spatial index structure  is  built  when
24         enabling  this  mode,  which supports fast partial scene updates, and
25         allows for setting a per-geometry build quality through the rtcSetGe‐
26         ometryBuildQuality 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)