themes.py

themes.py - UI Themes Manager for LunaEngine

ENGINE PATH:
lunaengine -> ui -> themes.py

DESCRIPTION:
This module manages comprehensive UI themes with predefined color schemes
for various applications and visual styles. It includes a wide range of
themes from basic functional ones to brand-specific and aesthetic designs.

MAIN FEATURES:
- Tries to load themes from local themes.json file
- If not found, tries to download from GitHub
- Fallback to default theme if everything fails

class UITheme

Description

Complete UI theme configuration for all elements

Attributes
button_normal: Tuple[int, int, int] = None
button_hover: Tuple[int, int, int] = None
button_pressed: Tuple[int, int, int] = None
button_disabled: Tuple[int, int, int] = None
button_text: Tuple[int, int, int] = None
dropdown_normal: Tuple[int, int, int] = None
dropdown_hover: Tuple[int, int, int] = None
dropdown_expanded: Tuple[int, int, int] = None
dropdown_text: Tuple[int, int, int] = None
dropdown_option_normal: Tuple[int, int, int] = None
dropdown_option_hover: Tuple[int, int, int] = None
dropdown_option_selected: Tuple[int, int, int] = None
slider_track: Tuple[int, int, int] = None
slider_thumb_normal: Tuple[int, int, int] = None
slider_thumb_hover: Tuple[int, int, int] = None
slider_thumb_pressed: Tuple[int, int, int] = None
slider_text: Tuple[int, int, int] = None
label_text: Tuple[int, int, int] = None
background: Tuple[int, int, int] = None
background2: Tuple[int, int, int] = None
text_primary: Tuple[int, int, int] = None
text_secondary: Tuple[int, int, int] = None
switch_track_on: Tuple[int, int, int] = None
switch_track_off: Tuple[int, int, int] = None
switch_thumb_on: Tuple[int, int, int] = None
switch_thumb_off: Tuple[int, int, int] = None
dialog_background: Tuple[int, int, int] = None
dialog_border: Tuple[int, int, int] = None
dialog_text: Tuple[int, int, int] = None
dialog_name_bg: Tuple[int, int, int] = None
dialog_name_text: Tuple[int, int, int] = None
dialog_continue_indicator: Tuple[int, int, int] = None
tooltip_background: Tuple[int, int, int] = None
tooltip_border: Tuple[int, int, int] = None
tooltip_text: Tuple[int, int, int] = None
notification_success_background: Tuple[int, int, int] = None
notification_success_border: Tuple[int, int, int] = None
notification_success_text: Tuple[int, int, int] = None
notification_info_background: Tuple[int, int, int] = None
notification_info_border: Tuple[int, int, int] = None
notification_info_text: Tuple[int, int, int] = None
notification_warning_background: Tuple[int, int, int] = None
notification_warning_border: Tuple[int, int, int] = None
notification_warning_text: Tuple[int, int, int] = None
notification_custom_background: Tuple[int, int, int] = None
notification_custom_border: Tuple[int, int, int] = None
notification_custom_text: Tuple[int, int, int] = None
notification_error_background: Tuple[int, int, int] = None
notification_error_border: Tuple[int, int, int] = None
notification_error_text: Tuple[int, int, int] = None
accent1: Tuple[int, int, int] = None
accent2: Tuple[int, int, int] = None
button_border: Optional[Tuple[int, int, int]] = None
dropdown_border: Optional[Tuple[int, int, int]] = None
border: Optional[Tuple[int, int, int]] = None
border2: Optional[Tuple[int, int, int]] = None
Methods

No methods defined.

class ThemeType

Description

Enumeration of all available theme types

Attributes
DEFAULT: Any = 'default'
PRIMARY: Any = 'primary'
SECONDARY: Any = 'secondary'
WARN: Any = 'warn'
ERROR: Any = 'error'
SUCCESS: Any = 'success'
INFO: Any = 'info'
FANTASY_DARK: Any = 'fantasy_dark'
FANTASY_LIGHT: Any = 'fantasy_light'
CHERRY_DARK: Any = 'cherry_dark'
CHERRY_LIGHT: Any = 'cherry_light'
ECLIPSE: Any = 'eclipse'
MIDNIGHT_DARK: Any = 'midnight_dark'
MIDNIGHT_LIGHT: Any = 'midnight_light'
NEON: Any = 'neon'
RUBY: Any = 'ruby'
EMERALD: Any = 'emerald'
DIAMOND: Any = 'diamond'
SILVER: Any = 'silver'
COPPER: Any = 'copper'
BRONZE: Any = 'bronze'
AZURE: Any = 'azure'
EIGHTIES: Any = '80s'
CLOUDS: Any = 'clouds'
ROBLOX: Any = 'roblox'
DISCORD: Any = 'discord'
GMAIL: Any = 'gmail'
YOUTUBE: Any = 'youtube'
STEAM_DARK: Any = 'steam_dark'
STEAM_LIGHT: Any = 'steam_light'
WHATSAPP_DARK: Any = 'whatsapp_dark'
WHATSAPP_LIGHT: Any = 'whatsapp_light'
CRUNCHYROLL_DARK: Any = 'crunchyroll_dark'
CRUNCHYROLL_LIGHT: Any = 'crunchyroll_light'
TWITCH_DARK: Any = 'twitch_dark'
TWITCH_LIGHT: Any = 'twitch_light'
TELEGRAM_DARK: Any = 'telegram_dark'
TELEGRAM_LIGHT: Any = 'telegram_light'
XBOX_DARK: Any = 'xbox_dark'
XBOX_LIGHT: Any = 'xbox_light'
PLAYSTATION_DARK: Any = 'playstation_dark'
PLAYSTATION_LIGHT: Any = 'playstation_light'
MINECRAFT_DARK: Any = 'minecraft_dark'
MINECRAFT_LIGHT: Any = 'minecraft_light'
CYBERPUNK_DARK: Any = 'cyberpunk_dark'
CYBERPUNK_LIGHT: Any = 'cyberpunk_light'
QUEEN: Any = 'queen'
KING: Any = 'king'
MATRIX: Any = 'matrix'
BUILDER: Any = 'builder'
GALAXY_DARK: Any = 'galaxy_dark'
GALAXY_LIGHT: Any = 'galaxy_light'
FOREST: Any = 'forest'
SUNSET: Any = 'sunset'
OCEAN: Any = 'ocean'
LAVENDER: Any = 'lavender'
CHOCOLATE: Any = 'chocolate'
KIWI: Any = 'kiwi'
DEEP_SPACE: Any = 'deep_space'
NORD_DARK: Any = 'nord_dark'
NORD_LIGHT: Any = 'nord_light'
DRACULA: Any = 'dracula'
SOLARIZED_DARK: Any = 'solarized_dark'
SOLARIZED_LIGHT: Any = 'solarized_light'
MONOKAI: Any = 'monokai'
GRUVBOX_DARK: Any = 'gruvbox_dark'
GRUVBOX_LIGHT: Any = 'gruvbox_light'
BLACK: Any = 'black'
WINDOWS_DARK: Any = 'windows_dark'
WINDOWS_LIGHT: Any = 'windows_light'
LINUX_DARK: Any = 'linux_dark'
LINUX_LIGHT: Any = 'linux_light'
IOS_DARK: Any = 'ios_dark'
IOS_LIGHT: Any = 'ios_light'
ANDROID_DARK: Any = 'android_dark'
ANDROID_LIGHT: Any = 'android_light'
NINJA_DARK: Any = 'ninja_dark'
NINJA_LIGHT: Any = 'ninja_light'
BRAZIL: Any = 'brazil'
JAPAN: Any = 'japan'
USA: Any = 'usa'
EUROPEAN: Any = 'european'
DYNASTY: Any = 'dynasty'
VIKINGS: Any = 'vikings'
Methods

No methods defined.

class ThemeManager

Description

Manages complete UI themes with local/remote loading

Attributes
_themes: Dict[ThemeType, UITheme] = {}
_current_theme: ThemeType = ThemeType.DEFAULT
_themes_loaded: bool = False
GITHUB_THEMES_URL: Any = 'https://raw.githubusercontent.com/MrJuaumBR/LunaEngine/refs/heads/main/lunaengine/ui/themes.json'
Methods
def _get_themes_file_path(cls: Any) -> str
Get the path to themes.json file (cross-platform)
def _download_from_github(cls: Any) -> Optional[dict]
Download themes.json from GitHub
def _save_themes_to_cache(cls: Any, themes_data: dict) -> bool
Save downloaded themes to local cache
def _load_themes_from_json(cls: Any) -> Any
Load themes from JSON file or GitHub
def _process_themes_data(cls: Any, themes_data: dict) -> Any
Process themes data from dictionary
def _create_fallback_theme(cls: Any) -> Any
Create a simple fallback theme if loading fails
def ensure_themes_loaded(cls: Any) -> Any
Ensure themes are loaded from JSON or GitHub
def get_theme_by_name(cls: Any, name: str) -> UITheme
Get theme by name string
def get_theme_type_by_name(cls: Any, name: str) -> ThemeType
Get theme type by name string
def get_theme(cls: Any, theme_type: ThemeType) -> UITheme
Get complete theme by type
def set_theme(cls: Any, theme_type: ThemeType, theme: UITheme) -> Any
Set or override a theme
def set_current_theme(cls: Any, theme_type: ThemeType) -> Any
Set the current default theme
def get_current_theme(cls: Any) -> ThemeType
Get current default theme
def get_themes(cls: Any) -> Dict[ThemeType, UITheme]
Get all available themes
def get_theme_types(cls: Any) -> List[ThemeType]
Get all available theme types
def get_theme_names(cls: Any) -> List[str]
Get all available theme names
def get_color(cls: Any, color_name: color_name_type) -> Tuple[int, int, int]
Get a specific color from the current theme
def reload_themes(cls: Any) -> Any
Force reload themes from source
def get_loaded_count(cls: Any) -> int
Get number of loaded themes
def is_theme_available(cls: Any, theme_name: str) -> bool
Check if a theme is available by name
Back to Ui Module