Quaternion

Methods

Quaternion เป็นควอเทอร์เนียนหน่วยที่ใช้ในการเข้ารหัสการหมุน 3 มิติ ต่างจากมุมออยเลอร์ ควอเทอร์เนียนจะหลีกเลี่ยงการล็อกแกมบอลและทำการอินเทอร์โพเลตอย่างราบรื่น. The Transform.rotation คุณสมบัติบนโหนดซีนเก็บค่า Quaternion.

ส่วนประกอบจะถูกจัดเก็บเป็น (w, x, y, z) โดยที่ w เป็นส่วนสเกลาร์และ (x, y, z) เป็นส่วนเวกเตอร์.

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()`	ควอเทอร์เนียนเอกลักษณ์ `(w=1, x=0, y=0, z=0)`
`Quaternion(w, x, y, z)`	คอนสตรัคเตอร์ส่วนประกอบแบบชัดเจน

Methods

Methods	Methods	Methods
`w`	`float`	ส่วนสเกลาร์ (จริง)
`x`	`float`	ส่วนประกอบ x ของเวกเตอร์
`y`	`float`	ส่วนประกอบ y ของเวกเตอร์
`z`	`float`	ส่วนประกอบ z ของเวกเตอร์
`length`	`float`	ขนาดของควอเทอร์เนียน

เมธอดแฟกทอรีแบบสแตติก

Methods	ประเภทการคืนค่า	Methods
`Quaternion.from_euler_angle(pitch, yaw, roll)`	`Quaternion`	สร้างจากมุมออยเลอร์ในเรเดียน (pitch=X, yaw=Y, roll=Z) นอกจากนี้ยังรับค่า `Vector3` เป็นอาร์กิวเมนต์แรก
`Quaternion.from_angle_axis(angle, axis)`	`Quaternion`	สร้างจากมุม (เรเดียน) และ `Vector3` แกน
`Quaternion.from_rotation(orig, dest)`	`Quaternion`	การหมุนตามเส้นโค้งสั้นที่สุดจากทิศทาง `orig` ไปยังทิศทาง `dest`
`Quaternion.interpolate(t, from_q, to_q)`	`Quaternion`	การแทรกค่า SLERP; `t` ใน `[0, 1]`
`Quaternion.slerp(t, v1, v2)`	`Quaternion`	นามแฝงของ `interpolate`

เมธอดอินสแตนซ์

Methods	ประเภทค่าที่คืน	Methods
`normalize()`	`Quaternion`	คืนสำเนาที่มีความยาวเป็นหน่วย
`conjugate()`	`Quaternion`	คืนค่าคอนจูเกต `(w, -x, -y, -z)`
`inverse()`	`Quaternion`	คืนค่าตัวผกผันเชิงคูณ; ยก `ValueError` หากความยาวเป็นศูนย์
`dot(q)`	`float`	ผลคูณจุดกับควอเทอร์เนียนอื่น
`concat(rhs)`	`Quaternion`	ผลคูณแฮมิลตัน (การประกอบการหมุนสองครั้ง)
`euler_angles()`	`Vector3`	สกัดเอาองศาออยเลอร์ (เรเดียน) เป็น `Vector3(roll, pitch, yaw)`
`to_matrix(translation=None)`	`Matrix4`	แปลงเป็นเมทริกซ์การหมุน 4×4; สามารถฝังการแปลได้ตามต้องการ `Vector3`
`to_angle_axis(angle, axis)`	`None`	แยกเป็นมุม (เรเดียน) และแกน; ผลลัพธ์เขียนลงในรายการที่มีเพียงหนึ่งองค์ประกอบ `angle[0]` และ `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

เมธอดแฟกทอรีแบบสแตติก

เมธอดอินสแตนซ์

Methods

ดูเพิ่มเติม