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

CKTIS / CSS

matrix3d(): uma transformação homogénea em 3D

Represente uma transformação tridimensional com dezasseis coeficientes ordenados por colunas.

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

Sintaxe

transform: matrix3d(2,0,0,0, 0,3,0,0, 0,0,1,0, 10,20,30,1);

matrix3d() fornece os dezasseis coeficientes de uma matriz de transformação homogénea de 4 por 4. O CSS enumera-os coluna a coluna, não linha a linha. Numa transformação afim normal, os valores décimo terceiro, décimo quarto e décimo quinto contêm as translações x, y e z. A diagonal pode representar escala; outros coeficientes descrevem rotação, inclinação ou efeitos relacionados com perspetiva.

Uma translação z diferente de zero não faz um objeto parecer automaticamente maior ou menor. A perspetiva tem de ser introduzida pela transformação ou por um contexto apropriado. transform-origin e o contexto de renderização 3D envolvente também afetam o resultado. O navegador pode simplificar na serialização uma matriz efetivamente bidimensional; escrever dezasseis valores não garante um efeito 3D visível.

O exemplo aplica fatores de escala 2 e 3 a uma caixa de 40 por 30 píxeis e depois desloca-a 10,20,30 numa matriz sem perspetiva. DOMMatrix apresenta as três componentes de translação e is2D como false devido a z. O retângulo renderizado continua a medir 80 por 90, sem ampliação por perspetiva, enquanto as dimensões normais de disposição permanecem inalteradas.

Exemplos

const value='matrix3d(2,0,0,0, 0,3,0,0, 0,0,1,0, 10,20,30,1)';
const element=document.createElement('div');element.style.cssText='position:fixed;left:0;top:0;width:40px;height:30px;transform-origin:0 0';element.style.transform=value;document.body.append(element);
const rect=element.getBoundingClientRect();const matrix=new DOMMatrix(getComputedStyle(element).transform);
console.log('translation='+matrix.m41+','+matrix.m42+','+matrix.m43+'; rendered='+rect.width+'x'+rect.height+'; is2D='+matrix.is2D+'; perspective='+getComputedStyle(element).perspective);

Resultado

translation=10,20,30; rendered=80x90; is2D=false; perspective=none

O valor z está presente na matriz, embora a projeção ortográfica no ecrã não o transforme numa alteração de tamanho.

Fontes