CKTIS / CSS
saturate(): změna sytosti vykresleného obrazu
Použijte filtr s barevnou maticí na vykreslený obsah bez změny rozvržení či zdrojových barev.
Verze: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
filter: saturate(200%);Ve vlastnosti filter upravuje saturate() sytost vykresleného vstupu. Argument je nezáporné číslo nebo procento: 0 odstraní sytost, 1 či 100% ponechá barvy beze změny a hodnoty nad 100% účinek zesílí. Vynechaný argument má hodnotu 1. Záporný argument je neplatný; neobrací účinek.
Jde o maticovou operaci na kanálech RGB, nikoli o úpravu složky sytosti v barvě HSL. Nemusí zachovat původní odstín ani světlost a kanály se mohou oříznout na hranicích svého rozsahu. Filtr použitý na prvek ovlivňuje jeho vykreslený obsah včetně potomků, aniž by přeskládal rozvržení nebo přepsal původní soubor obrázku a deklarace barev CSS. Neposkytuje novou hodnotu barvy pro vlastnost color.
Příklad skutečně rasterizuje obdélník v barvě 120,80,40 a čte jeho pixely. V Chromium 157 dává 0 šedou 86,86,86; 1 a vynechaný argument zachovávají 120,80,40; 200% dává 154,74,0. Alfa v těchto neprůhledných vzorcích zůstává 255. Modrý kanál dosahuje dolní meze, což ukazuje, proč silnější sytost není prosté procentní zvýšení každého kanálu. Kontrola záporné syntaxe vrací false.
Příklady
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)'));Výsledek
0=86,86,86,255 1=120,80,40,255 200%=154,74,0,255 omitted=120,80,40,255 negative=false
Jde o vzorky vykreslených pixelů, nikoli jen o přijaté deklarace CSS. Přesné celočíselné kanály odrážejí rasterizaci a zaokrouhlování zaznamenaného prohlížeče; podstatné jsou nezměněný obraz a shoda šedých kanálů.