Matrix4
Methods
Matrix4 adalah matriks double-precision 4×4 yang disimpan dalam urutan baris dengan 16 elemen (m00–m33). Ini digunakan untuk perhitungan transformasi dunia/lokal, proyeksi khusus, dan memecah transformasi node menjadi translasi, rotasi, dan skala.
Methods: aspose.threed.utilities
from aspose.threed.utilities import Matrix4Methods
| Methods | Methods |
|---|---|
Matrix4() | Matriks identitas |
Matrix4(m00, m01, ..., m33) | Konstruktor eksplisit 16-elemen (urutan baris) |
Matrix4(values) | Membuat dari daftar 16 float nilai |
Properti Elemen
Elemen dinamai mRC di mana R adalah baris (0–3) dan C adalah kolom (0–3). Misalnya, m03 adalah baris 0, kolom 3 (translasi X ketika matriks mengkodekan transformasi). Semua 16 properti (m00 melalui m33) dapat dibaca dan ditulis.
Matriks juga dapat diakses melalui indeks datar: mat[0]–mat[15].
Properti Terhitung
| Methods | Methods | Methods |
|---|---|---|
determinant | float | Determinan skalar dari matriks |
Metode Pabrik Statis
| Methods | Tipe Pengembalian | Methods |
|---|---|---|
Matrix4.get_identity() | Matrix4 | Mengembalikan matriks identitas |
Matrix4.translate(tx, ty, tz) | Matrix4 | Matriks translasi; juga menerima sebuah Vector3 atau skalar tunggal untuk translasi seragam |
Matrix4.scale(sx, sy, sz) | Matrix4 | Matriks skala; juga menerima sebuah Vector3 atau satu skalar tunggal untuk skala seragam |
Matrix4.rotate(angle, axis) | Matrix4 | Matriks rotasi dari sudut (radian) dan Vector3 sumbu; juga menerima sebuah Quaternion sebagai satu-satunya argumen |
Matrix4.rotate_from_euler(rx, ry, rz) | Matrix4 | Matriks rotasi dari sudut Euler (radian); juga menerima sebuah Vector3 |
Metode Instansi
| Methods | Tipe Pengembalian | Methods |
|---|---|---|
concatenate(m2) | Matrix4 | Mengembalikan hasil perkalian matriks self × m2 |
normalize() | Matrix4 | Mengembalikan salinan dengan sumbu rotasi yang re-orthonormalized (skala dihapus dari kolom rotasi) |
transpose() | Matrix4 | Mengembalikan matriks yang ditransposisi |
inverse() | Matrix4 | Mengembalikan invers; memunculkan ValueError jika matriks singular |
decompose(translation, scaling, rotation) | None | Mendekomposisi menjadi komponen TRS. Hasil dituliskan ke dalam daftar satu elemen: translation[0] → Vector3, scaling[0] → Vector3, rotation[0] → Quaternion |
set_trs(translation, rotation, scale) | None | Mengatur matriks secara in-place dari translasi Vector3, rotasi Quaternion atau Vector3 (Euler), dan skala Vector3 |
to_array() | list[float] | Mengembalikan 16 elemen sebagai daftar datar |
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