1rtcSetSceneBuildQuality(3)Embree Ray Tracing Kernels 4rtcSetSceneBuildQuality(3)
2
3
4
5   NAME
6              rtcSetSceneBuildQuality - sets the build quality for
7                the scene
8
9   SYNOPSIS
10              #include <embree4/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.  When high quality mode is enabled, filter  callbacks
34         may be invoked multiple times for the same geometry.
35
36       Selecting  a  higher  build quality results in better rendering perfor‐
37       mance but slower scene commit times.  The default build quality  for  a
38       scene is RTC_BUILD_QUALITY_MEDIUM.
39
40   EXIT STATUS
41       On  failure  an  error  code is set that can be queried using rtcGetDe‐
42       viceError.
43
44   SEE ALSO
45       [rtcSetGeometryBuildQuality]
46
47
48
49                                                    rtcSetSceneBuildQuality(3)