Matrix4
Methods
Matrix4 est une matrice 4×4 en double précision stockée en ordre ligne-major avec 16 éléments (m00–m33). Elle est utilisée pour les calculs de transformation monde/local, les projections personnalisées, et la décomposition des transformations de nœuds en translation, rotation et mise à l’échelle.
Methods: aspose.threed.utilities
from aspose.threed.utilities import Matrix4Methods
| Methods | Methods |
|---|---|
Matrix4() | Matrice identité |
Matrix4(m00, m01, ..., m33) | Constructeur explicite à 16 éléments (ordre ligne-major) |
Matrix4(values) | Construit à partir d’une liste de 16 float valeurs |
Propriétés des éléments
Les éléments sont nommés mRC où R est la ligne (0–3) et C est la colonne (0–3). Par exemple, m03 est la ligne 0, colonne 3 (la translation X lorsque la matrice encode une transformation). Toutes les 16 propriétés (m00 à travers m33) sont lisibles et modifiables.
La matrice peut également être accédée par indice plat : mat[0]–mat[15].
Propriétés calculées
| Methods | Methods | Methods |
|---|---|---|
determinant | float | Déterminant scalaire de la matrice |
Méthodes de fabrique statiques
| Methods | Type de retour | Methods |
|---|---|---|
Matrix4.get_identity() | Matrix4 | Renvoie une matrice identité |
Matrix4.translate(tx, ty, tz) | Matrix4 | Matrice de translation ; accepte également un Vector3 ou un scalaire unique pour une translation uniforme |
Matrix4.scale(sx, sy, sz) | Matrix4 | Matrice d’échelle ; accepte également un Vector3 ou un scalaire unique pour une échelle uniforme |
Matrix4.rotate(angle, axis) | Matrix4 | Matrice de rotation à partir d’un angle (radians) et Vector3 axe; accepte également un Quaternion comme seul argument |
Matrix4.rotate_from_euler(rx, ry, rz) | Matrix4 | Matrice de rotation à partir des angles d’Euler (radians); accepte également un Vector3 |
Méthodes d’instance
| Methods | Type de retour | Methods |
|---|---|---|
concatenate(m2) | Matrix4 | Renvoie le produit matriciel self × m2 |
normalize() | Matrix4 | Renvoie une copie avec les axes de rotation ré-orthonormés (échelle supprimée des colonnes de rotation) |
transpose() | Matrix4 | Renvoie la matrice transposée |
inverse() | Matrix4 | Renvoie l’inverse; lève ValueError si la matrice est singulière |
decompose(translation, scaling, rotation) | None | Décompose en composants TRS. Les résultats sont écrits dans des listes à un seul élément: translation[0] → Vector3, scaling[0] → Vector3, rotation[0] → Quaternion |
set_trs(translation, rotation, scale) | None | Définit la matrice en place à partir de la translation Vector3, rotation Quaternion ou Vector3 (Euler), et mise à l’échelle Vector3 |
to_array() | list[float] | Renvoie les 16 éléments sous forme de liste plate |
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