Culori

Funcțiile de culoare convertesc între modelul HSV — nuanță, saturație și valoare (luminozitate) — și modelul RGB cu canalele roșu, verde și albastru. O lumină color TapHome lucrează cu nuanță și saturație; multe dispozitive comandate din scripturile Packet parser sau Modbus așteaptă în schimb roșu, verde și albastru. Ambele funcții funcționează în orice script și necesită Core 2023.1 sau mai nou (pe canalul Next Core 2022.3, build 27019).

HSVTORGB#

HSVTORGB convertește o culoare dată prin nuanță, saturație și valoare într-o valoare rgbcolor cu canalele roșu, verde și albastru de la 0 la 255.

1

HSVTORGB(hue, saturation, value)

Returnează — rgbcolor cu proprietățile RED, GREEN și BLUE, fiecare rotunjită la un număr întreg 0 – 255.

Observații — Intrările nu sunt limitate la intervalul lor. Păstrați saturation și value între 0 și 1, altfel canalele depășesc intervalul 0 – 255.

Exemplu

VAR green := HSVTORGB(120, 1, 1);
green.GREEN;
# Result: 255

Exemplu — scriptul de scriere al unei lumini RGB prin HTTP

În scriptul de scriere al unei lumini color transmiteți valorile nuanței (Hd) și saturației (Sa) luminii, iar luminozitatea păstrați-o separat. Aici sunt variabile locale, ca exemplul să ruleze de sine stătător:

VAR hue := 30;
VAR saturation := 1;
VAR color := HSVTORGB(hue, saturation, 1);
"red=" + color.RED + "&green=" + color.GREEN + "&blue=" + color.BLUE;
# Result: "red=255&green=128&blue=0"

Consultați și — RGBTOHSV, SENDHTTPREQUEST.

RGBTOHSV#

RGBTOHSV convertește canalele roșu, verde și albastru (0 – 255) într-o valoare hsvcolor cu nuanța în grade și saturația și valoarea de la 0 la 1.

1

RGBTOHSV(red, green, blue)

Returnează — hsvcolor cu HUE (0 – 360, cu parte zecimală), SATURATION (0 – 1) și VALUE (0 – 1). Pentru culorile gri, la care toate canalele sunt egale, HUE și SATURATION sunt 0.

Exemplu — citirea nuanței unei lumini care raportează roșu, verde și albastru

VAR hsv := RGBTOHSV(255, 128, 0);
ROUND(hsv.HUE);
# Result: 30

VAR hsv := RGBTOHSV(255, 128, 0);
ROUND(hsv.SATURATION * 100) / 100;
# Result: 1

Valorile rgbcolor și hsvcolor#

rgbcolor și hsvcolor sunt tipurile de valori returnate de funcțiile de culoare; proprietățile lor se pot citi și scrie.

Ambele nume de tip pot declara o variabilă:

rgbcolor colour := HSVTORGB(240, 1, 0.5);
colour.BLUE;
# Result: 128

Consultați și — Tipuri de date, Variabile și constante.