Matrix4
Methods
Matrix4 is een 4×4 double-precision matrix opgeslagen in rij-major volgorde met 16 elementen (m00–m33). Het wordt gebruikt voor wereld-/lokale transformatie‑berekeningen, aangepaste projecties en het ontleden van knooppunt‑transformaties in translatie, rotatie en schaal.
Methods: aspose.threed.utilities
from aspose.threed.utilities import Matrix4Methods
| Methods | Methods |
|---|---|
Matrix4() | Identiteitsmatrix |
Matrix4(m00, m01, ..., m33) | Expliciete 16‑elementen constructor (rij-major volgorde) |
Matrix4(values) | Construeert vanuit een lijst van 16 float waarden |
Elementeigenschappen
Elementen zijn benoemd mRC waar R is de rij (0–3) en C is de kolom (0–3). Bijvoorbeeld, m03 is rij 0, kolom 3 (de X‑translatie wanneer de matrix een transformatie codeert). Alle 16 eigenschappen (m00 tot m33) kunnen gelezen en geschreven worden.
De matrix kan ook benaderd worden via een platte index: mat[0]–mat[15].
Berekende eigenschappen
| Methods | Methods | Methods |
|---|---|---|
determinant | float | Scalair determinant van de matrix |
Statische fabrieksmethoden
| Methods | Retourtype | Methods |
|---|---|---|
Matrix4.get_identity() | Matrix4 | Retourneert een identiteitsmatrix |
Matrix4.translate(tx, ty, tz) | Matrix4 | Translatiesmatrix; accepteert ook een Vector3 of een enkele scalair voor uniforme translatie |
Matrix4.scale(sx, sy, sz) | Matrix4 | Schaalmatrix; accepteert ook een Vector3 of een enkele scalar voor uniforme schaal |
Matrix4.rotate(angle, axis) | Matrix4 | Rotatiematrix van hoek (radialen) en Vector3 as; accepteert ook een Quaternion als het enige argument |
Matrix4.rotate_from_euler(rx, ry, rz) | Matrix4 | Rotatiematrix van Euler-hoeken (radialen); accepteert ook een Vector3 |
Instantiemethoden
| Methods | Retourtype | Methods |
|---|---|---|
concatenate(m2) | Matrix4 | Retourneert het matrixproduct self × m2 |
normalize() | Matrix4 | Retourneert een kopie met de rotatieassen gere-orthonormeerd (schaal verwijderd uit rotatiekolommen) |
transpose() | Matrix4 | Retourneert de getransponeerde matrix |
inverse() | Matrix4 | Retourneert de inverse; werpt ValueError als de matrix singulier is |
decompose(translation, scaling, rotation) | None | Decomposeert in TRS-componenten. Resultaten worden geschreven naar één-element lijsten: translation[0] → Vector3, scaling[0] → Vector3, rotation[0] → Quaternion |
set_trs(translation, rotation, scale) | None | Stelt matrix in-place in op basis van translatie Vector3, rotatie Quaternion of Vector3 (Euler), en schaal Vector3 |
to_array() | list[float] | Retourneert de 16 elementen als een platte lijst |
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