Matrix4 — Aspose.3D FOSS for Python API Reference
Example
Matrix4 on 4×4 kaksinkertaisen tarkkuuden matriisi, joka on tallennettu rivijärjestyksessä 16 elementillä (m00–m33). Sitä käytetään maailman/paikallisten muunnosten laskentaan, mukautettuihin projisointeihin ja solmun muunnosten jakamiseen siirroksiin, kiertoihin ja skaalauksiin.
Example: aspose.threed.utilities
from aspose.threed.utilities import Matrix4Example
| Example | Example |
|---|---|
Matrix4() | Identiteettimatriisi |
Matrix4(m00, m01, ..., m33) | Eksplisiittinen 16-elementtinen konstruktori (rivijärjestys) |
Matrix4(values) | Rakentaa listasta, jossa on 16 float arvoa |
Elementtien ominaisuudet
Alkioilla on nimet mRC missä R on rivi (0–3) ja C on sarake (0–3). Esimerkiksi, m03 on rivi 0, sarake 3 (X‑siirto, kun matriisi koodaa muunnoksen). Kaikki 16 ominaisuutta (m00 – m33) ovat luettavissa ja kirjoitettavissa.
Matriisia voidaan myös käyttää tasaisella indeksillä: mat[0]–mat[15].
Lasketut ominaisuudet
| Example | Example | Example |
|---|---|---|
determinant | float | Matriisin skalaarinen determinantti |
LoadOptions
| Example | Paluuarvon tyyppi | Example |
|---|---|---|
Matrix4.get_identity() | Matrix4 | Palauttaa identiteettimatriisin |
Matrix4.translate(tx, ty, tz) | Matrix4 | Siirtomatriisi; myös hyväksyy Vector3 tai yhden skalaarin yhtenäiseen siirtoon |
Matrix4.scale(sx, sy, sz) | Matrix4 | Skaalausmatriisi; myös hyväksyy Vector3 tai yksi skalaarinen arvo tasaisen skaalausta varten |
Matrix4.rotate(angle, axis) | Matrix4 | Kiertomatriisi kulmasta (radiaanit) ja Vector3 akseli; hyväksyy myös Quaternion ainoana argumenttina |
Matrix4.rotate_from_euler(rx, ry, rz) | Matrix4 | Kiertomatriisi Eulerin kulmista (radiaanit); hyväksyy myös Vector3 |
Lisäominaisuus (IOConfig-luokan lisäksi):
| Example | Paluuarvon tyyppi | Example |
|---|---|---|
concatenate(m2) | Matrix4 | Palauttaa matriisitulo self × m2 |
normalize() | Matrix4 | Palauttaa kopion, jossa kiertosuunat on ortonormoitettu uudelleen (skaala poistettu kiertosarakkeista) |
transpose() | Matrix4 | Palauttaa transponoitu matriisi |
inverse() | Matrix4 | Palauttaa käänteismatriisin; nostaa ValueError jos matriisi on singulaarinen |
decompose(translation, scaling, rotation) | None | Hajottaa TRS-komponentteihin. Tulokset kirjoitetaan yksielementtisiin listoihin: translation[0] → Vector3, scaling[0] → Vector3, rotation[0] → Quaternion |
set_trs(translation, rotation, scale) | None | Asettaa matriisin paikallisesti käännöksestä Vector3, kierto Quaternion tai Vector3 (Euler), ja skaala Vector3 |
to_array() | list[float] | Palauttaa 16 elementtiä tasaisena listana |
Example
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