Matrix4
Methods
Matrix4 è una matrice 4×4 a doppia precisione memorizzata in ordine row-major con 16 elementi (m00–m33).
Methods: aspose.threed.utilities
from aspose.threed.utilities import Matrix4Methods
| Methods | Methods |
|---|---|
Matrix4() | Matrice identità |
Matrix4(m00, m01, ..., m33) | Costruttore esplicito a 16 elementi (ordine row-major) |
Matrix4(values) | Costruisce da un elenco di 16 float valori |
Proprietà degli Elementi
Gli elementi sono denominati mRC dove R è la riga (0–3) e C è la colonna (0–3). Per esempio, m03 è la riga 0, colonna 3 (la traslazione X quando la matrice codifica una trasformazione). Tutte le 16 proprietà (m00 fino a m33) sono leggibili e scrivibili.
La matrice può anche essere accessibile tramite indice piatto: mat[0]–mat[15].
Proprietà Calcolate
| Methods | Methods | Methods |
|---|---|---|
determinant | float | Determinante scalare della matrice |
Metodi di fabbrica statici
| Methods | Tipo di ritorno | Methods |
|---|---|---|
Matrix4.get_identity() | Matrix4 | Restituisce una matrice identità |
Matrix4.translate(tx, ty, tz) | Matrix4 | Matrice di traslazione; accetta anche un Vector3 o un singolo scalare per una traslazione uniforme |
Matrix4.scale(sx, sy, sz) | Matrix4 | Matrice di scala; accetta anche un Vector3 o un singolo scalare per scala uniforme |
Matrix4.rotate(angle, axis) | Matrix4 | Matrice di rotazione da angolo (radianti) e Vector3 asse; accetta anche un Quaternion come unico argomento |
Matrix4.rotate_from_euler(rx, ry, rz) | Matrix4 | Matrice di rotazione da angoli di Eulero (radianti); accetta anche un Vector3 |
Metodi di istanza
| Methods | Tipo di ritorno | Methods |
|---|---|---|
concatenate(m2) | Matrix4 | Restituisce il prodotto della matrice self × m2 |
normalize() | Matrix4 | Restituisce una copia con gli assi di rotazione ri-ortogonalizzati (scala rimossa dalle colonne di rotazione) |
transpose() | Matrix4 | Restituisce la matrice trasposta |
inverse() | Matrix4 | Restituisce l’inverso; solleva ValueError se la matrice è singolare |
decompose(translation, scaling, rotation) | None | Decompone in componenti TRS. I risultati sono scritti in liste a singolo elemento: translation[0] → Vector3, scaling[0] → Vector3, rotation[0] → Quaternion |
set_trs(translation, rotation, scale) | None | Imposta la matrice in loco dalla traslazione Vector3, rotazione Quaternion o Vector3 (Euler), e scala Vector3 |
to_array() | list[float] | Restituisce i 16 elementi come un elenco piatto |
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