Struct DisplayLuminance 

pub struct DisplayLuminance {
    pub max_nits: Option<f32>,
    pub max_full_frame_nits: Option<f32>,
    pub min_nits: Option<f32>,
    pub sdr_white_nits: Option<f32>,
}

Absolute luminance levels in nits (cd/m²). Populated only on Windows (via DXGI); None on every other platform.

Advisory: OS/EDID figures run optimistic. A 0.0 from the OS stays Some(0.0); absence is None. These are achromatic (luminance = CIE Y), not a per-color ceiling: a display can’t reach max_nits at a saturated chromaticity. Pair them with DisplayChromaticity for gamut mapping.

Fields

max_nits: Option<f32>

Peak luminance of a small patch, nits. DXGI MaxLuminance.

max_full_frame_nits: Option<f32>

Sustained full-white-frame luminance, nits: the ceiling for a fully-lit frame, which power/thermal limits can hold below the small-patch peak max_nits. May equal max_nits if the OS reports no distinct limit. Prefer it over max_nits for large bright regions; don’t derive it from max_nits. DXGI MaxFullFrameLuminance.

min_nits: Option<f32>

Minimum (black) luminance, nits. DXGI MinLuminance.

sdr_white_nits: Option<f32>

Luminance the OS maps SDR reference white to, nits; moves with the brightness slider. Converts between absolute nits and relative EDR headroom (max_nits / sdr_white_nits). Read via the DISPLAYCONFIG_SDR_WHITE_LEVEL query, separate from the other nits, so None only if that query fails.

Trait Implementations

impl Clone for DisplayLuminance

fn clone(&self) -> DisplayLuminance

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DisplayLuminance

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for DisplayLuminance

fn default() -> DisplayLuminance

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for DisplayLuminance

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for DisplayLuminance

fn eq(&self, other: &DisplayLuminance) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for DisplayLuminance

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for DisplayLuminance

impl StructuralPartialEq for DisplayLuminance