Matrix4
Methods
Matrix4 ist eine 4×4‑Doppelpräzisionsmatrix, die zeilenweise gespeichert ist und 16 Elemente enthält (m00–m33).
Methods: aspose.threed.utilities
from aspose.threed.utilities import Matrix4Methods
| Methods | Methods |
|---|---|
Matrix4() | Einheitsmatrix |
Matrix4(m00, m01, ..., m33) | Expliziter 16‑Element‑Konstruktor (zeilenweise Reihenfolge) |
Matrix4(values) | Konstruiert aus einer Liste von 16 float Werten |
Elementeigenschaften
Elemente werden benannt mRC wobei R ist die Zeile (0–3) und C ist die Spalte (0–3). Zum Beispiel, m03 ist Zeile 0, Spalte 3 (die X‑Translation, wenn die Matrix eine Transformation kodiert). Alle 16 Eigenschaften (m00 durch m33) sind lesbar und schreibbar.
Die Matrix kann auch über einen flachen Index zugegriffen werden: mat[0]–mat[15].
Berechnete Eigenschaften
| Methods | Methods | Methods |
|---|---|---|
determinant | float | Skalare Determinante der Matrix |
Statische Fabrikmethoden
| Methods | Rückgabetyp | Methods |
|---|---|---|
Matrix4.get_identity() | Matrix4 | Gibt eine Einheitsmatrix zurück |
Matrix4.translate(tx, ty, tz) | Matrix4 | Translationsmatrix; akzeptiert auch ein Vector3 oder einen einzelnen Skalar für gleichmäßige Translation |
Matrix4.scale(sx, sy, sz) | Matrix4 | Skalierungsmatrix; akzeptiert auch ein Vector3 oder einen einzelnen Skalar für gleichmäßige Skalierung |
Matrix4.rotate(angle, axis) | Matrix4 | Rotationsmatrix aus Winkel (Bogenmaß) und Vector3 Achse; akzeptiert auch ein Quaternion als einziges Argument |
Matrix4.rotate_from_euler(rx, ry, rz) | Matrix4 | Rotationsmatrix aus Euler-Winkeln (Bogenmaß); akzeptiert auch ein Vector3 |
Instanzmethoden
| Methods | Rückgabetyp | Methods |
|---|---|---|
concatenate(m2) | Matrix4 | Gibt das Matrixprodukt zurück self × m2 |
normalize() | Matrix4 | Gibt eine Kopie zurück, bei der die Rotationsachsen re-orthonormiert sind (Skalierung aus den Rotationsspalten entfernt) |
transpose() | Matrix4 | Gibt die transponierte Matrix zurück |
inverse() | Matrix4 | Gibt die Inverse zurück; wirft ValueError wenn die Matrix singulär ist |
decompose(translation, scaling, rotation) | None | Zerlegt in TRS-Komponenten. Ergebnisse werden in ein-elementige Listen geschrieben: translation[0] → Vector3, scaling[0] → Vector3, rotation[0] → Quaternion |
set_trs(translation, rotation, scale) | None | Setzt die Matrix in-place aus der Translation Vector3, Rotation Quaternion oder Vector3 (Euler), und Skalierung Vector3 |
to_array() | list[float] | Gibt die 16 Elemente als flache Liste zurück |
Methods
from aspose.threed.utilities import Matrix4, Vector3, Quaternion
import math
# Build a transform: translate (5, 0, 0), rotate 90 deg around Y, scale 2x
t = Matrix4.translate(5.0, 0.0, 0.0)
r = Matrix4.rotate(math.radians(90), Vector3(0, 1, 0))
s = Matrix4.scale(2.0, 2.0, 2.0)
# Combine: scale first, then rotate, then translate
combined = t.concatenate(r.concatenate(s))
# Decompose the result back into TRS
translation = [None]
scaling = [None]
rotation = [None]
combined.decompose(translation, scaling, rotation)
print(translation[0]) # Vector3(5.0, 0.0, 0.0)
print(scaling[0]) # Vector3(2.0, 2.0, 2.0)
# Retrieve from a node's global transform
from aspose.threed import Scene
scene = Scene()
node = scene.root_node.create_child_node("box")
node.transform.translation = Vector3(10.0, 0.0, 0.0)
world_mat = node.global_transform.transform_matrix
print(world_mat.m03) # 10.0 — translation X