RTCSETSCENEBUILDQUALITY(3embree3)

✨ NAME ✨

rtcSetSceneBuildQuality — sets the build quality for the scene 💅

okay so bestie, this is the one that tells your scene how hard it should be working. we're talking Embree Ray Tracing Kernels 3, manual page rtcSetSceneBuildQuality(3). let's get into it 🦋

🌸 SYNOPSIS 🌸

#include <embree3/rtcore.h>

void rtcSetSceneBuildQuality(
  RTCScene scene,
  enum RTCBuildQuality quality
);

💖 DESCRIPTION 💖

The rtcSetSceneBuildQuality function sets the build quality (that's the quality argument) for the specified scene (that's the scene argument, obviously). no cap. 🫶

Possible values for the build quality are:

• RTC_BUILD_QUALITY_LOW — creates lower quality data structures, like for dynamic scenes. when you enable this mode, a two-level spatial index structure gets built, and the way that it works is it supports fast partial scene updates, plus it lets you set a per-geometry build quality through the rtcSetGeometryBuildQuality function. it's giving flexible ✨
• RTC_BUILD_QUALITY_MEDIUM — the default build quality for most usages. gives you a good compromise between build performance and render performance. it's the safe pick, the main character of defaults 👑
• RTC_BUILD_QUALITY_HIGH — creates higher quality data structures for final-frame rendering. for certain geometry types this enables a spatial split BVH. iconic. 🔥

so here's the tea ☕ — selecting a higher build quality results in better rendering performance but slower scene commit times. that's the tradeoff, bestie, no way around it. the default build quality for a scene is RTC_BUILD_QUALITY_MEDIUM. periodt. 💅

😭 EXIT STATUS 😭

On failure an error code is set that can be queried using rtcGetDeviceError. so if something goes sideways, that's where you go lookin'. 🙈

🎀 SEE ALSO 🎀

• [rtcSetGeometryBuildQuality]

and that's the whole vibe, fr fr. this little manual page comes to you from Embree Ray Tracing Kernels 3 — rtcSetSce...ildQuality(3). go slay your BVH build, bestie 💜🌈⭐