Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

hue-rotate() — rotation de teinte du tampon

`hue-rotate()` fait tourner les couleurs d’une image rendue selon l’angle donné au moyen d’une matrice de filtre.

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

Syntaxe

hue-rotate( [ <angle> | <zero> ]? )

hue-rotate() fait tourner les couleurs d’une image rendue selon l’angle donné au moyen d’une matrice de filtre.

L’exemple conserve le pixel rouge 255,0,0 avec hue-rotate(0deg) comme avec hue-rotate(). hue-rotate(120deg) donne 0,113,0 et hue-rotate(480deg) le même 0,113,0, ce qui montre l’effet visuel périodique d’un tour complet.

Grammaire: hue-rotate( [ <angle> | <zero> ]? ).

L’argument omis vaut zéro, mais l’implémentation ne doit pas normaliser la valeur enregistrée modulo 360deg, car les angles supérieurs servent aux animations. La fonction agit dans une liste filter sur le tampon rendu ; l’ordre des filtres change donc le résultat. C’est une rotation matricielle RGB, pas une modification de la composante de teinte de hsl() ; saturation et luminance peuvent varier ou être écrêtées.

Exemples

const sample=async filter=>{const svg='<svg xmlns="http://www.w3.org/2000/svg" width="4" height="4"><foreignObject width="4" height="4"><div xmlns="http://www.w3.org/1999/xhtml" style="width:4px;height:4px;background:rgb(255 0 0);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=4;const context=canvas.getContext('2d');context.drawImage(image,0,0);return [...context.getImageData(2,2,1,1).data].slice(0,3).join(',')};
const zero=await sample('hue-rotate(0deg)');
const omitted=await sample('hue-rotate()');
const turn120=await sample('hue-rotate(120deg)');
const turn480=await sample('hue-rotate(480deg)');
console.log('zero='+zero+'; omitted='+omitted+'; turn-120='+turn120+'; turn-480='+turn480);

Résultat

zero=255,0,0; omitted=255,0,0; turn-120=0,113,0; turn-480=0,113,0

`hue-rotate()` fait tourner les couleurs d’une image rendue selon l’angle donné au moyen d’une matrice de filtre.

Sources