WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

sepia(): ein abgestufter Farbfilter in Brauntönen

Wende eine Sepiaumwandlung auf das gerenderte Bild an und unterscheide ein ausgelassenes Argument, null und Werte über 100%.

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

Syntax

filter: sepia(50%);

sepia(amount) wandelt gerenderte Farben in Richtung einer Sepiapalette um. Null lässt die Eingangsfarben unverändert, 100% oder 1 bewirkt die vollständige Umwandlung, und Zwischenwerte dosieren den Effekt. Das ausgelassene Argument in sepia() bedeutet 1. Werte über 100% werden akzeptiert, aber auf den vollständigen Effekt begrenzt; negative Werte sind ungültig.

Der Filter wirkt auf das gerenderte Element und kann daher dessen Text, Hintergrund und Nachkommen gemeinsam betreffen. Er bearbeitet keine Bilddatei und verändert nicht die Layoutabmessungen des Elements. Wird Sepia mit anderen Filtern kombiniert, werden sie in der Listenreihenfolge angewendet, was das Ergebnis verändern kann. Anders als bei saturate() verstärken größere zulässige Werte diesen Effekt nicht über sein Maximum hinaus.

Das Beispiel zeichnet eine undurchsichtige Fläche mit RGB(80,120,160) und liest sie über den SVG/canvas-Renderingpfad des Browsers aus. In Chromium 157 betragen die gemessenen RGBA-Werte 80,120,160,255 bei null, 117,129,133,255 bei halber und 154,137,107,255 bei voller Stärke. Leere Klammern und 200% ergeben denselben vollständigen Effekt; die negative Form wird von CSS.supports() abgelehnt.

Beispiele

async function sample(filter) {
  const svg='<svg xmlns="http://www.w3.org/2000/svg" width="8" height="8"><foreignObject width="8" height="8"><div xmlns="http://www.w3.org/1999/xhtml" style="width:8px;height:8px;background:rgb(80 120 160);filter:'+filter+'"></div></foreignObject></svg>';
  const image=new Image();
  image.src='data:image/svg+xml;charset=utf-8,'+encodeURIComponent(svg);
  await image.decode();
  const canvas=document.createElement('canvas');canvas.width=canvas.height=8;
  const context=canvas.getContext('2d');context.drawImage(image,0,0);
  return [...context.getImageData(4,4,1,1).data].join(',');
}
const normal=await sample('sepia(0)');
const half=await sample('sepia(50%)');
const full=await sample('sepia(1)');
const omitted=await sample('sepia()');
const over=await sample('sepia(200%)');
console.log('normal='+normal+'; half='+half+'; full='+full+'; omitted='+omitted+'; over='+over+'; negative='+CSS.supports('filter','sepia(-0.1)'));

Ergebnis

normal=80,120,160,255; half=117,129,133,255; full=154,137,107,255; omitted=154,137,107,255; over=154,137,107,255; negative=false

Dies sind gemessene Pixel aus dem angegebenen Renderingpfad, keine für jede Grafikpipeline garantierten Bytewerte. Der unveränderte Alphakanal und die übereinstimmenden Messungen bei vollem, ausgelassenem und überhöhtem Argument zeigen die beabsichtigten Unterschiede.

Quellen