---
name: "rtcSetGeometryBuildQuality"
section: "3embree4"
platform: "linux"
package: "embree"
version: "4.4.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/rtcSetGeometryBuildQuality/3embree4"
---

# rtcSetGeometryBuildQuality(3embree4)

### NAME

-

  ```
  rtcSetGeometryBuildQuality - sets the build quality for the geometry
  ```

### SYNOPSIS

-

  ```
  #include <embree4/rtcore.h>
  void rtcSetGeometryBuildQuality(
    RTCGeometry geometry,
    enum RTCBuildQuality quality
  );
  ```

### DESCRIPTION

The `rtcSetGeometryBuildQuality` function sets the build quality (`quality` argument) for the specified geometry (`geometry` argument). The per-geometry build quality is only a hint and may be ignored. Embree currently uses the per-geometry build quality when the scene build quality is set to `RTC_BUILD_QUALITY_LOW`. In this mode a two-level acceleration structure is build, and geometries build a separate acceleration structure using the geometry build quality. The per-geometry build quality can be one of:

- •

  `RTC_BUILD_QUALITY_LOW`: Creates lower quality data structures, e.g. for dynamic scenes.

- •

  `RTC_BUILD_QUALITY_MEDIUM`: Default build quality for most usages. Gives a good compromise between build and render performance.

- •

  `RTC_BUILD_QUALITY_HIGH`: Creates higher quality data structures for final-frame rendering. Enables a spatial split builder for certain primitive types.

- •

  `RTC_BUILD_QUALITY_REFIT`: Uses a BVH refitting approach when changing only the vertex buffer.

### EXIT STATUS

On failure an error code is set that can be queried using `rtcGetDeviceError`.

### SEE ALSO

\[rtcSetSceneBuildQuality\]