Decimal Clock QT

Přehled

Decimal Clock QT je moderní interpretace historického konceptu revolučního francouzského času, převedená do podoby vysoce přizpůsobitelného desktopového widgetu. Aplikace umožňuje sledovat čas v desítkové soustavě (den rozdělen na 10 hodin), přičemž zachovává možnost přepnutí na standardní 24h nebo 12h cyklus.

Tři způsoby použití:

• Standalone aplikace: Spustit přímo z Python/exe, běží jako nezávislé okno.
• FileMaster modul (FM_DO): Automaticky integrován v FileMaster suite, dostupný v side panelu.
• Qt widget embedding: Vložit jako Qt komponenta do vlastní aplikace (programátorské vložení).

Primární účel

Edukativní a estetický nástroj pro sledování alternativních časových systémů, s vysokou přizpůsobitelností skrze SVG skinování a digitální overlaye.

UI / Screenshoty a vizualizace

Widget je navržen pro minimalismus — nemá žádné rámečky ani horní lištu (frameless design). Veškerá interakce probíhá skrze myš a klávesové zkratky.

Layout okna (Frameless):

Grafické varianty (pro FM_DO): Obsahuje osciloskop X/Y background (pod ciferníkem, cyklicky generovaný nebo z audio vstupu) pro pokročilou vizualizaci.

Klíčové vlastnosti & schopnosti

4.1 Časové režimy

• Decimální (10h/100m/100s): 1 den = 10 hodin, 1 hodina = 100 minut, 1 minuta = 100 sekund. Konverze: (sekund od půlnoci / 86400) × 10 = desiková hodina.
• Klasický 12hodinový: Standardní 12h formát s AM/PM, analogový zobrazovač s 12 pozicí.
• Klasický 24hodinový: Moderní 24h formát, analogový zobrazovač (lineární mapování 24h→360°).

4.2 SVG Skinování

• Ciferníky (dials): 20+ SVG variant (Minimal, Steampunk, Futuristic, Custom…)
• Sady ručiček (hands sets): 10+ variant (Classic, Bold, Thin, Skeleton…)
• Dynamická kombinace: dial × hands = 200+ možných kombinací
• Per-dial konfigurace: s parametry scale, offset, pivot points (FM_DO specifika)

4.3 Digitální overlay

• Volitelné zobrazení číslovky v rohu okna (HH:MM:SS DecimalFormat)
• Pozice: horní-levý (L-U), horní-pravý (R-U), dolní-levý (L-D), dolní-pravý (R-D), vyp (Off)
• Konfigurabilní font, velikost (10–32px), barva (#75FF2F default), outline (1–5px tloušťka)

4.4 Osciloskop X/Y overlay (FM_DO specifika)

• Vrstvený rendering do QGraphicsScene (pod digitálem, nad ciferníkem)
• Generovaný test signál (sine/noise) nebo live audio input
• Přepínače: L/R swap, X/Y swap, dot/line mode, gain +/-, barva
• Scaling podle ciferníku (společný zoom s dial)
• Ovládání v kontextovém menu + shortcut Ctrl+O

4.5 Ručičky s nezávislým škálováním (FM_DO feature)

• Parametr (0.2–3.0) + pro ciferník
• Umožňuje např. velký ciferník (3.0×) + malé ručičky (0.5×) pro lepší čitelnost
• Nezávislá nastavení pivot_x, pivot_y, offset pro každou ručičku v skin.json

4.6 Interakce & řízení

• Přesouvání: Levé tlačítko myši (drag-to-move)
• Resize: Kolečko myši (zoom +/-), range 0.35× až 3.0×
• Lock: Ctrl+L zamkne pozici a velikost (blokuje myšní eventy)
• Kontextové menu (RMB): Výběr dial, hands set, režim času, overlay settings, lock/unlock, tray

Workflow scénáře & praktické případy

Scénář 1: Minimalistický desktop widget

1. Spusť aplikaci (default nastavení)
2. RMB > Skins > Dialso → "Minimal" (čistý ciferník)
3. RMB > Digital Display > Off (skrýt číslovku)
4. Ctrl+L pro zablokování pozice
5. Widget běží tichý v rohu, bez rušení

Scénář 2: Edukační demonstrace desítkového času

1. RMB > Time Mode > Decimal (přepnout na desiková soustava)
2. RMB > Digital Display > Enable + Position: R-U (pravý horní roh)
3. Cykluj režimy (Ctrl+T) a ukazuj rozdíly

Scénář 3: FM_DO modul integrace

1. Spusť FileMaster (FM_DO suite)
2. Widget se automaticky vloží do side panelu
3. Nastavení se synchronizují s FM_DO profilem

Scénář 4: Qt embedding do vlastní aplikace

1. Import:
2. Vytvoř instanci a přidej do layoutu
3. Widget bude sdílet stylování s hostitelskou aplikací

Použití & ovládání

Po spuštění se uprostřed obrazovky objeví frameless okno s analogovými hodinami.

Základní operace

• Přesun: Levé tlačítko myši (drag)
• Resize: Kolečko myši (forward = zvětšit, backward = zmenšit)
• Menu: Pravé tlačítko myši (RMB)
• Lock: Ctrl+L pro zablokování pozice/velikosti

Přepínání režimů

• Časový režim: Ctrl+T (Decimal → 12h → 24h)
• Digitální čas: Ctrl+D (cykluje pozici)
• Osciloskop (FM_DO): Ctrl+O (zapíná/vypíná)

Pokročilé funkce & customizace

11.1 Custom ciferník

Menu > Skins > Custom Dial… > File Picker. Podporované: PNG, JPG, WebP. Widget automaticky škáluje.

11.2 Handless mode

Menu > Display > Show Hands: Off. Skryje ručičky, zobrazí pouze ciferník.

11.3 Digitální čas s custom outfit

Menu > Digital Display Settings → Font, Size, Outline Width/Color, Text Color.

11.4 Sweep vs. step seconds

Menu > Window > Sweep Seconds: On = plynulý pohyb, Off = skokový pohyb.

11.5 Opacity & Always-on-top

Menu > Window → kontrola průhlednosti (15–100%) a keep-on-top flag.

Troubleshooting & diagnostika

Problem: SVG ciferník se nezobrazuje

1. Zkontroluj: — jsou tam SVG?
2. Zkopíruj z pokud chybí
3. Spusť s pro debug info

Problem: Digitální čas ukazuje divně

1. Možná příčina: Časová zóna — widget používá
2. Řešení: Ctrl+D pro přepínání pozice; pokud je off, zapni si jej on

Problem: Widget zamrzl

1. Možná příčina: Okno je zamčené ()
2. Řešení: Ctrl+L pro odemknutí

FAQ (Často kladené otázky)

Q: Mohu spustit tuto aplikaci bez FileMaster?
A: Ano, 100%. Aplikace je plně funkční standalone.

Q: Jak ji vložím do své vlastní Qt aplikace?
A: Import třídu DecimalClockWidget a vytvoř instanci jako QWidget. Viz Appendix E (Deployment).

Q: Jaký je rozdíl mezi FM_DO a klasickou verzí?
A: Code je totožný (unifikován 2026-02-21). Rozdíl je v deployment kontextu. FM_DO má navíc osciloskop a nezávislé hands scale.

Q: Kde se ukládají nastavení?
A: uložená nastavení scope: (Linux/Mac) nebo Windows registry.

Q: Mohu vytvořit vlastní ciferník?
A: Ano! Vytvoř SVG a umístí jej do s .