CKTIS / CSS
sepia(): stopniowany filtr kolorów w odcieniach sepii
Nadaj rysowanemu obrazowi sepię i rozróżnij pusty argument, zero oraz wartości powyżej 100%.
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
filter: sepia(50%);sepia(amount) przekształca rysowane kolory w stronę palety sepii. Zero pozostawia kolory wejściowe bez zmian, 100% lub 1 stosuje pełne przekształcenie, a wartości pośrednie stopniują efekt. Pusty argument w sepia() oznacza 1. Wartości większe od 100% są przyjmowane, ale ograniczane do pełnego efektu; wartości ujemne są niepoprawne.
To filtr rysowanego elementu, więc może objąć łącznie jego tekst, tło i potomków. Nie edytuje pliku obrazu ani nie zmienia wymiarów elementu w układzie. Połączenie sepii z innymi filtrami wykonuje je według kolejności listy i może zmienić wynik. W przeciwieństwie do saturate() większy dozwolony argument nie zwiększa efektu ponad maksimum.
Przykład rysuje nieprzezroczysty obszar RGB(80,120,160) i odczytuje piksel przez ścieżkę renderowania SVG/canvas przeglądarki. W Chromium 157 zmierzone wartości RGBA wynoszą 80,120,160,255 dla zera, 117,129,133,255 dla połowy i 154,137,107,255 dla pełnego efektu. Puste nawiasy i 200% dają ten sam pełny wynik; postać ujemna nie przechodzi CSS.supports().
Przykłady
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)'));Wynik
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
To zmierzone piksele z opisanej ścieżki renderowania, a nie obietnica identycznych bajtów w każdym potoku graficznym. Stały kanał alfa oraz zgodność pełnego, pustego i nadmiarowego argumentu pokazują istotne różnice.