Quaternion

Methods

Quaternion đại diện cho một quaternion đơn vị được sử dụng để mã hoá các phép quay 3D. Khác với góc Euler, quaternion tránh hiện tượng gimbal lock và nội suy một cách mượt mà. The Transform.rotation thuộc tính trên một nút cảnh lưu trữ một Quaternion.

Các thành phần được lưu trữ dưới dạng (w, x, y, z) trong đó w là phần vô hướng và (x, y, z) tạo thành phần vectơ.

from aspose.threed.utilities import Quaternion
import math

# Identity quaternion (no rotation)
q = Quaternion()   # w=1, x=0, y=0, z=0

# Rotation of 90 degrees around the Y axis
q = Quaternion.from_euler_angle(0.0, math.radians(90), 0.0)

Methods: aspose.threed.utilities

from aspose.threed.utilities import Quaternion

Methods

Methods	Methods
`Quaternion()`	Quaternion đồng nhất `(w=1, x=0, y=0, z=0)`
`Quaternion(w, x, y, z)`	Bộ khởi tạo thành phần rõ ràng

Methods

Methods	Methods	Methods
`w`	`float`	Phần vô hướng (thực)
`x`	`float`	Thành phần x của vectơ
`y`	`float`	Thành phần y của vector
`z`	`float`	Thành phần z của vector
`length`	`float`	Độ lớn của quaternion

Các phương thức Factory tĩnh

Methods	Kiểu trả về	Methods
`Quaternion.from_euler_angle(pitch, yaw, roll)`	`Quaternion`	Xây dựng từ các góc Euler tính bằng radian (pitch=X, yaw=Y, roll=Z). Cũng chấp nhận một `Vector3` là đối số đầu tiên
`Quaternion.from_angle_axis(angle, axis)`	`Quaternion`	Xây dựng từ một góc (radian) và một `Vector3` trục
`Quaternion.from_rotation(orig, dest)`	`Quaternion`	Xoay cung tròn ngắn nhất từ hướng `orig` đến hướng `dest`
`Quaternion.interpolate(t, from_q, to_q)`	`Quaternion`	Nội suy SLERP; `t` trong `[0, 1]`
`Quaternion.slerp(t, v1, v2)`	`Quaternion`	Tên thay thế cho `interpolate`

Các phương thức Instance

Methods	Kiểu trả về	Methods
`normalize()`	`Quaternion`	Trả về một bản sao có độ dài đơn vị
`conjugate()`	`Quaternion`	Trả về phần liên hợp `(w, -x, -y, -z)`
`inverse()`	`Quaternion`	Trả về nghịch đảo nhân; phát sinh `ValueError` nếu độ dài bằng không
`dot(q)`	`float`	Tích vô hướng với một quaternion khác
`concat(rhs)`	`Quaternion`	Tích Hamilton (kết hợp của hai phép quay)
`euler_angles()`	`Vector3`	Trích xuất các góc Euler (radians) dưới dạng `Vector3(roll, pitch, yaw)`
`to_matrix(translation=None)`	`Matrix4`	Chuyển đổi thành ma trận quay 4×4; tùy chọn nhúng một phép dịch `Vector3`
`to_angle_axis(angle, axis)`	`None`	Phân tách thành góc (radians) và trục; kết quả được ghi vào các danh sách một phần tử `angle[0]` và `axis[0]`

Methods

from aspose.threed import Scene
from aspose.threed.utilities import Quaternion, Vector3
import math

scene = Scene()
node = scene.root_node.create_child_node("rotated_box")

# Rotate 45 degrees around the Y axis
angle = math.radians(45)
q = Quaternion.from_euler_angle(0.0, angle, 0.0)
node.transform.rotation = q

# SLERP between two rotations
q_start = Quaternion.from_euler_angle(0, 0, 0)
q_end   = Quaternion.from_euler_angle(0, math.pi, 0)
q_mid   = Quaternion.slerp(0.5, q_start, q_end)

# Convert to matrix (useful for manual transforms)
mat = q.to_matrix()

# Extract Euler angles back
angles = q.euler_angles()   # Vector3(roll, pitch, yaw)
print(math.degrees(angles.y))   # ~45.0

Quaternion

Methods

Methods

Methods

Các phương thức Factory tĩnh

Các phương thức Instance

Methods

Xem thêm