Matrix4
Methods
Matrix4 este o matrice de precizie dublă 4×4 stocată în ordine pe rânduri cu 16 elemente (m00–m33). Este utilizată pentru calcule de transformare world/local, proiecții personalizate și descompunerea transformărilor nodului în translație, rotație și scară.
Methods: aspose.threed.utilities
from aspose.threed.utilities import Matrix4Methods
| Methods | Methods |
|---|---|
Matrix4() | Matrice identitate |
Matrix4(m00, m01, ..., m33) | Constructor explicit cu 16 elemente (ordine pe rânduri) |
Matrix4(values) | Construiește dintr-o listă de 16 float valori |
Proprietăți ale elementelor
Elementele sunt denumite mRC unde R este rândul (0–3) și C este coloana (0–3). De exemplu, m03 este rândul 0, coloana 3 (translația X când matricea codifică o transformare). Toate cele 16 proprietăți (m00 prin m33) sunt citibile și scriibile.
Matricea poate fi accesată și prin index plat: mat[0]–mat[15].
Proprietăți calculate
| Methods | Methods | Methods |
|---|---|---|
determinant | float | Determinant scalar al matricei |
Metode de fabrică statice
| Methods | Tip de returnare | Methods |
|---|---|---|
Matrix4.get_identity() | Matrix4 | Returnează o matrice identitate |
Matrix4.translate(tx, ty, tz) | Matrix4 | Matrice de translație; acceptă și un Vector3 sau un scalar unic pentru translație uniformă |
Matrix4.scale(sx, sy, sz) | Matrix4 | Matrice de scară; acceptă și un Vector3 sau un scalar unic pentru scară uniformă |
Matrix4.rotate(angle, axis) | Matrix4 | Matrice de rotație din unghi (radiani) și Vector3 axă; acceptă și un Quaternion ca singurul argument |
Matrix4.rotate_from_euler(rx, ry, rz) | Matrix4 | Matrice de rotație din unghiuri Euler (radiani); acceptă și un Vector3 |
Metode de instanță
| Methods | Tip de returnare | Methods |
|---|---|---|
concatenate(m2) | Matrix4 | Returnează produsul matricial self × m2 |
normalize() | Matrix4 | Returnează o copie cu axele de rotație re-ortogonalizate (scara eliminată din coloanele de rotație) |
transpose() | Matrix4 | Returnează matricea transpusă |
inverse() | Matrix4 | Returnează inversa; aruncă ValueError dacă matricea este singulară |
decompose(translation, scaling, rotation) | None | Descompune în componente TRS. Rezultatele sunt scrise în liste cu un singur element: translation[0] → Vector3, scaling[0] → Vector3, rotation[0] → Quaternion |
set_trs(translation, rotation, scale) | None | Setează matricea în loc din translație Vector3, rotație Quaternion sau Vector3 (Euler), și scară Vector3 |
to_array() | list[float] | Returnează cele 16 elemente ca o listă plată |
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