Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / CSS

matrix3d(): una transformación homogénea en 3D

Expresa una transformación tridimensional con dieciséis coeficientes ordenados por columnas.

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

Sintaxis

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

matrix3d() proporciona los dieciséis coeficientes de una matriz de transformación homogénea de 4 por 4. CSS los enumera por columnas, no por filas. En una transformación afín ordinaria, los valores decimotercero, decimocuarto y decimoquinto contienen las traslaciones x, y y z. La diagonal puede codificar la escala y otros coeficientes representar rotación, sesgo o efectos de perspectiva.

Una traslación z distinta de cero no hace que un objeto parezca automáticamente mayor o menor. La perspectiva debe introducirse mediante la transformación o un contexto apropiado. transform-origin y el contexto de renderizado 3D circundante también afectan al resultado. El navegador puede simplificar al serializar una matriz que en la práctica sea bidimensional; escribir dieciséis valores no garantiza un efecto 3D visible.

El ejemplo escala una caja de 40 por 30 píxeles por 2 y 3 y luego la traslada 10,20,30 en una matriz sin perspectiva. DOMMatrix informa de las tres componentes y devuelve is2D como false debido a z. La caja renderizada sigue midiendo 80 por 90, sin ampliación por perspectiva, mientras sus dimensiones normales de diseño no cambian.

Ejemplos

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

El valor z está presente en la matriz, aunque la proyección ortográfica sobre la pantalla no lo convierta en un cambio de tamaño.

Fuentes