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};

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 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 progress_indicator(&self) -> &ProgressIndicatorMetrics

Resolves progress indicator control geometry metrics.

pub fn table_view(&self) -> &TableViewMetrics

Resolves table view and header geometry metrics.

pub fn token_field(&self) -> &TokenFieldMetrics

Resolves token field pill input geometry metrics.

pub fn level_indicator(&self) -> &LevelIndicatorMetrics

Resolves level indicator meter geometry metrics.

pub fn trim_scrubber(&self) -> &TrimScrubberMetrics

Resolves trim scrubber timeline geometry metrics.

pub fn path_control(&self) -> &PathControlMetrics

Resolves path control breadcrumb geometry metrics.

pub fn disclosure_group(&self) -> &DisclosureGroupMetrics

Resolves disclosure group and button geometry metrics.

pub fn combo_box(&self) -> &ComboBoxMetrics

Resolves combo box geometry metrics.

pub fn tab_view(&self) -> &TabViewMetrics

Resolves tab view layout and content insets metrics.

pub fn date_picker(&self) -> &DatePickerMetrics

Resolves date picker geometry metrics.

pub fn collection_view(&self) -> &CollectionViewMetrics

Resolves collection view flow layout and selection metrics.

pub fn player_view(&self) -> &PlayerViewMetrics

Resolves player view media presentation metrics.

pub fn box_view(&self) -> &BoxViewMetrics

Resolves box view container and separator metrics.

pub fn rule_editor(&self) -> &RuleEditorMetrics

Resolves rule editor layout and button metrics.

pub fn navigation_metrics(&self) -> &NavigationMetrics

Resolves navigation and feedback metrics collection.

pub fn menu_bar_metrics(&self) -> &MenuBarMetrics

Resolves menu bar and dropdown geometry metrics.

pub fn footer_metrics(&self) -> &FooterMetrics

Resolves canvas footer geometry metrics.

pub fn palette_metrics(&self) -> &PaletteMetrics

Resolves command palette modal geometry metrics.

pub fn context_menu_metrics(&self) -> &ContextMenuMetrics

Resolves context menu geometry metrics.

pub fn toast_metrics(&self) -> &ToastMetrics

Resolves toast notification 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 disabled_opacity(&self) -> f32

Resolves opacity multiplier for disabled controls (0.45).

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.

pub fn paint_focus_ring( &self, painter: &Painter, rect: Rect, corner_radius: f32, )

Renders an AppKit outer keyboard focus ring (NSFocusRingPlacementOutside) around rect.

impl MacTheme

pub fn new(appearance: MacAppearance) -> Self

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

pub fn from_ctx(ctx: &Context) -> Self

Retrieves the active MacTheme stored in egui::Context by MacTheme::apply_to_egui, falling back to MacTheme::default (Aqua) if none was registered.

pub fn resolve<'a>(theme: Option<&'a Self>, ctx: &Context) -> Cow<'a, Self>

Resolves an optional borrowed MacTheme, falling back to MacTheme::from_ctx.

pub fn resolve_or_default<'a>(theme: Option<&'a Self>) -> Cow<'a, Self>

Resolves an optional borrowed MacTheme, falling back to the cached MacTheme::default without allocating an egui::Context.

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 system_green(&self) -> Color32

Resolves Apple system green semantic color (systemGreenColor).

pub fn system_yellow(&self) -> Color32

Resolves Apple system yellow/amber semantic color (systemYellowColor).

pub fn system_orange(&self) -> Color32

Resolves Apple system orange semantic color (systemOrangeColor).

pub fn system_red(&self) -> Color32

Resolves Apple system red semantic color (systemRedColor).

pub fn alternating_row_even(&self) -> Color32

Resolves even table row background color (alternatingContentBackgroundColors[0]).

pub fn alternating_row_odd(&self) -> Color32

Resolves odd table row background color (alternatingContentBackgroundColors[1]).

pub fn alternating_content_background(&self, row_index: usize) -> Color32

Resolves alternating content background color for the given row index (row_index % 2).

pub fn scrubber_selection_border(&self) -> Color32

Resolves QuickTime / AVKit trim selection border and handle color.

pub fn scrubber_outside_dim(&self) -> Color32

Resolves dimming overlay color for timeline regions outside active trim bounds.

pub fn scrubber_waveform(&self) -> Color32

Resolves waveform amplitude bar color inside trim scrubber track.

pub fn scrubber_playhead(&self) -> Color32

Resolves playhead cursor line and timecode badge accent color.

pub fn on_accent_text(&self) -> Color32

Resolves high-contrast white text color used on accent fills.

pub fn knob_fill(&self) -> Color32

Resolves white thumb knob fill color for switches and sliders.

pub fn drop_shadow(&self) -> Color32

Resolves subtle ambient drop shadow color for controls and floating surfaces.

pub fn backdrop_dim(&self) -> Color32

Resolves modal backdrop dimming overlay color.

pub fn hud_background(&self) -> Color32

Resolves translucent dark HUD palette background color (SPEC-006 §2.2).

pub fn hud_border(&self) -> Color32

Resolves dark HUD palette hairline border color.

pub fn hud_text(&self) -> Color32

Resolves dark HUD palette primary text color.

pub fn hud_secondary_text(&self) -> Color32

Resolves dark HUD palette secondary label color.

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 traffic_light_glyph(&self) -> Color32

Interior glyph color for hovered macOS traffic light buttons.

pub fn windows_caption_close_hover_bg(&self) -> Color32

Background color for Windows 11 close caption button on hover (#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 scrollbar_thumb_color(&self, active: bool, alpha_factor: f32) -> Color32

Overlay scrollbar thumb color scaled by fade alpha_factor in [0.0, 1.0].

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

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

Performs an $O(1)$ short-circuit when the active MacTheme stored in ctx already matches the current appearance, window controls style, accent override, and token catalog pointer.

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.