Matrix4
Methods
Matrix4 es una matriz de doble precisión 4×4 almacenada en orden por filas con 16 elementos (m00–m33). Se usa para cálculos de transformaciones mundial/local, proyecciones personalizadas y descomposición de transformaciones de nodos en traslación, rotación y escala.
Methods: aspose.threed.utilities
from aspose.threed.utilities import Matrix4Methods
| Methods | Methods |
|---|---|
Matrix4() | Matriz identidad |
Matrix4(m00, m01, ..., m33) | Constructor explícito de 16 elementos (orden por filas) |
Matrix4(values) | Construcciones a partir de una lista de 16 float valores |
Propiedades de los elementos
Los elementos se nombran mRC dónde R es la fila (0–3) y C es la columna (0–3). Por ejemplo, m03 es la fila 0, columna 3 (la traslación X cuando la matriz codifica una transformación). Todas las 16 propiedades (m00 a través de m33) son legibles y escribibles.
La matriz también puede ser accedida mediante un índice plano: mat[0]–mat[15].
Propiedades calculadas
| Methods | Methods | Methods |
|---|---|---|
determinant | float | Determinante escalar de la matriz |
Métodos de fábrica estáticos
| Methods | Tipo de retorno | Methods |
|---|---|---|
Matrix4.get_identity() | Matrix4 | Devuelve una matriz identidad |
Matrix4.translate(tx, ty, tz) | Matrix4 | Matriz de traslación; también acepta un Vector3 o un escalar único para una traslación uniforme |
Matrix4.scale(sx, sy, sz) | Matrix4 | Matriz de escala; también acepta un Vector3 o un escalar único para una escala uniforme |
Matrix4.rotate(angle, axis) | Matrix4 | Matriz de rotación a partir del ángulo (radianes) y Vector3 eje; también acepta un Quaternion como único argumento |
Matrix4.rotate_from_euler(rx, ry, rz) | Matrix4 | Matriz de rotación a partir de ángulos de Euler (radianes); también acepta un Vector3 |
Métodos de instancia
| Methods | Tipo de retorno | Methods |
|---|---|---|
concatenate(m2) | Matrix4 | Devuelve el producto de matrices self × m2 |
normalize() | Matrix4 | Devuelve una copia con los ejes de rotación re-ortogonalizados (escala eliminada de las columnas de rotación) |
transpose() | Matrix4 | Devuelve la matriz transpuesta |
inverse() | Matrix4 | Devuelve la inversa; lanza ValueError si la matriz es singular |
decompose(translation, scaling, rotation) | None | Descompone en componentes TRS. Los resultados se escriben en listas de un solo elemento: translation[0] → Vector3, scaling[0] → Vector3, rotation[0] → Quaternion |
set_trs(translation, rotation, scale) | None | Establece la matriz in-place a partir de la traslación Vector3, rotación Quaternion o Vector3 (Euler), y escala Vector3 |
to_array() | list[float] | Devuelve los 16 elementos como una lista plana |
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