Vector3 — Aspose.3D FOSS for Python API Reference
Vector3 je double-precision vektor s 3 komponente s x, y, i z komponente. Koristi se diljem Aspose.3D za položaje, smjerove, normale i vrijednosti skale. Sve aritmetičke operacije vraćaju nove Vector3 instance; original se ne mijenja.
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() | Kreira nulti vektor (0, 0, 0) |
Vector3(x, y, z) | Kreira iz tri float komponente |
Vector3(other) | Kopirajni konstruktor — prihvaća drugi Vector3 |
Sve komponente su svojstva koja se mogu čitati i pisati; pristupajte im bez zagrada.
x | float | X komponenta |
y | float | Y komponenta |
z | float | Z komponenta |
length | float | Euklidska duljina (sqrt(x²+y²+z²)), samo za čitanje |
length2 | float | Kvadrirana duljina (x²+y²+z²), samo za čitanje; jeftiniji od length kada je potrebna samo usporedba |
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) |
| Tip povratka | ||
|---|---|---|
set(x, y, z) | None | Postavlja sve tri komponente na mjestu |
dot(rhs) | float | Skalarni produkt s drugim Vector3 |
cross(rhs) | Vector3 | Vektorski produkt — vraća vektor okomit na oba operanda |
normalize() | Vector3 | Vraća kopiju jedinične duljine; vraća nulti vektor ako je duljina nula |
angle_between(dir) | float | Kut u radijanima između ovog vektora i dir |
angle_between(dir, up) | float | Potpisani kut u radijanima projektiran na ravninu definiranu od strane up |
sin() | Vector3 | Sinus po komponentama |
cos() | Vector3 | Kosinus po komponentama |
compare_to(other) | int | Leksikografsko uspoređivanje: vraća −1, 0 ili 1 |
Vector3.parse(s) | Vector3 | Statički. Parsira "x y z" string reprezentaciju |
Indeksni pristup
Komponente se mogu pristupiti pomoću cijelog indeksa: 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)