CKTIS / CSS
saturate(): nasycenie narysowanego obrazu
Zastosuj filtr macierzy kolorów do narysowanej treści bez zmiany układu ani kolorów źródłowych.
Wersja: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Składnia
filter: saturate(200%);Właściwość filter używa saturate() do zmiany nasycenia narysowanego obrazu wejściowego. Argument jest nieujemną liczbą lub procentem: 0 usuwa nasycenie, 1 albo 100% pozostawia kolory bez zmian, a wartości powyżej 100% wzmacniają efekt. Pominięty argument ma wartość 1. Argument ujemny jest nieprawidłowy; nie odwraca działania.
To operacja macierzowa na kanałach RGB, a nie edycja składowej nasycenia koloru HSL. Nie musi zachowywać pierwotnego odcienia ani jasności, a kanały mogą być obcinane na granicach zakresu. Filtr przypisany elementowi obejmuje jego narysowaną treść, także potomków, bez przestawiania układu i bez przepisywania oryginalnego pliku obrazu ani deklaracji kolorów CSS. Nie zwraca nowej wartości koloru dla właściwości color.
Przykład rzeczywiście rasteruje prostokąt w kolorze 120,80,40 i odczytuje piksele. W Chromium 157 wartość 0 daje szarość 86,86,86; 1 i pominięty argument zachowują 120,80,40; 200% daje 154,74,0. Alfa pozostaje 255 w tych nieprzezroczystych próbkach. Kanał niebieski osiąga dolną granicę, pokazując, dlaczego większe nasycenie nie oznacza prostego procentowego zwiększenia każdego kanału. Sprawdzenie składni ujemnej zwraca false.
Przykłady
const pixel=async amount=>{const svg='<svg xmlns="http://www.w3.org/2000/svg" width="8" height="8"><rect width="8" height="8" fill="rgb(120,80,40)" style="filter:saturate('+amount+')"/></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 ctx=canvas.getContext('2d');ctx.drawImage(image,0,0);return [...ctx.getImageData(4,4,1,1).data].join(',')};
for(const amount of ['0','1','200%',''])console.log((amount||'omitted')+'='+await pixel(amount));
console.log('negative='+CSS.supports('filter','saturate(-1)'));Wynik
0=86,86,86,255 1=120,80,40,255 200%=154,74,0,255 omitted=120,80,40,255 negative=false
To próbki narysowanych pikseli, a nie samo przyjęcie deklaracji CSS. Dokładne całkowite wartości kanałów odzwierciedlają rasteryzację i zaokrąglenia zapisanej przeglądarki; kluczowe są zgodność przypadku bez zmian i równość kanałów szarości.