Jump to content

Dokumentation/Calc Funktionen/FARBE

From The Document Foundation Wiki
This page is a translated version of the page Documentation/Calc Functions/COLOR and the translation is 100% complete.


Funktionsname:

FARBE

Kategorie:

Mathematisch

Zusammenfassung:

Kombiniert spezifische Werte aus rot, grün, blau und Alphakanal einer RGBA-Farb-Spezifikation um einen einzelnen codierten Wert zu erzeugen.

Syntax:

FARBE(Rot;Grün;Blau[;Alpha])

Rückgabewerte:

Gibt eine Ganzzahl im Bereich [0, 232-1] zurück, welche die Farbe aus den angegebenen Komponenten darstellt.

Argumente:

Rot ist eine Ganzzahl aus dem Bereich [0, 255] oder eine Referenz auf die Zelle, die diese Zahl enthält. Die Intensität der roten Farbe.

Grün ist eine Ganzzahl aus dem Bereich [0, 255] oder eine Referenz auf die Zelle, die diese Zahl enthält. Die Intensität der grünen Farbe.

Blau ist eine Ganzzahl aus dem Bereich [0, 255] oder eine Referenz auf die Zelle, die diese Zahl enthält. Die Intensität der blauen Farbe.

Alpha ist eine Ganzzahl aus dem Bereich [0, 255] oder eine Referenz auf die Zelle, die diese Zahl enthält. die dem Alphakanal entspricht. Der Standard-Wert ist 0. Bei einem Wert von 0 ist die Farbe komplett transparent, bei einem Wert von 255 ist die Farbe komplett deckend.

  • Falls irgendein Argument nicht numerisch ist, dann gibt FARBE einen #WERT!-Fehler zurück.
  • Falls irgendein Argument keine Ganzzahl ist, dann verkürzt FARBE diesen Wert auf eine Ganzzahl.
  • Falls irgendein Argument kleiner als 0 oder größer als 255 ist, dann meldet FARBE einen invalid argument error (Fehler:502).

Zusätzliche Informationen:

  • Der von FARBE zurückgegebene Wert hat den Alpha-Wert in seinen höchsten 8 Bits, gefolgt vom Rot-Wert, Grün-Wert und schließlich dem Blau-Wert in den untersten 8 Bits.
  • FARBE setzt die Werte nach folgender Formel zusammen:
    [math]\displaystyle{ \text{FARBE}(rot, grün, blau, alpha)~=~256*256*256*alpha~+~ 256*256*rot~+~256*grün~+~blau }[/math]
  • 232 ist gleich 4294967296.

Beispiele:

Formel Beschreibung Ergebnis
=FARBE(255; 255; 255; 255) Alle Komponenten stehen auf ihrem Maximalwert und FARBE gibt den Wert 4294967295 (hex 0xFFFFFFFF) zurück. 4294967295
=FARBE(D1; D2; D3; D4), wobei die Zellen D1, D2, D3 und D4 alle den Wert 119 haben. Alle Komponenten stehen 119 und FARBE gibt den Wert 2004318071 (hex 0x77777777) zurück. 2004318071
=FARBE(119,2; 119,7; 119,5; 119,9) FARBE nimmt den ganzzahligen Anteil jedes Arguments. Nach der Kürzung haben alle Komponenten den Wert 119 und FARBE gibt den Wert 2004318071 (hex 0x77777777) zurück. 2004318071
=FARBE(255; 255; 255) Hier ist kein Wert für den Alphakanal angegeben. Daher wird der Standardwert 0 verwendet. FARBE gibt den Wert 16777215 (hex 0x00FFFFFF) zurück. 16777215
=FARBE(11; 12; 13; 10) Dieses Beispiel zeigt sehr schön, wie die Funktion den codierten Wert anhand der Struktur als Hexadezimal-Wert ermittelt.

FARBE gibt den Wert 168496141 (hex 0x0A0B0C0D) zurück. || 168496141

Ähnliche LibreOffice Funktionen:

Nichts

ODF Standard:

Nichts

Betroffene (oder ähnliche) EXCEL-Funktionen:

Nichts