raisin::RayraiWindow::ExposureRecommendation

struct · #include <rayrai/RayraiWindow.hpp>

Result of recommendExposure(); the target/limit fields echo the inputs.

Public attributes

valid

bool valid

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

changed

bool changed

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

underexposed

bool underexposed

Midtones are below 70 % of the target median.

overexposed

bool overexposed

Highlights exceed the p95 target or midtones exceed 135 % of the target median.

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 luminance used.

targetP95Luminance

double targetP95Luminance

Target 95th percentile luminance used.

minExposure

double minExposure

Lower exposure bound used.

maxExposure

double maxExposure

Upper exposure bound used.

reason

std::string reason

Machine-readable reason, e.g. highlight_clipping, lift_midtones, within_target.