Vector3 — Aspose.3D FOSS for Python API Reference
Vector3 是一个双精度的三分量向量，具有 x, y,，以及 z 分量。它在整个 Aspose.3D 中用于位置、方向、法线和缩放值。所有算术运算都会返回新的 Vector3 实例；原始实例不会被修改。.
from aspose.threed.utilities import Vector3
# Construct from components
v = Vector3(1.0, 2.0, 3.0)
# Copy constructor
v2 = Vector3(v)
# Default (zero vector)
zero = Vector3()Vector3() | 构造零向量 (0, 0, 0) |
Vector3(x, y, z) | 从三个构造 float 分量 |
Vector3(other) | 拷贝构造函数 — 接受另一个 Vector3 |
所有分量都是可读写的属性；访问时无需加括号。.
x | float | X 分量 |
y | float | Y 分量 |
z | float | Z 分量 |
length | float | 欧几里得长度 (sqrt(x²+y²+z²)），只读 |
length2 | float | 平方长度（x²+y²+z²），只读；比 length 仅在需要比较时 |
zero | Vector3 | Vector3(0, 0, 0) |
one | Vector3 | Vector3(1, 1, 1) |
unit_x | Vector3 | Vector3(1, 0, 0) |
unit_y | Vector3 | Vector3(0, 1, 0) |
unit_z | Vector3 | Vector3(0, 0, 1) |
| 返回类型 | ||
|---|---|---|
set(x, y, z) | None | 原地设置所有三个分量 |
dot(rhs) | float | 与另一个的点积 Vector3 |
cross(rhs) | Vector3 | 叉积 — 返回一个垂直于两个操作数的向量 |
normalize() | Vector3 | 返回一个单位长度的副本；如果长度为零则返回零向量 |
angle_between(dir) | float | 此向量与 dir |
angle_between(dir, up) | float | 投影到由…定义的平面上的有符号弧度角 up |
sin() | Vector3 | 分量级正弦 |
cos() | Vector3 | 分量级余弦 |
compare_to(other) | int | 词典序比较：返回 −1、0 或 1 |
Vector3.parse(s) | Vector3 | 静态。解析 "x y z" 字符串表示 |
索引访问
可以通过整数索引访问组件：: v[0] → x, v[1] → y, v[2] → z.
from aspose.threed.utilities import Vector3
# Basic arithmetic (standard Python operators are supported)
a = Vector3(1.0, 0.0, 0.0)
b = Vector3(0.0, 1.0, 0.0)
# Dot and cross products
dot = a.dot(b) # 0.0
perp = a.cross(b) # Vector3(0, 0, 1)
# Normalize
direction = Vector3(3.0, 4.0, 0.0)
unit = direction.normalize() # Vector3(0.6, 0.8, 0.0)
print(unit.length) # 1.0
# Angle between vectors
import math
angle = a.angle_between(b)
print(math.degrees(angle)) # 90.0
# Use with a scene node 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)