ThemePaletteBuilder Class Reference

#include <theme_palette_builder.h>

Public Types
using	TokenMap = QHash<ThemeManager::ThemeToken, ThemeColorPair>

Static Public Member Functions
static QPalette	build (const TokenMap &tokens, bool isDarkMode, const QHash< QString, ThemeManager::ThemeToken > &tokenNameCache, const QHash< QString, QPalette::ColorRole > &paletteRoleCache, const QPalette &osBaseline, const ColorMath::ContrastRatios &ratios, QHash< ThemeManager::ThemeToken, const char * > *sources=nullptr)
static QPalette	builtInDarkPalette ()
static QPalette	builtInLightPalette ()

Static Public Attributes
static constexpr QPalette::ColorRole	kLinkSourceRole = QPalette::Highlight

Detailed Description

Builds the application palette from the current theme's token map and mode; ThemeManager pushes it via QApplication::setPalette().

The baseline palette comes from:

• macOS (any supported Qt) and Windows on Qt ≥ 6.8: a caller- supplied osBaseline snapshot. ThemeManager captures the platform palette at construction time (when the palette is pristine) and refreshes it whenever the effective scheme flips. Reading QApplication::palette() here would be wrong: once the builder has pushed any palette via setPalette(), subsequent reads return that customized palette — so consecutive theme switches would accumulate overrides instead of restarting from a clean OS baseline.
• Linux (any Qt) and Windows on Qt < 6.8: our own built-in light or dark palette (see builtInLightPalette() / builtInDarkPalette()). The Linux platform themes (gnome/gtk3/qt6ct) silently ignore QStyleHints::setColorScheme() and pin both the hint and standardPalette() to the OS value, which makes "Dark mode on a Light OS" (or vice versa) impossible to honor without supplying our own palette. Old Fusion has the same problem. osBaseline is ignored on these platforms.

Theme-provided palette overrides (the palette: section of theme.jsonc) are applied on top of the baseline. The selection roles (Highlight, HighlightedText, Link) and Accent are overlaid last, so themes don't need to set them: Highlight resolves to palette.highlight, else packets.selection, else brand.primary; HighlightedText is derived from it unless pinned; Link follows it; Accent is brand.primary.

Member Function Documentation

build()

QPalette ThemePaletteBuilder::build ( const TokenMap & tokens, bool isDarkMode, const QHash< QString, ThemeManager::ThemeToken > & tokenNameCache, const QHash< QString, QPalette::ColorRole > & paletteRoleCache, const QPalette & osBaseline, const ColorMath::ContrastRatios & ratios, QHash< ThemeManager::ThemeToken, const char * > * sources = nullptr )

static

Build and return the full QPalette from the token map without pushing it to QApplication. Callers that need the palette value before it is applied (e.g. to derive tokens first) should call this and then push the result themselves via QApplication::setPalette().

Parameters

tokens	Populated theme token map (brand, accent, optional palette overrides).
isDarkMode	Which side of color pairs to use.
tokenNameCache	Map "palettewindow" → ThemeToken::PaletteWindow (etc.), shared with the parser/QSS loader.
paletteRoleCache	Map "palettewindow" → QPalette::Window (etc.) — Qt's 21 palette-role keys by lowercased enumerator name.
osBaseline	Pristine OS palette snapshot supplied by ThemeManager; used as the baseline on macOS and Windows Qt ≥ 6.8. Ignored on Linux and Windows Qt < 6.8.
ratios	The contrast ratio set derived roles (HighlightedText, Link) are lifted to.
sources	When not null, receives the rule text (untranslated, QT_TRANSLATE_NOOP in the "ThemeTokenHandler" context) of the roles build() resolves itself, Highlight and HighlightedText, while brand.primary is declared. Same type as ThemeTokenHandler::SourceMap.

builtInDarkPalette()

QPalette ThemePaletteBuilder::builtInDarkPalette ( )

static

Built-in dark QPalette used as the baseline on non-macOS platforms when the current mode is dark. Based on https://gist.github.com/QuantumCD/6245215 with Disabled-group coverage added.

builtInLightPalette()

QPalette ThemePaletteBuilder::builtInLightPalette ( )

static

Built-in light QPalette used as the baseline on non-macOS platforms when the current mode is light. Mirrors Qt Fusion's default light palette so the visual identity stays familiar when our override replaces the system's.

Member Data Documentation

kLinkSourceRole

QPalette::ColorRole ThemePaletteBuilder::kLinkSourceRole = QPalette::Highlight

staticconstexpr

The palette role the Link role is derived from in build(). Code that traces a link color back to a theme token starts from this role.

---

The documentation for this class was generated from the following files:

• /builds/wireshark/wireshark/ui/qt/utils/themes/theme_palette_builder.h
• /builds/wireshark/wireshark/ui/qt/utils/themes/theme_palette_builder.cpp