Színek

A színfüggvények a HSV modell — színárnyalat (hue), telítettség (saturation) és érték (value, azaz fényerő) — és a vörös, zöld és kék csatornákból álló RGB modell között váltanak. A TapHome színes lámpája színárnyalattal és telítettséggel dolgozik; a Packet parser vagy Modbus szkriptekből vezérelt eszközök közül viszont sok vörös, zöld és kék értéket vár. Mindkét függvény minden szkriptben működik; szükséges verzió: Core 2023.1 vagy újabb.

HSVTORGB#

A HSVTORGB a színárnyalattal, telítettséggel és értékkel megadott színt rgbcolor értékké alakítja, amelynek vörös, zöld és kék csatornája 0 és 255 között van.

1

HSVTORGB(hue, saturation, value)

Visszatérési érték — rgbcolor a RED, GREEN és BLUE tulajdonságokkal, mindegyik egész számra kerekítve 0 – 255 között.

Megjegyzések — A bemenetek nincsenek a tartományukra korlátozva. A saturation és a value értékét tartsd 0 és 1 között, különben a csatornák túllépik a 0 – 255 tartományt.

Példa

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

Példa — RGB lámpa író szkriptje HTTP-n keresztül

Színes lámpa író szkriptjében add át a lámpa színárnyalatát (Hd) és telítettségét (Sa), a fényerőt pedig kezeld külön. Itt helyi változók, hogy a példa önmagában is lefusson:

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"

Lásd még — RGBTOHSV, SENDHTTPREQUEST.

RGBTOHSV#

Az RGBTOHSV a vörös, zöld és kék csatornát (0 – 255) hsvcolor értékké alakítja, amelyben a színárnyalat fokban, a telítettség és az érték pedig 0 és 1 között van.

1

RGBTOHSV(red, green, blue)

Visszatérési érték — hsvcolor a HUE (0 – 360, törtrésszel), SATURATION (0 – 1) és VALUE (0 – 1) tulajdonságokkal. Szürke színeknél, ahol minden csatorna egyenlő, a HUE és a SATURATION értéke 0.

Példa — vörös, zöld és kék értéket jelentő lámpa színárnyalatának kiolvasása

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

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

rgbcolor és hsvcolor értékek#

Az rgbcolor és a hsvcolor a színfüggvények által visszaadott értéktípusok; tulajdonságaik olvashatók és írhatók.

Mindkét típusnév használható változó deklarálására:

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

Lásd még — Adattípusok, Változók és konstansok.