Matrix4
Methods
Matrix4 er en 4×4 dobbelpresisjonsmatrise lagret i rad-major rekkefølge med 16 elementer (m00–m33). Det brukes til beregninger av verdens-/lokale transformasjoner, egendefinerte projeksjoner og dekomponering av node‑transformasjoner til translasjon, rotasjon og skalering.
Methods: aspose.threed.utilities
from aspose.threed.utilities import Matrix4Methods
| Methods | Methods |
|---|---|
Matrix4() | Identitetsmatrise |
Matrix4(m00, m01, ..., m33) | Eksplisitt 16‑element konstruktør (rad‑major rekkefølge) |
Matrix4(values) | Konstruksjoner fra en liste på 16 float verdier |
Elementegenskaper
Elementer er navngitt mRC hvor R er raden (0–3) og C er kolonnen (0–3). For eksempel, m03 er rad 0, kolonne 3 (X‑forskyvningen når matrisen koder en transformasjon). Alle 16 egenskapene (m00 gjennom m33) er lesbare og skrivbare.
Matrisa kan også nås via flat indeks: mat[0]–mat[15].
Beregnede egenskaper
| Methods | Methods | Methods |
|---|---|---|
determinant | float | Skalar determinant av matrisen |
Statiske fabrikkmetoder
| Methods | Returtype | Methods |
|---|---|---|
Matrix4.get_identity() | Matrix4 | Returnerer en identitetsmatrise |
Matrix4.translate(tx, ty, tz) | Matrix4 | Translasjonsmatrise; aksepterer også en Vector3 eller en enkelt skalar for ensartet translasjon |
Matrix4.scale(sx, sy, sz) | Matrix4 | Skaleringsmatrise; aksepterer også en Vector3 eller en enkelt skalar for jevn skalering |
Matrix4.rotate(angle, axis) | Matrix4 | Rotasjonsmatrise fra vinkel (radianer) og Vector3 akse; aksepterer også en Quaternion som eneste argument |
Matrix4.rotate_from_euler(rx, ry, rz) | Matrix4 | Rotasjonsmatrise fra Euler-vinkler (radianer); aksepterer også en Vector3 |
Instansmetoder
| Methods | Returtype | Methods |
|---|---|---|
concatenate(m2) | Matrix4 | Returnerer matriseproduktet self × m2 |
normalize() | Matrix4 | Returnerer en kopi med rotasjonsaksene re-ortogonaliserte (skalering fjernet fra rotasjonskolonnene) |
transpose() | Matrix4 | Returnerer den transponerte matrisen |
inverse() | Matrix4 | Returnerer inversen; kaster ValueError hvis matrisen er singulær |
decompose(translation, scaling, rotation) | None | Dekomponerer i TRS-komponenter. Resultatene skrives inn i lister med ett element: translation[0] → Vector3, scaling[0] → Vector3, rotation[0] → Quaternion |
set_trs(translation, rotation, scale) | None | Setter matrisen på stedet fra translasjon Vector3, rotasjon Quaternion eller Vector3 (Euler), og skalering Vector3 |
to_array() | list[float] | Returnerer de 16 elementene som en flat liste |
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