Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

hue-rotate() — rotação de matiz da memória intermédia

`hue-rotate()` roda as cores de uma imagem representada pelo ângulo indicado através de uma matriz de filtro.

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

Sintaxe

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

hue-rotate() roda as cores de uma imagem representada pelo ângulo indicado através de uma matriz de filtro.

O exemplo mantém o píxel vermelho 255,0,0 com hue-rotate(0deg) e com hue-rotate(). hue-rotate(120deg) produz 0,113,0 e hue-rotate(480deg) o mesmo 0,113,0, demonstrando o efeito visual periódico de uma volta completa.

Gramática: hue-rotate( [ <angle> | <zero> ]? ).

O argumento omitido vale zero, mas a implementação não pode normalizar o valor guardado módulo 360deg, pois ângulos maiores são necessários para animações. A função atua numa lista filter sobre a memória já representada, pelo que a ordem dos filtros altera o resultado. É uma rotação matricial RGB, não uma alteração da componente de matiz de hsl(); saturação e luminância podem mudar ou ser cortadas.

Exemplos

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);

Resultado

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

`hue-rotate()` roda as cores de uma imagem representada pelo ângulo indicado através de uma matriz de filtro.

Fontes