Aspose.3D FOSS
Python
Matrix4

Matrix4 — Aspose.3D FOSS for Python API Reference

Example

Matrix4 е 4×4 матрица с двойна точност, съхранена в редово-основен ред с 16 елемента (m00–m33Използва се за изчисления на световни/локални трансформации, персонализирани проекции и разлагане на трансформациите на възлите на превод, въртене и мащаб.

Example: aspose.threed.utilities

from aspose.threed.utilities import Matrix4

Example

ExampleExample
Matrix4()Единична матрица
Matrix4(m00, m01, ..., m33)Явно конструктор с 16 елемента (редово-основен ред)
Matrix4(values)Конструира се от списък от 16 float стойности

Свойства на елементите

Елементите са именувани mRC където R е редът (0–3) и C е колоната (0–3). Например, m03 е ред 0, колона 3 (преводът по X, когато матрицата кодира трансформация).m00 Всички 16 свойства ( m33до.

Матрицата може също да се достъпи чрез плосък индекс: mat[0]–mat[15].

Изчислени свойства

ExampleExampleExample
determinantfloatСкаларен детерминант на матрицата

Статични фабрични методи

ExampleТип на връщаната стойностExample
Matrix4.get_identity()Matrix4Връща единична матрица
Matrix4.translate(tx, ty, tz)Matrix4Матрица за транслация; също приема Vector3 или един скалар за еднородна транслация
Matrix4.scale(sx, sy, sz)Matrix4Матрица за мащабиране; също приема Vector3 или един скалар за еднородно мащабиране
Matrix4.rotate(angle, axis)Matrix4Матрица за въртене от ъгъл (в радиани) и Vector3 ос; също приема Quaternion като единствения аргумент
Matrix4.rotate_from_euler(rx, ry, rz)Matrix4Матрица на въртене от ъгли на Ейлер (в радиани); също приема a Vector3

Създава кватернион с най-кратка дъга, който завърта вектор на посоката orig към dest.

ExampleТип на връщанеExample
concatenate(m2)Matrix4Връща произведението на матриците self × m2
normalize()Matrix4Връща копие с повторно ортонормализирани оси на въртене (скалата е премахната от колоните за въртене)
transpose()Matrix4Връща транспонираната матрица
inverse()Matrix4Връща обратната; повдига ValueError ако матрицата е сингулярна
decompose(translation, scaling, rotation)NoneРазлага на TRS компоненти. Резултатите се записват в списъци с един елемент: translation[0] → Vector3, scaling[0] → Vector3, rotation[0] → Quaternion
set_trs(translation, rotation, scale)NoneЗадава матрицата на място от транслация Vector3, ротация Quaternion или Vector3 (Euler), и мащаб Vector3
to_array()list[float]Връща 16‑те елементи като плосък списък

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

Вижте също

 Български