raisin::DynamicQualityRecommendation

struct · #include <rayrai/RenderDiagnostics.hpp>

Quality reduction suggested from measured pass timings (RayraiWindow::recommendDynamicQuality()). Never applied automatically.

GPU budgets are 6 ms (Fast) and 8 ms (Balanced/Custom); High and Ultra are reported against 12 / 16.6 ms but never changed. Pass times are grouped by name: "shadow"; "scene_color", "clear_background" and "planar_reflection" (scene); "postprocess".

Public attributes

changed

bool changed

recommendedSettings differs from the input settings.

fillRateBound

bool fillRateBound

Scene + post-process take at least 50 % of the GPU time.

shadowBound

bool shadowBound

Shadow passes take at least 35 % of the GPU time.

postprocessBound

bool postprocessBound

Post-process takes at least 35 % and no less than the scene passes.

totalGpuMs

double totalGpuMs

Sum of all positive pass timings, ms.

shadowGpuMs

double shadowGpuMs

Sum of passes whose name contains "shadow", ms.

sceneGpuMs

double sceneGpuMs

Sum of the scene-color passes, ms.

postprocessGpuMs

double postprocessGpuMs

Sum of passes whose name contains "postprocess", ms.

targetFrameMs

float targetFrameMs

GPU budget for the preset, ms.

recommendedRenderScale

float recommendedRenderScale

Suggested viewerRenderScale (x0.85 per step, floor 0.60 Fast / 0.75 otherwise).

recommendedUpdateShadowsEveryFrame

bool recommendedUpdateShadowsEveryFrame

Suggested updateShadowsEveryFrame.

recommendedBloomQuality

int recommendedBloomQuality

Suggested bloomQuality.

recommendedScreenSpaceAoSamples

int recommendedScreenSpaceAoSamples

Suggested screenSpaceAoSamples.

recommendedScreenSpaceAoDenoiseEnabled

bool recommendedScreenSpaceAoDenoiseEnabled

Suggested screenSpaceAoDenoiseEnabled.

recommendedSettings

RenderQualitySettings recommendedSettings

Input settings with all suggestions applied.

reason

std::string reason

'+'-joined decision tags, or e.g. "within_budget", "quality_preset_preserves_fidelity".