RTCSETSCENEBUILDQUALITY(3)

✨ NAME ✨

rtcSetSceneBuildQuality β€” bestie, this one sets the build quality for the scene πŸ’…


🌸 SYNOPSIS 🌸

#include <embree4/rtcore.h>

void rtcSetSceneBuildQuality(
  RTCScene scene,
  enum RTCBuildQuality quality
);

πŸŽ€ DESCRIPTION πŸŽ€

Okay so, the rtcSetSceneBuildQuality function sets the build quality (that's the quality argument) for the specified scene (that's the scene argument). And the possible values for the build quality are literally these three, no more, no less πŸ‘‘

  • RTC_BUILD_QUALITY_LOW β€” creates lower quality data structures, e.g. for dynamic scenes. When you enable this mode, a two-level spatial index structure gets built, which supports fast partial scene updates, and it also lets you set a per-geometry build quality through the rtcSetGeometryBuildQuality function. lowkey the flexible one fr fr
  • RTC_BUILD_QUALITY_MEDIUM β€” the default build quality for most usages. It gives you a good compromise between build and render performance. the people's princess, the main character, the default ✨
  • RTC_BUILD_QUALITY_HIGH β€” creates higher quality data structures for final-frame rendering. For certain geometry types this enables a spatial split BVH. And heads up bestie β€” when high quality mode is enabled, filter callbacks may be invoked multiple times for the same geometry πŸ‘€ not a bug, just the vibe

So picking a higher build quality gives you better rendering performance but slower scene commit times. That's the tradeoff, no cap. And 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 your girl to go ask πŸ™ˆ


πŸ¦‹ SEE ALSO πŸ¦‹

  • [rtcSetGeometryBuildQuality]

okay that's the whole page, you ate that 🫢 this was the rtcSetSceneBuildQuality(3) page from the Embree Ray Tracing Kernels 4 manual, section 3, and yeah the footer was doing that little rtcSetSce...ildQuality(3) truncation thing because apparently even manpages get shy about long names πŸ’œ mwah, go build something iconic πŸŽ€βœ¨

πŸ“¦ where this page comes from