Struct CupertinoDynamicColor 

pub struct CupertinoDynamicColor {
    pub color: Color,
    pub dark_color: Color,
    pub high_contrast_color: Color,
    pub dark_high_contrast_color: Color,
    pub elevated_color: Color,
    pub dark_elevated_color: Color,
    pub high_contrast_elevated_color: Color,
    pub dark_high_contrast_elevated_color: Color,
    pub debug_label: Option<&'static str>,
}

A colour that adapts: up to eight values for one name, one for each combination of a light or dark interface, normal or high contrast, and the base or the elevated level.

resolve picks the one that applies where it is used; resolve_with picks it for conditions given outright. Used as a plain Color without being resolved (Color::from), it is its light, normal-contrast, base value, as the reference’s is.

Most colours vary along fewer than three of the axes, and two constructors say so: with_brightness and with_brightness_and_contrast. The palette is CupertinoColors.

use frus_widgets::{Brightness, Color, CupertinoDynamicColor, CupertinoUserInterfaceLevelData};

let ink = CupertinoDynamicColor::with_brightness(Color::rgb8(20, 20, 20), Color::rgb8(240, 240, 240));
let dark = ink.resolve_with(Brightness::Dark, CupertinoUserInterfaceLevelData::Base, false);
assert_eq!(dark, Color::rgb8(240, 240, 240));

Fields

color: Color

Light, normal contrast, base level.

dark_color: Color

Dark, normal contrast, base level.

high_contrast_color: Color

Light, high contrast, base level.

dark_high_contrast_color: Color

Dark, high contrast, base level.

elevated_color: Color

Light, normal contrast, elevated.

dark_elevated_color: Color

Dark, normal contrast, elevated.

high_contrast_elevated_color: Color

Light, high contrast, elevated.

dark_high_contrast_elevated_color: Color

Dark, high contrast, elevated.

debug_label: Option<&'static str>

A name to tell it by when it is printed; it takes no part in equality.

Implementations

impl CupertinoDynamicColor

pub const fn new( color: Color, dark_color: Color, high_contrast_color: Color, dark_high_contrast_color: Color, elevated_color: Color, dark_elevated_color: Color, high_contrast_elevated_color: Color, dark_high_contrast_elevated_color: Color, ) -> CupertinoDynamicColor

A colour that varies along all three axes: all eight values, given outright.

pub const fn with_brightness_and_contrast( color: Color, dark_color: Color, high_contrast_color: Color, dark_high_contrast_color: Color, ) -> CupertinoDynamicColor

A colour that varies with the brightness and the contrast, and is the same at either level.

pub const fn with_brightness( color: Color, dark_color: Color, ) -> CupertinoDynamicColor

A colour that varies with the brightness alone.

pub const fn labelled(self, label: &'static str) -> CupertinoDynamicColor

The same colour, printed as label.

pub fn resolve_with( &self, brightness: Brightness, level: CupertinoUserInterfaceLevelData, high_contrast: bool, ) -> Color

The value for these conditions: a brightness, a level, and whether the reader has asked for high_contrast.

pub fn resolve(&self, theme: &Theme) -> Color

The value where it is used: in the brightness of the Apple-style theme under theme (CupertinoTheme::brightness_of), at the level theme says its subtree is at, and in high contrast if the reader has asked for it (Accessibility::high_contrast, read from the ambient MediaQuery).

That brightness is the theme’s, not the system’s, unless the theme says otherwise: an application that keeps a light theme on a dark system gets the light values, as the reference’s adaptive colours under its main theme do.

Trait Implementations

impl Clone for CupertinoDynamicColor

fn clone(&self) -> CupertinoDynamicColor

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CupertinoDynamicColor

impl Debug for CupertinoDynamicColor

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

Formats the value using the given formatter.

impl From<Color> for CupertinoDynamicColor

A plain colour as an adaptive one: the same in every condition, so that a theme takes either where it takes a colour.

fn from(c: Color) -> CupertinoDynamicColor

Converts to this type from the input type.

impl From<CupertinoDynamicColor> for Color

An adaptive colour used without being resolved: its light, normal-contrast, base value.

fn from(c: CupertinoDynamicColor) -> Color

Converts to this type from the input type.

impl PartialEq for CupertinoDynamicColor

Equal when all eight values are: the label is only a name.

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

Equality operator ==.

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

Inequality operator !=.