# Command: TEXT
# **zobrazení textu na tlačítku**
Zobrazí vlastní text na zvolené pozici v layoutu **2×3** nebo **3×4**.
Podporuje **UTF-8**, včetně diakritiky (rozsah 32~709). Používá se pro dynamické hodnoty (teploty, stavy, hlášení, …).
- Text je **automaticky centrován**.
- Dlouhý text se **automaticky posouvá (scroll circular)**.
- Barva textu se mění příkazem **color**.
- Text je uložen **jen v RAM**
- Maximální délka je 127 znaků
---
## **Syntaxe**
Příklady pro tlačítko C2 (třetí sloupec a druhý řádek) na obrazovce číslo 1, velikost fontu 30 a text
*Pokus*
*textu*
**devName** - označení panelu ***WEB/Settings/Device setting/Device name***
**devIP** - IP adresa panelu
**scr#** - nastavení čísla obrazovky kde # je číslo 1~3
**btn$#** - nastavení tlačítka podle zvoleného layoutu $ je písmeno sloupce A~D, # je číslo řádku 1~3
**font** - velikost fontu 16, 20, 30 a 46. Velikost 46 nepodporuje ořádkování! A je primárně určena pro zobrazení hodnot např teploty °C. Pokud parametr font není uveden bude použita velikost 16
**value** - text musí být uzavřen 'v jednoduchých uvozovách'
---
## **UDP**
devName text scr1 btnC2 font 30 value 'Pokus\ntextu'
odřádkování pomocí **\\n**
## **HTTP**
http://devIP/ctrl?cmd=text&scr=1&btn=C2&font=30&value='Pokus%0Atextu'
odřádování pomocí **%0A**
## **MQTT**
##### **Topic**
devName/command/button_text/scr1_btnC2
##### **Hodnota (Value) - JSON formát**
{
"font":30,
"text":'Pokus\ntextu'
}
odřádkování pomocí **\\n**
---
## 📋 **Parametry**
| Parametr | Povinný | Popis |
|---|
| **scr#** | ✅ | Číslo obrazovky (1–3). |
| **btn$#** | ✅ | Umístění tlačítka — $ = sloupec (A–D), # = řádek (1–3). |
| **font** | ❌ | velikost fontu, možné velikosti 16, 20, 30 a 46 (nepodporuje odřádkování!), výchozí je 16 |
| **value 'text'** | ✅ | Hodnota textu, pro vymazání textu použijte jednu mezeru |
| Kód | Hláška | Význam |
|---|
| 0 | (bez chyby) | Příkaz proveden. |
| 12 | Missing or bad value:'text' (use value:'your text') | Chybějící hodnota textu |
| 30 | Screen or button doesn't exist (index out of range) | Tlačítko nebo obrazovka neexistuje |
| 31 | Bad button format (use: scr# btn$#) | Špatný formát označení obrazovky a tlačítka |
| 32 | Screen or button doesn't exist or button is not defined as 'TEXT PLACE' (index out of range) | Neexistující tlačítko nebo obrazovka nebo tlačítko není definováno pro text |