HSL-Funktion

Gibt einen Wert zurück, der einen Index in der Farbpalette des Dokuments darstellt. Sie gibt eine Farbe anhand ihrer Farbton-, Sättigungs- und Leuchtkraftkomponenten an.

Syntax

HSL(hue, saturation, luminosity )

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
Farbton	Erforderlich	Number	Der Farbton einer Farbe wird als Zahl im Bereich von 0 bis einschließlich 239 ausgedrückt oder als Ausdruck, der als eine derartige Zahl ausgewertet wird.
Sättigung	Erforderlich	Number	Die Sättigung einer Farbe wird als Zahl im Bereich von 0 bis einschließlich 240 ausgedrückt oder als Ausdruck, der als eine derartige Zahl ausgewertet wird.
Leuchtkraft	Erforderlich	Number	Die Helligkeit einer Farbe wird als Zahl im Bereich von 0 bis einschließlich 240 ausgedrückt oder als Ausdruck, der als eine derartige Zahl ausgewertet wird.

Rückgabewert

Zahl

Hinweise

Wenn die durch die Funktion zurückgegebene Farbe nicht bereits in der Farbpalette des aktuellen Dokuments vorhanden ist, wird sie der Liste der verfügbaren Farben im Dokument hinzugefügt.

In der folgenden Tabelle sind einige Standardfarben mit ihren Farbton-, Sättigungs- und Helligkeitswerten aufgelistet.

Color	Farbton	Sättigung	Helligkeitswert
Black	0	0	24
Blau	160	240	120
Grün	80	240	120
Cyan	120	240	120
Rot	0	240	120
Magenta	200	240	120
Gelb	40	240	120
Weiß	0	0	240

Beispiel 1

HSL(160.240.120)

Gibt den Index für die Farbe Blau zurück.

Beispiel 2

HSL(HUE(FillForegnd),SAT(FillForegnd),MIN(LUM(FillForegnd)+100,240))

Gibt den Index für eine Farbe zurück, der die Vordergrundfüllfarbe mit erhöhter Helligkeit darstellt.