Struct MacTheme 

pub struct MacTheme {
    pub appearance: MacAppearance,
    pub window_controls_style: WindowControlsStyle,
    /* private fields */
}

Dynamic theme resolving AppKit semantic styling from MacDesignTokens.

Example

use egui_macview::{MacAppearance, MacTheme, WindowControlsStyle};

// Create a dark aqua macOS theme
let theme = MacTheme::new(MacAppearance::DarkAqua)
    .with_window_controls_style(WindowControlsStyle::AppleTrafficLights);

let bg = theme.window_background();
let text_color = theme.label();
let corner_radius = theme.button().regular.corner_radius.points();
assert_eq!(corner_radius, 6.0);

Fields

appearance: MacAppearance

Active macOS appearance mode (MacAppearance::Aqua or MacAppearance::DarkAqua).

window_controls_style: WindowControlsStyle

Window caption controls presentation style.

Implementations

impl MacTheme

pub fn new(appearance: MacAppearance) -> Self

Creates a new MacTheme for the given appearance using the embedded default token catalog.

pub fn with_window_controls_style(self, style: WindowControlsStyle) -> Self

Sets the window controls presentation style (Strategy 2).

pub fn window_controls_style(&self) -> WindowControlsStyle

Returns the active window controls presentation style.

pub fn with_accent(self, accent: Color32) -> Self

Sets a dynamic system accent color override (matching macOS System Settings Appearance Accent).

pub fn with_tokens(appearance: MacAppearance, tokens: MacDesignTokens) -> Self

Creates a MacTheme with custom loaded tokens.

pub fn with_arc_tokens( appearance: MacAppearance, tokens: Arc<MacDesignTokens>, ) -> Self

Creates a MacTheme with custom loaded tokens wrapped in an Arc.

pub fn tokens(&self) -> &MacDesignTokens

Returns the underlying design token catalog.

pub fn colors(&self) -> &MacAppearanceColors

Active appearance color palette.

pub fn window_background(&self) -> Color32

Resolves windowBackgroundColor (NSColor) for the active appearance.

pub fn control_background(&self) -> Color32

Resolves controlBackgroundColor (NSColor) for the active appearance.

pub fn control(&self) -> Color32

Resolves controlColor (NSColor) for the active appearance.

pub fn control_accent(&self) -> Color32

Resolves controlAccentColor (NSColor) or custom accent override.

pub fn selected_control(&self) -> Color32

Resolves selectedControlColor (NSColor) or custom accent override.

pub fn selected_control_inactive(&self) -> Color32

Resolves selectedControlColor (NSColor) when the window or control is inactive/unfocused.

pub fn separator(&self) -> Color32

Resolves separatorColor (NSColor) for hairlines and borders.

pub fn placeholder_text(&self) -> Color32

Resolves placeholderTextColor (NSColor) for empty text fields and search inputs.

pub fn keyboard_focus_indicator(&self) -> Color32

Resolves keyboardFocusIndicatorColor (NSColor) for focus rings.

pub fn label(&self) -> Color32

Resolves primary labelColor (NSColor).

pub fn secondary_label(&self) -> Color32

Resolves secondaryLabelColor (NSColor) for captions, subtitles, and section headers.

pub fn apply_to_egui(&self, ctx: &Context)

Synchronizes egui::Context theme and visuals with the macOS appearance.

pub fn control_metrics(&self) -> &MacControlMetrics

Resolves top-level control metrics collection.

pub fn focus_ring(&self) -> &FocusRingMetrics

Resolves focus ring geometry metrics.

pub fn text_field(&self) -> &TextFieldMetrics

Resolves text field geometry metrics.

pub fn button(&self) -> &ButtonMetrics

Resolves push button geometry metrics.

pub fn segmented(&self) -> &SegmentedMetrics

Resolves segmented control geometry metrics.

pub fn popover_metrics(&self) -> &PopoverMetrics

Resolves popover and HUD panel geometry metrics.

pub fn toolbar_metrics(&self) -> &ToolbarMetrics

Resolves window toolbar geometry metrics.

pub fn slider(&self) -> &SliderMetrics

Resolves slider control geometry metrics.

pub fn thumbnail(&self) -> &ThumbnailCellMetrics

Resolves thumbnail cell geometry metrics.

pub fn split_view(&self) -> &SplitViewMetrics

Resolves split view divider and handle geometry metrics.

pub fn layout_metrics(&self) -> &LayoutMetrics

Resolves layout container geometry metrics.

pub fn scroll_view(&self) -> &ScrollViewMetrics

Resolves scroll view and overlay scrollbar geometry metrics.

pub fn stack_view(&self) -> &StackViewMetrics

Resolves stack view linear layout geometry metrics.

pub fn outline_view(&self) -> &OutlineViewMetrics

Resolves outline view hierarchical table geometry metrics.

pub fn popup_button(&self) -> &PopUpButtonMetrics

Resolves pop-up button geometry metrics.

pub fn search_field(&self) -> &SearchFieldMetrics

Resolves search field geometry metrics.

pub fn stepper(&self) -> &StepperMetrics

Resolves numeric stepper control geometry metrics.

pub fn color_well(&self) -> &ColorWellMetrics

Resolves color well swatch control geometry metrics.

pub fn toggle(&self) -> &ToggleMetrics

Resolves toggle switch control geometry metrics.

pub fn motion(&self) -> &MacMotionTokens

Resolves CoreAnimation motion preset tokens.

pub fn typography(&self) -> &MacTypographyTokens

Resolves typography and SF Pro tracking tokens.

pub fn system_green(&self) -> Color32

Resolves Apple system green semantic color (systemGreenColor).

pub fn traffic_light_close(&self) -> (Color32, Color32)

Resolves macOS window close traffic light fill and border colors (fill, border).

pub fn traffic_light_minimize(&self) -> (Color32, Color32)

Resolves macOS window minimize traffic light fill and border colors (fill, border).

pub fn traffic_light_zoom(&self) -> (Color32, Color32)

Resolves macOS window zoom/fullscreen traffic light fill and border colors (fill, border).

pub fn windows_caption_close_hover_bg(&self) -> Color32

Background color for Windows 11 close caption button on hover (Fluent crimson red #E81123).

pub fn windows_caption_close_pressed_bg(&self) -> Color32

Background color for Windows 11 close caption button when pressed (#C42B1C).

pub fn windows_caption_hover_bg(&self) -> Color32

Background color for Windows 11 minimize/maximize caption buttons on hover.

pub fn windows_caption_pressed_bg(&self) -> Color32

Background color for Windows 11 minimize/maximize caption buttons when pressed.

pub fn background_style(&self, bg: Color32) -> MacBackgroundStyle

Resolves the MacBackgroundStyle (Light or Dark) for any background color.

pub fn window_background_style(&self) -> MacBackgroundStyle

Resolves the MacBackgroundStyle for the window background.

pub fn control_background_style(&self) -> MacBackgroundStyle

Resolves the MacBackgroundStyle for the control background.

pub fn selected_control_background_style(&self) -> MacBackgroundStyle

Resolves the MacBackgroundStyle for the selected control background.

Trait Implementations

impl Clone for MacTheme

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MacTheme

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

Formats the value using the given formatter.

impl Default for MacTheme

fn default() -> Self

Returns the “default value” for a type.