Documentatie/Calc-functies/KLEUR

From The Document Foundation Wiki
Jump to navigation Jump to search
This page is a translated version of the page Documentation/Calc Functions/COLOR and the translation is 100% complete.
Other languages:
English • ‎Nederlands • ‎dansk • ‎español • ‎עברית



Functienaam:

KLEUR

Categorie:

Wiskundig

Samenvatting:

Combineert gespecificeerde waarden van de rode, groene, blauwe en alfakanalen van een RGBA-kleurrepresentatie om een enkele gecodeerde waarde te produceren.

Syntaxis:

KLEUR(Rood; Groen; Blauw[; Alfa])

Retourneert:

Retourneert een geheel getal in het bereik [0, 232-1] dat de kleurwaarde is die is samengesteld uit de opgegeven componenten.

Argumenten:

Rood is een geheel getal in het bereik [0, 255] of een verwijzing naar een cel die dat getal bevat, dat wil zeggen de intensiteit van de rode kleur.

Groen is een geheel getal in het bereik [0, 255] of een verwijzing naar een cel die dat getal bevat, dat wil zeggen de intensiteit van de groene kleur.

Blauw is een geheel getal in het bereik [0, 255] of een verwijzing naar een cel die dat getal bevat, dat wil zeggen de intensiteit van de blauwe kleur.

Alfa is een geheel getal in het bereik [0, 255] of een verwijzing naar een cel die dat getal bevat, dat wil zeggen de waarde voor het alfakanaal. Indien weggelaten, wordt een standaardwaarde van 0 toegepast. Een waarde van 0 betekent dat de kleur volledig transparant is, terwijl een waarde van 255 een volledig dekkende kleur geeft.

  • Als een argument niet-numeriek is, retourneert KLEUR als fout #WAARDE!.
  • Als een argument een niet-gehele waarde is, converteert KLEUR het naar een geheel getal door de bodemwaarde ervan te nemen.
  • Als een argument kleiner is dan 0 of groter is dan 255, retourneert KLEUR als fout Ongeldig argument (Fout:502).

Aanvullende details:

  • De waarde die wordt geretourneerd door KLEUR heeft het alfa-voorbeeld in de meest significante 8 bits, gevolgd door het rode voorbeeld, groene voorbeeld en tenslotte het blauwe voorbeeld in de minst significante 8 bits.
  • COLOR combineert de voorbeelden met behulp van de volgende formule:

[math]\displaystyle{ \text{COLOR}(red, green, blue, alpha)~=~256*256*256*alpha~+~ 256*256*red~+~256*green~+~blue }[/math]

  • 232 is gelijk aan 4294967296.

Voorbeelden:

Formule Beschrijving Retourneert
=KLEUR(255; 255; 255; 255) Alle componenten nemen hun maximale waarden en KLEUR retourneert de waarde 4294967295 (hex 0xFFFFFFFF). 4294967295
=KLEUR(D1; D2; D3; D4) waarbij de cellen D1, D2, D3 en D4 allemaal het getal 119 bevatten. Alle componenten hebben de waarde 119 en KLEUR retourneert de waarde 2004318071 (hex 0x77777777). 2004318071
=KLEUR(119,2; 119,7; 119,5; 119,9) KLEUR neemt de bodemwaarde van elk argument. Na afkappen krijgen alle componenten de waarde 119 en KLEUR retourneert de waarde 2004318071 (hex 0x77777777). 2004318071
=KLEUR(255; 255; 255) Hier wordt geen waarde voor het alfakanaal gespecificeerd en wordt de standaardwaarde 0 aangenomen. KLEUR retourneert de waarde 16777215 (hex 0x00FFFFFF). 16777215
=KLEUR(11; 12; 13; 10) Dit voorbeeld is handig om te bevestigen hoe de functie de gecodeerde waarde construeert door de structuur in hexadecimale indeling te bekijken. KLEUR retourneert de waarde 168496141 (hex 0x0A0B0C0D). 168496141

Gerelateerde LibreOffice-functies:

Geen

ODF standaard:

Geen

Gelijkwaardige Excel-functies:

Geen