Matrix4
Methods
Matrix4 är en 4×4 dubbelprecision-matris lagrad i radordning med 16 element (m00–m33).
Methods: aspose.threed.utilities
from aspose.threed.utilities import Matrix4Methods
| Methods | Methods |
|---|---|
Matrix4() | Identitetsmatris |
Matrix4(m00, m01, ..., m33) | Explicit 16-element konstruktor (radordning) |
Matrix4(values) | Konstruktor från en lista med 16 float värden |
Elementegenskaper
Elementen är namngivna mRC där R är raden (0–3) och C är kolumnen (0–3). Till exempel, m03 är rad 0, kolumn 3 (X-översättningen när matrisen kodar en transformation).m00 till m33) är läsbara och skrivbara.
Matrisen kan också nås via ett platt index: mat[0]–mat[15].
Beräknade egenskaper
| Methods | Methods | Methods |
|---|---|---|
determinant | float | Skalär determinant av matrisen |
Statiska fabriksmetoder
| Methods | Returtyp | Methods |
|---|---|---|
Matrix4.get_identity() | Matrix4 | Returnerar en identitetsmatris |
Matrix4.translate(tx, ty, tz) | Matrix4 | Translationsmatris; accepterar också en Vector3 eller en enda skalär för enhetlig translation |
Matrix4.scale(sx, sy, sz) | Matrix4 | Skalmatrix; accepterar också en Vector3 eller en enda skalär för enhetlig skala |
Matrix4.rotate(angle, axis) | Matrix4 | Rotationsmatris från vinkel (radianer) och Vector3 axel; accepterar också en Quaternion som det enda argumentet |
Matrix4.rotate_from_euler(rx, ry, rz) | Matrix4 | Rotationsmatris från Euler-vinklar (radianer); accepterar också en Vector3 |
Instansmetoder
| Methods | Returtyp | Methods |
|---|---|---|
concatenate(m2) | Matrix4 | Returnerar matrisprodukten self × m2 |
normalize() | Matrix4 | Returnerar en kopia med rotationsaxlarna re-ortogonaliserade (skala borttagen från rotationskolumnerna) |
transpose() | Matrix4 | Returnerar den transponerade matrisen |
inverse() | Matrix4 | Returnerar inversen; kastar ValueError om matrisen är singulär |
decompose(translation, scaling, rotation) | None | Dekomponerar i TRS-komponenter. Resultaten skrivs in i enkla-elementlistor: translation[0] → Vector3, scaling[0] → Vector3, rotation[0] → Quaternion |
set_trs(translation, rotation, scale) | None | Sätter matrisen på plats från translation Vector3, rotation Quaternion eller Vector3 (Euler), och skala Vector3 |
to_array() | list[float] | Returnerar de 16 elementen som en platt lista |
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