WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

brightness() — Helligkeitsmultiplikator eines Filters

`brightness()` ist eine Filterfunktion, die die Farbkomponenten des Eingabebildes multipliziert und es dadurch abdunkelt oder aufhellt, ohne die Größe seines Layoutkastens zu ändern.

Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntax

brightness( [ <number> | <percentage> ]? )

brightness() ist eine Filterfunktion, die die Farbkomponenten des Eingabebildes multipliziert und es dadurch abdunkelt oder aufhellt, ohne die Größe seines Layoutkastens zu ändern.

Das Beispiel setzt filter: brightness(150%). Der berechnete Wert ist brightness(1.5), und das Pixel rgb(40 80 120) wird zu 60,120,180. Ein eigener Durchlauf mit brightness(0) ergibt Schwarz 0,0,0 und belegt damit den Pixeleffekt statt nur die Parserakzeptanz.

Grammatik: brightness( [ <number> | <percentage> ]? ).

Das Argument darf <number> oder <percentage> sein: 1 und 100% lassen das Bild unverändert, 0 erzeugt Schwarz, und Werte über 1 hellen ohne Obergrenze auf. Negative Werte sind verboten. Ohne Argument gilt 1; auch bei der Interpolation von Filterlisten erhält eine fehlende passende Funktion den anfänglichen Interpolationswert 1.

Beispiele

const swatch=document.createElement('div');document.body.append(swatch);swatch.style.filter='brightness(150%)';const computed=getComputedStyle(swatch).filter;const source=document.createElement('canvas'),lit=document.createElement('canvas'),dark=document.createElement('canvas');for(const canvas of [source,lit,dark]){canvas.width=canvas.height=1}const sourceContext=source.getContext('2d');sourceContext.fillStyle='rgb(40 80 120)';sourceContext.fillRect(0,0,1,1);const litContext=lit.getContext('2d');litContext.filter=computed;litContext.drawImage(source,0,0);const darkContext=dark.getContext('2d');darkContext.filter='brightness(0)';darkContext.drawImage(source,0,0);const pixel=[...litContext.getImageData(0,0,1,1).data].slice(0,3),zero=[...darkContext.getImageData(0,0,1,1).data].slice(0,3);if(computed!=='brightness(1.5)'||pixel.join(',')!=='60,120,180'||zero.join(',')!=='0,0,0')throw new Error('brightness evidence mismatch: '+[computed,pixel,zero]);console.log('computed='+computed+'; pixel='+pixel.join(',')+'; zero='+zero.join(','));

Ergebnis

computed=brightness(1.5); pixel=60,120,180; zero=0,0,0

`brightness()` ist eine Filterfunktion, die die Farbkomponenten des Eingabebildes multipliziert und es dadurch abdunkelt oder aufhellt, ohne die Größe seines Layoutkastens zu ändern.

Quellen