Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

matrix3d(): una trasformazione omogenea in 3D

Esprimi una trasformazione tridimensionale con sedici coefficienti disposti per colonne.

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

Sintassi

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

matrix3d() fornisce i sedici coefficienti di una matrice di trasformazione omogenea 4 per 4. CSS li elenca colonna per colonna, non riga per riga. In una normale trasformazione affine, il tredicesimo, quattordicesimo e quindicesimo valore contengono le traslazioni x, y e z. La diagonale può rappresentare la scala; altri coefficienti descrivono rotazione, inclinazione o effetti legati alla prospettiva.

Una traslazione z diversa da zero non fa apparire automaticamente un oggetto più grande o più piccolo. La prospettiva va introdotta dalla trasformazione o da un contesto appropriato. Anche transform-origin e il contesto di rendering 3D circostante influenzano il risultato. Il browser può semplificare nella serializzazione una matrice di fatto bidimensionale: scrivere sedici valori non garantisce un effetto 3D visibile.

L’esempio scala un riquadro di 40 per 30 pixel per 2 e 3, poi lo trasla di 10,20,30 in una matrice senza prospettiva. DOMMatrix riporta le tre componenti di traslazione e is2D come false a causa della componente z. Il rettangolo renderizzato resta 80 per 90, senza ingrandimento prospettico, mentre le dimensioni normali del layout non cambiano.

Esempi

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

Risultato

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

Il valore z è presente nella matrice anche se la proiezione ortografica sullo schermo non lo trasforma in una variazione di dimensione.

Fonti