Dokumentace modulu ui_rectangles.py

Účel modulu

Modul slouží k zobrazení stavu jednotlivých LiC článků vizuální formou. Každý řádek má svůj obdélník, jehož barva odráží aktuální aktivní funkci:

• DisCharge – červená
• DisChrgSyn – světle zelená
• Charge – tmavě zelená
• Reset – bez barvy

Součástí modulu je také generátor přehledné legendy.

Struktura a logika

1) Seznam obdélníků

Po vytvoření obsahuje modul seznam rectangles[], kde každý prvek je ID obdélníku na Canvasu.

2) Canvas

Všechny obdélníky jsou vykresleny na jednom Canvas objektu o velikosti 1024×320 px. Modul ukládá tento Canvas do proměnné _canvas, aby jej mohl později aktualizovat.

3) Barevná mapa

Pro přehlednost používá modul mapování hodnot → barvy:

• 1 → red
• 2 → light green
• 3 → green
• 4 → "" (bez barvy = reset)

Popis funkcí

create_rectangles(root)

Vytvoří všech 8 obdélníků a jejich popisky (LiC1…LiC8). Vše vloží do Canvasu, který je automaticky umístěn do GUI pomocí pack().

Funkce:

• vytvoří Canvas
• vykreslí 8 obdélníků
• vytvoří popisky vlevo od nich
• uloží Canvas do interní proměnné

set_rectangle_color(row, value)

Externě volaná funkce, kterou využívají jiné moduly (hlavně ui_radiobuttons).

Nastaví barvu jednoho obdélníku podle poskytnuté hodnoty:

• row – číslo řádku 0–7
• value – hodnota 1–4

Používá mapu COLOR_MAP, takže nové barvy lze velmi snadno přidat.

create_color_legend(root)

Generuje vizuální legendu všech stavů použitých obdélníky. Obsahuje:

• barevný proužek
• textový popis
• ošetření „bezbarvého“ stavu pomocí kříže

Propojení s ostatními moduly

• ui_radiobuttons – řídí barvu obdélníků podle zvoleného stavu
• main.py – vytváří obdélníky při startu, volá legendu
• BLE proces – po přijetí dat mění stav radiobuttonů → ty aktualizují barvy

Jak probíhá změna barvy obdélníku

1. Uživatel klikne na radiobutton v řádku.
2. ui_radiobuttons zavolá on_radio_change().
3. main.py → radio_event_handler aktualizuje stav.
4. Volá se set_rectangle_color(row, value).
5. Obdélník okamžitě změní barvu.