Struct Theme 

pub struct Theme {

    pub dark: bool,
    pub overlay_manager: OverlayManager,
    pub image_tint_recommended: bool,
    pub kind: ThemeKind,
    pub colors: ThemeColors,
    pub visuals: ThemeVisuals,
    pub typography: Typography,
    pub spacing: ThemeSpacing,
    pub window_frame: Frame,
    pub frame1: Frame,
    pub frame2: Frame,
    pub corner_radius: u8,
    pub inner_margin: i8,
    pub outer_margin: i8,
    pub button_padding: Vec2,
}

Complete look: colors, typography, frames, and widget visuals.

Theme is Clone. Theme::install takes &mut self (the elegance path records a key on self). Clone before install if you need to keep an unmodified copy:

let mut theme = Theme::new(ThemeKind::TokyoNight);
theme.install(&ctx);

Fields

dark: bool

True if the theme is dark

overlay_manager: OverlayManager

Tracks open windows so OverlayManager::paint_overlay can dim the canvas.

image_tint_recommended: bool

True if a tint is recomended to be applied to images to soften the contrast between the image and the background

This is usually true for themes with very dark background

kind: ThemeKind

Which built-in palette this theme was constructed from.

colors: ThemeColors

Semantic color slots.

visuals: ThemeVisuals

Per-widget chrome (button, label, combo, text edit, frames).

typography: Typography

Font sizes used by this crate’s widgets and the demo.

spacing: ThemeSpacing

Layout rhythm (gaps between siblings and groups).

Widget chrome padding stays on Theme::inner_margin / Theme::button_padding. Apps should pick a step from this scale instead of one-off 4.0 / 12.0 / 16.0 literals.

window_frame: Frame

Used for Frame not native windows

frame1: Frame

Base container frame for major UI sections.

frame2: Frame

Frame for nested elements, like individual list items.

corner_radius: u8

Corner radius for widgets

inner_margin: i8

Inner margin for widgets

outer_margin: i8

Outer margin for widgets

button_padding: Vec2

Padding inside buttons

Must use this from egui::Ui::spacing_mut to change the padding

Implementations

impl Theme

pub fn new(kind: ThemeKind) -> Self

Construct a built-in theme.

pub fn style(&self) -> Style

Stock egui::Style for this kind (widgets, selection, window fill).

pub fn frame1_visuals(&self) -> FrameVisuals

Frame 1 visuals from ThemeVisuals.

pub fn frame2_visuals(&self) -> FrameVisuals

Frame 2 visuals from ThemeVisuals.

pub fn button_visuals(&self) -> ButtonVisuals

Button visuals from ThemeVisuals.

pub fn label_visuals(&self) -> LabelVisuals

Label visuals from ThemeVisuals (same shape as button visuals).

pub fn combo_box_visuals(&self) -> ComboBoxVisuals

Combo-box visuals from ThemeVisuals.

pub fn text_edit_visuals(&self) -> TextEditVisuals

Text-edit visuals from ThemeVisuals.

pub fn button_visuals_from_ctx(ctx: &Context) -> Option<ButtonVisuals>

Widget visuals stored by Theme::install, if any.

Widgets resolve in this order: self.visuals → context → egui::Style.

pub fn label_visuals_from_ctx(ctx: &Context) -> Option<LabelVisuals>

Same as Self::button_visuals_from_ctx for labels.

pub fn combo_box_visuals_from_ctx(ctx: &Context) -> Option<ComboBoxVisuals>

Same as Self::button_visuals_from_ctx for combo boxes.

pub fn text_edit_visuals_from_ctx(ctx: &Context) -> Option<TextEditVisuals>

Same as Self::button_visuals_from_ctx for text edits.

pub fn install(&mut self, ctx: &Context)

Install this theme into the given egui context.

Widgets then pick up their visuals from ctx automatically.

pub fn current(ctx: &Context) -> Theme

Read the current theme from the context if it exists, otherwise return the default theme

pub fn remap_derived_frames(&mut self, old: &ThemeColors)

Keep derived frame colors in sync with a palette change.

Only updates a color if it still matches the previous palette slot (e.g. frame1.fill == old.widget_bg). Custom colors and structural frame properties (margins, rounding, shadow offsets) are left alone.

Trait Implementations

impl Clone for Theme

fn clone(&self) -> Theme

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Eq for Theme

impl PartialEq for Theme

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

Equality operator ==.

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

Inequality operator !=.