WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

matrix3d(): eine homogene 3D-Transformation

Beschreibe eine dreidimensionale Transformation mit sechzehn spaltenweise angeordneten Koeffizienten.

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

Syntax

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

matrix3d() liefert die sechzehn Koeffizienten einer homogenen 4-mal-4-Transformationsmatrix. CSS führt sie spaltenweise auf, nicht zeilenweise. Bei einer gewöhnlichen affinen Transformation enthalten die dreizehnte, vierzehnte und fünfzehnte Zahl die Verschiebungen in x-, y- und z-Richtung. Die Diagonale kann Skalierung beschreiben; andere Koeffizienten können Drehung, Scherung oder perspektivische Effekte darstellen.

Eine z-Verschiebung ungleich null lässt ein Objekt nicht automatisch größer oder kleiner erscheinen. Perspektive muss durch die Transformation oder einen geeigneten Perspektivkontext eingeführt werden. Auch transform-origin und der umgebende 3D-Darstellungskontext beeinflussen das Ergebnis. Eine effektiv zweidimensionale Matrix kann der Browser bei der Serialisierung vereinfachen; sechzehn hingeschriebene Werte garantieren keinen sichtbaren 3D-Effekt.

Das Beispiel skaliert eine Box von 40 mal 30 Pixeln mit 2 und 3 und verschiebt sie dann in einer Matrix ohne Perspektive um 10,20,30. DOMMatrix meldet alle drei Verschiebungskomponenten und wegen der z-Komponente is2D als false. Das gemessene gerenderte Rechteck bleibt ohne perspektivische Vergrößerung 80 mal 90, während seine normalen Layoutabmessungen unverändert bleiben.

Beispiele

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

Ergebnis

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

Der z-Wert ist in der Matrix vorhanden, obwohl die orthografische Bildschirmprojektion daraus keine Größenänderung macht.

Quellen