Aspose.3D FOSS
Python
Transform

Transform

Methods: aspose.threed (aspose-3d-foss)

Transform 控制 a 的位置、方向和缩放 Node 在 3D 场景中。每个节点恰好有一个 Transform,，通过 node.transform.

class Transform(A3DObject):

访问节点的 Transform 

from aspose.threed import Scene

scene = Scene()
node = scene.root_node.create_child_node("box")
t = node.transform     # Transform object

Methods

MethodsMethodsMethods
translationVector3位置偏移相对于父节点的原点。默认 Vector3(0, 0, 0).
scalingVector3每个轴的非均匀缩放因子。默认 Vector3(1, 1, 1).
rotationQuaternion以单位四元数表示的旋转。设置此项也会更新 euler_angles.
euler_anglesVector3以 (X, Y, Z) 欧拉角（度）表示的旋转。设置此项也会更新 rotation.
pre_rotationVector3在主旋转之前应用的欧拉角（用于 FBX 骨架）。.
post_rotationVector3在主旋转之后应用的欧拉角。.
geometric_translationVector3仅本地平移：影响几何体，但不影响子节点。.
geometric_scalingVector3仅本地缩放：影响几何体，但不影响子节点。.
geometric_rotationVector3仅本地旋转：影响几何体，但不影响子节点。.
transform_matrixMatrix4完整的 4×4 组合变换矩阵。已缓存；当任意组件变化时重新计算。对其进行设置时会分解回平移/缩放/旋转。.

流式设置方法

所有 setter 返回 self, 启用链式调用：:

MethodsMethodsMethods
set_translation(tx, ty, tz)float, float, float设置位置。.
set_scale(sx, sy, sz)float, float, float设置缩放。.
set_euler_angles(rx, ry, rz)float, float, float设置旋转（单位：度）。.
set_rotation(rw, rx, ry, rz)float, float, float, float将旋转设置为四元数 (w, x, y, z)。.
set_pre_rotation(rx, ry, rz)float, float, float设置预旋转角度（单位：度）。.
set_post_rotation(rx, ry, rz)float, float, float设置后旋转角度（单位：度）。.
set_geometric_translation(x, y, z)float, float, float设置几何平移。.
set_geometric_scaling(sx, sy, sz)float, float, float设置几何缩放。.
set_geometric_rotation(rx, ry, rz)float, float, float设置几何旋转角度（单位：度）。.

使用示例

设置节点位置 

from aspose.threed import Scene

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

# Using fluent setters
node.transform.set_translation(5.0, 0.0, -3.0)

# Or via property assignment
from aspose.threed.utilities import Vector3
node.transform.translation = Vector3(5.0, 0.0, -3.0)

使用欧拉角旋转 

from aspose.threed import Scene

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

# Rotate 45° around Y axis
node.transform.set_euler_angles(0.0, 45.0, 0.0)

# Chain multiple operations
node.transform.set_translation(2.0, 0.0, 0.0).set_scale(2.0, 2.0, 2.0)

使用四元数旋转 

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

scene = Scene()
node = scene.root_node.create_child_node("q-rotated")

# 90° rotation around the Y axis
half_angle = math.radians(45)   # half the total rotation
q = Quaternion(math.cos(half_angle), 0.0, math.sin(half_angle), 0.0)
node.transform.rotation = q

print(f"Euler: {node.transform.euler_angles}")   # synced automatically

同时缩放和定位 

from aspose.threed import Scene

scene = Scene()
node = scene.root_node.create_child_node("big-offset")

(node.transform
    .set_translation(10.0, 0.0, 0.0)
    .set_scale(3.0, 3.0, 3.0)
    .set_euler_angles(0.0, 90.0, 0.0))

几何偏移（枢轴偏移）

几何变换会相对于节点的枢轴移动几何体，而不影响子节点；这对于在节点内部居中网格非常有用：:

from aspose.threed import Scene

scene = Scene()
node = scene.root_node.create_child_node("centered-mesh")

# Shift the mesh half a unit down so its base sits at y=0
node.transform.set_geometric_translation(0.0, -0.5, 0.0)

读取组合变换矩阵 

from aspose.threed import Scene

scene = Scene()
node = scene.root_node.create_child_node("m")
node.transform.set_translation(1.0, 2.0, 3.0).set_euler_angles(0.0, 45.0, 0.0)

m = node.transform.transform_matrix
print(type(m))  # <class 'aspose.threed.utilities.Matrix4'>

另请参阅

 中文