1rtcSetGeometryBuildQualityE(m3b)ree Ray Tracing Kernelrstc3SetGeometryBuildQuality(3)
2
3
4
5   NAME
6              rtcSetGeometryBuildQuality - sets the build quality for the geometry
7
8   SYNOPSIS
9              #include <embree3/rtcore.h>
10
11              void rtcSetGeometryBuildQuality(
12                RTCGeometry geometry,
13                enum RTCBuildQuality quality
14              );
15
16   DESCRIPTION
17       The rtcSetGeometryBuildQuality function sets the build quality (quality
18       argument) for the specified geometry (geometry argument).  The  per-ge‐
19       ometry  build  quality  is only a hint and may be ignored.  Embree cur‐
20       rently uses the per-geometry build quality when the scene build quality
21       is set to RTC_BUILD_QUALITY_LOW.  In this mode a two-level acceleration
22       structure is build, and geometries build a separate acceleration struc‐
23       ture  using the geometry build quality.  The per-geometry build quality
24       can be one of:
25
26       • RTC_BUILD_QUALITY_LOW:  Creates  lower   quality   data   structures,
27         e.g. for dynamic scenes.
28
29       • RTC_BUILD_QUALITY_MEDIUM:  Default  build  quality  for  most usages.
30         Gives a good compromise between build and render performance.
31
32       • RTC_BUILD_QUALITY_HIGH: Creates higher quality  data  structures  for
33         final-frame  rendering.   Enables a spatial split builder for certain
34         primitive types.
35
36       • RTC_BUILD_QUALITY_REFIT: Uses a BVH refitting approach when  changing
37         only the vertex buffer.
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       [rtcSetSceneBuildQuality]
45
46
47
48                                                 rtcSetGeometryBuildQuality(3)