Grafika / UI
ThemeAdder grafické rozhraní (BBB)
0.0.0.2
Přidávání a správa barevných témat pro BBB Browser.
Co projekt řeší
Přidávání a správa barevných témat pro BBB Browser.
Typické použití
- Načtení obrázku (file dialog / drag&drop podle režimu).
Jak aplikace funguje a k čemu slouží
Přehled
ThemeAdder grafické rozhraní extrahuje dominantní barvy z obrázku, odvozuje doplňkové UI barvy a generuje hotový záznam pro `themes.py`.
Funkce
- Extrahuje dominantní barvy (quantize + filtrování)
- Auto-detekce Dark/Light
- Generování kontrastních barev, hover/selected, progress bar
- Náhled a výběr oblasti (crop)
- Validace syntaxe před zápisem do `themes.py`
Rozšířený profil
ThemeAdder grafické rozhraní je interaktivní nástroj pro tvorbu barevných témat z obrazových předloh. Typický workflow je záměrně krátký: načíst fotografii, screenshot nebo artwork, extrahovat dominantní barvy, nechat vygenerovat kompletní barevné schéma a po kontrole jej bezpečně přidat do themes.py.
Extrakce a generování palety
Nástroj pracuje s PNG, JPG, WEBP, BMP a GIF. Z obrázku vybere dominantní barvy, z luminance rozpozná, zda je vhodnější světlá nebo tmavá varianta, a dopočítá navazující barvy pro background, foreground, accent, hover, selected, border a další UI stavy. Uživatel může omezit analýzu pouze na vybraný obdélník obrázku, což je užitečné, když chce téma odvodit třeba jen z oblohy, objektu nebo konkrétní části artworku.
Live preview a validace
Vygenerované téma se před uložením zobrazuje v živém náhledu. ThemeAdder nekončí prostým vypsáním RGB hodnot: vytváří strukturu kompatibilní s používaným themes.py, kontroluje syntaxi přes Python AST a před zápisem vytváří zálohu. Tím omezuje riziko, že jedno nové téma poškodí celý soubor s motivy.
Standalone i embedded režim
Aplikaci lze spustit samostatně nebo jako vložený dialog z jiné aplikace. Původně byla integrována například do AmiBenchmarku, ale její logika je obecná a použitelná i pro další vlastní PyQt/Tk aplikace. Udržuje geometrii okna, poslední cesty i klávesové zkratky a počítá s Windows, Linuxem i macOS.
Praktické použití
Z jednoho zdrojového obrázku lze vytvořit více variant – například jednu z celé fotografie a další pouze z vybrané oblasti. Téma má vlastní interní ID a zobrazovaný název; výsledkem není jen ukázková paleta, ale přímo použitelná datová struktura pro aplikační UI.
