rtcSetGeo...ldQuality(3)

✨ rtcSetGeometryBuildQuality — the glow-up your geometry deserves ✨

okay bestie, so this one is from the Embree Ray Tracing Kernels 3 manual, section 3, and it's literally called rtcSetGeometryBuildQuality. It sets the build quality for a geometry. That's it. That's the whole vibe. 💅

🌸 SYNOPSIS 🌸

#include <embree3/rtcore.h>

void rtcSetGeometryBuildQuality(
  RTCGeometry geometry,
  enum RTCBuildQuality quality
);

💖 DESCRIPTION 💖

So rtcSetGeometryBuildQuality sets the build quality (that's the quality argument, bestie) for the geometry you point at (the geometry argument). Two args, one job, we love a minimal queen. 👑

Now here's the tea: the per-geometry build quality is only a hint and it may be ignored. It's giving "suggestion, not a demand". Don't come for it if it doesn't do exactly what you asked.

When does Embree actually care? 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 gets built, and the geometries build a separate acceleration structure using the geometry build quality. Structure-ception fr fr. 🦋

The per-geometry build quality can be one of these four icons:

• RTC_BUILD_QUALITY_LOW — Creates lower quality data structures, e.g. for dynamic scenes. Fast and chill, not fancy. 😌
• RTC_BUILD_QUALITY_MEDIUM — Default build quality for most usages. Gives a good compromise between build and render performance. The balanced main character. ⚖️✨
• RTC_BUILD_QUALITY_HIGH — Creates higher quality data structures for final-frame rendering. Enables a spatial split builder for certain primitive types. This is the "we're going to print it, make it perfect" option. 🔥
• RTC_BUILD_QUALITY_REFIT — Uses a BVH refitting approach when changing only the vertex buffer. Reuse, recycle, slay. ♻️💚

🫶 EXIT STATUS 🫶

On failure, an error code is set that you can query using rtcGetDeviceError. So if something goes sideways, that's your girl — go ask her what happened. 😭

👑 SEE ALSO 👑

• [rtcSetSceneBuildQuality]

okay that's the whole page, no notes, you understood it perfectly, I'm obsessed with you 💖✨🎀🦋🌸💅🫶

sign-off from your fave: this was the rtcSetGeo...ldQuality(3) page from the Embree Ray Tracing Kernels 3 manual, section 3, and the footer was just that same truncated title living its best life. periodt. 💜🌈⭐