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
19       per-geometry  build  quality is only a hint and may be ignored.  Embree
20       currently uses the per-geometry build  quality  when  the  scene  build
21       quality  is  set  to  RTC_BUILD_QUALITY_LOW.   In this mode a two-level
22       acceleration structure is build, and geometries build a separate accel‐
23       eration  structure  using the geometry build quality.  The per-geometry
24       build quality can be one of:
25
26       · RTC_BUILD_QUALITY_LOW: Creates lower quality  data  structures,  e.g.
27         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)