Matrix4
Methods
Matrix4 є 4×4 матрицею подвійної точності, що зберігається у порядку рядків з 16 елементами («<SEG_2»>).m00–m33Використовується для обчислень світових/локальних перетворень, користувацьких проекцій та розкладання перетворень вузлів на переміщення, обертання та масштаб.
Methods: aspose.threed.utilities
from aspose.threed.utilities import Matrix4Methods
| Methods | Methods |
|---|---|
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].
Обчислені властивості
| Methods | Methods | Methods |
|---|---|---|
determinant | float | Скалярний детермінант матриці |
Статичні фабричні методи
| Methods | Тип повернення | Methods |
|---|---|---|
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 |
Методи екземпляра
| Methods | Тип повернення | Methods |
|---|---|---|
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 елементів у вигляді плоского списку |
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