raisin::ExposureRecommendation

struct · #include <rayrai/Capture.hpp>

Bounded exposure suggestion derived from RgbaLuminanceMetrics (RayraiWindow::recommendExposure()). Never applied automatically.

Highlights are controlled first (p95 above target or more than 1 % clipped channels), then midtones are lifted (median below 70 % of target) or lowered (above 135 %).

Public attributes

valid

bool valid

False when the inputs were invalid (reason "invalid_input").

changed

bool changed

True when the recommended scale differs from 1 by more than 2 %.

underexposed

bool underexposed

Midtones are below target.

overexposed

bool overexposed

Highlights or midtones are above target.

clippingRisk

bool clippingRisk

More than 1 % of channel values are clipped.

currentExposure

double currentExposure

Exposure the metrics were captured with.

recommendedExposure

double recommendedExposure

Suggested exposure, clamped to [minExposure, maxExposure].

recommendedExposureScale

double recommendedExposureScale

recommendedExposure / currentExposure.

targetMedianLuminance

double targetMedianLuminance

Target median display luminance used.

targetP95Luminance

double targetP95Luminance

Target 95th-percentile display luminance used.

minExposure

double minExposure

Lower exposure bound used.

maxExposure

double maxExposure

Upper exposure bound used.

reason

std::string reason

Decision tag, e.g. "within_target", "lift_midtones", "highlight_clipping".