Matrix4
Matrix4 je 4×4 matrica dvostruke preciznosti pohranjena u redoslijedu po redovima s 16 elemenata (m00–m33). Koristi se za izračune svjetskih/lokalnih transformacija, prilagođene projekcije i razlaganje transformacija čvora na translaciju, rotaciju i skaliranje.
from aspose.threed.utilities import Matrix4| —————————– | ———————————————————— |
| Matrix4() | Jedinična matrica |
| Matrix4(m00, m01, ..., m33) | Izričiti konstruktor s 16 elemenata (redoslijed po redovima) |
| Matrix4(values) | Kreira iz popisa od 16 float vrijednosti |
Svojstva elemenata
Elementi su imenovani mRC gdje R je redak (0–3) i C je stupac (0–3). Na primjer, m03 je redak 0, stupac 3 (X translacija kada matrica kodira transformaciju). Sva 16 svojstava (m00 do m33).
Matrica se također može pristupiti putem ravnog indeksa: mat[0]–mat[15].
Izračunata svojstva
| ————————- | ————————- | —————————– |
| determinant | float | Skalarni determinanta matrice |
Statičke metode tvornice
| ————————————— | ———— | ——————————————————————————————————– |
| Matrix4.get_identity() | Matrix4 | Vraća jediničnu matricu |
| Matrix4.translate(tx, ty, tz) | Matrix4 | Matrica translacije; također prihvaća a Vector3 ili jedan skalar za jednoliku translaciju |
| Matrix4.scale(sx, sy, sz) | Matrix4 | Matrica skaliranja; također prihvaća a Vector3 ili jedan skalar za jedinstvenu skalu |
| Matrix4.rotate(angle, axis) | Matrix4 | Rotacijska matrica iz kuta (radijani) i Vector3 osi; također prihvaća Quaternion kao jedini argument |
| Matrix4.rotate_from_euler(rx, ry, rz) | Matrix4 | Rotacijska matrica iz Eulerovih kutova (radijani); također prihvaća Vector3 |
Metode instance
| ——————————————- | ————- | —————————————————————————————————————————————————————– |
| concatenate(m2) | Matrix4 | Vraća proizvod matrice self × m2 |
| normalize() | Matrix4 | Vraća kopiju s rotacijskim osima ponovno ortonormiranim (skala uklonjena iz rotacijskih stupaca) |
| transpose() | Matrix4 | Vraća transponiranu matricu |
| inverse() | Matrix4 | Vraća inverz; podiže ValueError ako je matrica singularna |
| decompose(translation, scaling, rotation) | None | Rastavlja u TRS komponente. Rezultati se upisuju u liste s jednim elementom: translation[0] → Vector3, scaling[0] → Vector3, rotation[0] → Quaternion |
| set_trs(translation, rotation, scale) | None | Postavlja matricu na mjestu iz translacije Vector3, rotacija Quaternion ili Vector3 (Euler), i skala Vector3 |
| to_array() | list[float] | Vraća 16 elemenata kao ravni popis |
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