Struct ColorU 

#[repr(C)]
pub struct ColorU {
    pub r: u8,
    pub g: u8,
    pub b: u8,
    pub a: u8,
}

u8-based color, range 0 to 255 (similar to webrenders ColorU)

Fields

r: u8

g: u8

b: u8

a: u8

Implementations

impl ColorU

pub const ALPHA_TRANSPARENT: u8 = 0

pub const ALPHA_OPAQUE: u8 = 255

pub const RED: ColorU

pub const GREEN: ColorU

pub const BLUE: ColorU

pub const WHITE: ColorU

pub const BLACK: ColorU

pub const TRANSPARENT: ColorU

pub const YELLOW: ColorU

pub const CYAN: ColorU

pub const MAGENTA: ColorU

pub const ORANGE: ColorU

pub const PINK: ColorU

pub const PURPLE: ColorU

pub const BROWN: ColorU

pub const GRAY: ColorU

pub const LIGHT_GRAY: ColorU

pub const DARK_GRAY: ColorU

pub const NAVY: ColorU

pub const TEAL: ColorU

pub const OLIVE: ColorU

pub const MAROON: ColorU

pub const LIME: ColorU

pub const AQUA: ColorU

pub const SILVER: ColorU

pub const FUCHSIA: ColorU

pub const INDIGO: ColorU

pub const GOLD: ColorU

pub const CORAL: ColorU

pub const SALMON: ColorU

pub const TURQUOISE: ColorU

pub const VIOLET: ColorU

pub const CRIMSON: ColorU

pub const CHOCOLATE: ColorU

pub const SKY_BLUE: ColorU

pub const FOREST_GREEN: ColorU

pub const SEA_GREEN: ColorU

pub const SLATE_GRAY: ColorU

pub const MIDNIGHT_BLUE: ColorU

pub const DARK_RED: ColorU

pub const DARK_GREEN: ColorU

pub const DARK_BLUE: ColorU

pub const LIGHT_BLUE: ColorU

pub const LIGHT_GREEN: ColorU

pub const LIGHT_YELLOW: ColorU

pub const LIGHT_PINK: ColorU

pub fn red() -> Self

pub fn green() -> Self

pub fn blue() -> Self

pub fn white() -> Self

pub fn black() -> Self

pub fn transparent() -> Self

pub fn yellow() -> Self

pub fn cyan() -> Self

pub fn magenta() -> Self

pub fn orange() -> Self

pub fn pink() -> Self

pub fn purple() -> Self

pub fn brown() -> Self

pub fn gray() -> Self

pub fn light_gray() -> Self

pub fn dark_gray() -> Self

pub fn navy() -> Self

pub fn teal() -> Self

pub fn olive() -> Self

pub fn maroon() -> Self

pub fn lime() -> Self

pub fn aqua() -> Self

pub fn silver() -> Self

pub fn fuchsia() -> Self

pub fn indigo() -> Self

pub fn gold() -> Self

pub fn coral() -> Self

pub fn salmon() -> Self

pub fn turquoise() -> Self

pub fn violet() -> Self

pub fn crimson() -> Self

pub fn chocolate() -> Self

pub fn sky_blue() -> Self

pub fn forest_green() -> Self

pub fn sea_green() -> Self

pub fn slate_gray() -> Self

pub fn midnight_blue() -> Self

pub fn dark_red() -> Self

pub fn dark_green() -> Self

pub fn dark_blue() -> Self

pub fn light_blue() -> Self

pub fn light_green() -> Self

pub fn light_yellow() -> Self

pub fn light_pink() -> Self

pub const fn rgba(r: u8, g: u8, b: u8, a: u8) -> Self

Creates a new color with RGBA values.

pub const fn rgb(r: u8, g: u8, b: u8) -> Self

Creates a new color with RGB values (alpha = 255).

pub const fn new(r: u8, g: u8, b: u8, a: u8) -> Self

Alias for rgba - kept for internal compatibility, not exposed in FFI.

pub const fn new_rgb(r: u8, g: u8, b: u8) -> Self

Alias for rgb - kept for internal compatibility, not exposed in FFI.

pub fn interpolate(&self, other: &Self, t: f32) -> Self

pub fn lighten(&self, amount: f32) -> Self

Lighten a color by a percentage (0.0 to 1.0). Returns a new color blended towards white.

pub fn darken(&self, amount: f32) -> Self

Darken a color by a percentage (0.0 to 1.0). Returns a new color blended towards black.

pub fn mix(&self, other: &Self, ratio: f32) -> Self

Mix two colors together with a given ratio (0.0 = self, 1.0 = other).

pub fn hover_variant(&self) -> Self

Create a hover variant (slightly lighter for dark colors, darker for light colors). This is useful for button hover states.

pub fn active_variant(&self) -> Self

Create an active/pressed variant (darker than hover). This is useful for button active states.

pub fn luminance(&self) -> f32

Calculate relative luminance (0.0 = black, 1.0 = white). Uses the sRGB luminance formula.

pub fn contrast_text(&self) -> Self

Returns white or black text color for best contrast on this background.

pub fn relative_luminance(&self) -> f32

Calculate relative luminance per WCAG 2.1 specification. Returns a value between 0.0 (darkest) and 1.0 (lightest). Uses the sRGB to linear conversion for accurate results.

pub fn contrast_ratio(&self, other: &Self) -> f32

Calculate the contrast ratio between this color and another. Returns a value between 1.0 (no contrast) and 21.0 (max contrast).

WCAG 2.1 requirements:

• AA normal text: >= 4.5:1
• AA large text: >= 3.0:1
• AAA normal text: >= 7.0:1
• AAA large text: >= 4.5:1

pub fn meets_wcag_aa(&self, other: &Self) -> bool

Check if the contrast ratio meets WCAG AA requirements for normal text (>= 4.5:1).

pub fn meets_wcag_aa_large(&self, other: &Self) -> bool

Check if the contrast ratio meets WCAG AA requirements for large text (>= 3.0:1). Large text is defined as 18pt+ or 14pt+ bold.

pub fn meets_wcag_aaa(&self, other: &Self) -> bool

Check if the contrast ratio meets WCAG AAA requirements for normal text (>= 7.0:1).

pub fn meets_wcag_aaa_large(&self, other: &Self) -> bool

Check if the contrast ratio meets WCAG AAA requirements for large text (>= 4.5:1).

pub fn is_light(&self) -> bool

Returns true if this color is considered “light” (luminance > 0.5). Useful for determining if dark or light text should be used.

pub fn is_dark(&self) -> bool

Returns true if this color is considered “dark” (luminance <= 0.5).

pub fn best_contrast_text(&self) -> Self

Suggest the best text color (black or white) for this background, ensuring WCAG AA compliance for normal text.

If neither black nor white meets AA requirements (unlikely), returns the one with higher contrast.

pub fn ensure_contrast(&self, background: &Self, min_ratio: f32) -> Self

Adjust the color to ensure it meets the minimum contrast ratio against a background. Lightens or darkens the color as needed.

Returns the original color if it already meets the requirement, otherwise returns an adjusted color that meets the minimum contrast.

pub fn apca_contrast(&self, background: &Self) -> f32

Calculate the APCA (Accessible Perceptual Contrast Algorithm) contrast. This is a newer algorithm that may replace WCAG contrast in future standards. Returns a value between -108 (white on black) and 106 (black on white).

Note: The sign indicates polarity (negative = light text on dark bg). For most purposes, use the absolute value.

pub fn meets_apca_body(&self, background: &Self) -> bool

Check if the APCA contrast meets the recommended minimum for body text (|Lc| >= 60).

pub fn meets_apca_large(&self, background: &Self) -> bool

Check if the APCA contrast meets the minimum for large text (|Lc| >= 45).

pub fn with_alpha(&self, a: u8) -> Self

Set the alpha channel while keeping RGB values.

pub fn with_alpha_f32(&self, a: f32) -> Self

Set the alpha as a float (0.0 to 1.0).

pub fn invert(&self) -> Self

Invert the color (keeping alpha).

pub fn to_grayscale(&self) -> Self

Convert to grayscale using luminance weights.

pub const fn has_alpha(&self) -> bool

pub fn to_hash(&self) -> String

pub fn strawberry(shade: usize) -> Self

Strawberry color palette (shade: 100, 300, 500, 700, 900)

pub fn palette_orange(shade: usize) -> Self

Orange color palette (shade: 100, 300, 500, 700, 900)

pub fn banana(shade: usize) -> Self

Banana color palette (shade: 100, 300, 500, 700, 900)

pub fn palette_lime(shade: usize) -> Self

Lime color palette (shade: 100, 300, 500, 700, 900)

pub fn mint(shade: usize) -> Self

Mint color palette (shade: 100, 300, 500, 700, 900)

pub fn blueberry(shade: usize) -> Self

Blueberry color palette (shade: 100, 300, 500, 700, 900)

pub fn grape(shade: usize) -> Self

Grape color palette (shade: 100, 300, 500, 700, 900)

pub fn bubblegum(shade: usize) -> Self

Bubblegum color palette (shade: 100, 300, 500, 700, 900)

pub fn cocoa(shade: usize) -> Self

Cocoa color palette (shade: 100, 300, 500, 700, 900)

pub fn palette_silver(shade: usize) -> Self

Silver color palette (shade: 100, 300, 500, 700, 900)

pub fn slate(shade: usize) -> Self

Slate color palette (shade: 100, 300, 500, 700, 900)

pub fn dark(shade: usize) -> Self

Dark color palette (shade: 100, 300, 500, 700, 900)

pub fn apple_red() -> Self

Apple Red (light mode)

pub fn apple_red_dark() -> Self

Apple Red (dark mode)

pub fn apple_orange() -> Self

Apple Orange (light mode)

pub fn apple_orange_dark() -> Self

Apple Orange (dark mode)

pub fn apple_yellow() -> Self

Apple Yellow (light mode)

pub fn apple_yellow_dark() -> Self

Apple Yellow (dark mode)

pub fn apple_green() -> Self

Apple Green (light mode)

pub fn apple_green_dark() -> Self

Apple Green (dark mode)

pub fn apple_mint() -> Self

Apple Mint (light mode)

pub fn apple_mint_dark() -> Self

Apple Mint (dark mode)

pub fn apple_teal() -> Self

Apple Teal (light mode)

pub fn apple_teal_dark() -> Self

Apple Teal (dark mode)

pub fn apple_cyan() -> Self

Apple Cyan (light mode)

pub fn apple_cyan_dark() -> Self

Apple Cyan (dark mode)

pub fn apple_blue() -> Self

Apple Blue (light mode)

pub fn apple_blue_dark() -> Self

Apple Blue (dark mode)

pub fn apple_indigo() -> Self

Apple Indigo (light mode)

pub fn apple_indigo_dark() -> Self

Apple Indigo (dark mode)

pub fn apple_purple() -> Self

Apple Purple (light mode)

pub fn apple_purple_dark() -> Self

Apple Purple (dark mode)

pub fn apple_pink() -> Self

Apple Pink (light mode)

pub fn apple_pink_dark() -> Self

Apple Pink (dark mode)

pub fn apple_brown() -> Self

Apple Brown (light mode)

pub fn apple_brown_dark() -> Self

Apple Brown (dark mode)

pub fn apple_gray() -> Self

Apple Gray (light mode)

pub fn apple_gray_dark() -> Self

Apple Gray (dark mode)

pub fn bootstrap_primary() -> Self

Primary button color (blue) - used for main actions

pub fn bootstrap_primary_hover() -> Self

pub fn bootstrap_primary_active() -> Self

pub fn bootstrap_secondary() -> Self

Secondary button color (gray) - used for secondary actions

pub fn bootstrap_secondary_hover() -> Self

pub fn bootstrap_secondary_active() -> Self

pub fn bootstrap_success() -> Self

Success button color (green) - used for confirmations

pub fn bootstrap_success_hover() -> Self

pub fn bootstrap_success_active() -> Self

pub fn bootstrap_danger() -> Self

Danger button color (red) - used for destructive actions

pub fn bootstrap_danger_hover() -> Self

pub fn bootstrap_danger_active() -> Self

pub fn bootstrap_warning() -> Self

Warning button color (yellow) - used for warnings, uses BLACK text

pub fn bootstrap_warning_hover() -> Self

pub fn bootstrap_warning_active() -> Self

pub fn bootstrap_info() -> Self

Info button color (teal/cyan) - used for informational actions

pub fn bootstrap_info_hover() -> Self

pub fn bootstrap_info_active() -> Self

pub fn bootstrap_light() -> Self

Light button color - used for light-themed buttons

pub fn bootstrap_light_hover() -> Self

pub fn bootstrap_light_active() -> Self

pub fn bootstrap_dark() -> Self

Dark button color - used for dark-themed buttons

pub fn bootstrap_dark_hover() -> Self

pub fn bootstrap_dark_active() -> Self

pub fn bootstrap_link() -> Self

Link button text color

pub fn bootstrap_link_hover() -> Self

Trait Implementations

impl Clone for ColorU

fn clone(&self) -> ColorU

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ColorU

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

Formats the value using the given formatter.

impl Default for ColorU

fn default() -> Self

Returns the “default value” for a type.

impl Display for ColorU

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

Formats the value using the given formatter.

impl From<ColorF> for ColorU

fn from(input: ColorF) -> ColorU

Converts to this type from the input type.

impl From<ColorU> for ColorF

fn from(input: ColorU) -> ColorF

Converts to this type from the input type.

impl From<ColorU> for ColorOrSystem

fn from(color: ColorU) -> Self

Converts to this type from the input type.

impl Hash for ColorU

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for ColorU

fn cmp(&self, other: &ColorU) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for ColorU

fn eq(&self, other: &ColorU) -> 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 PartialOrd for ColorU

fn partial_cmp(&self, other: &ColorU) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for ColorU

impl Eq for ColorU

impl StructuralPartialEq for ColorU