FVector2, FVector3, FVector4 — Aspose.3D Python API Reference
Balíček: aspose.threed.utilities (aspose-3d-foss 26.1.0)
Methods FVector typy jsou jednopřesnostní (float32) vektorové třídy používané interně poli dat vrcholových elementů. Vyměňují paměťovou efektivitu jednopřesnosti za double precision Vector2, Vector3, Vector4 třídy používané pro pozice v grafu scény. V praxi tyto hodnoty nejčastěji vytvoříte při naplňování VertexElementFVector.set_data().
from aspose.threed.utilities import FVector2, FVector3, FVector4FVector3
Dvoukomponentový jednopřesnostní float vektor s x a y komponentami.
class FVector2:
def __init__(self, x: float = 0.0, y: float = 0.0): ...Methods
| Methods | Methods | Methods | Methods |
|---|---|---|---|
x | float | čtení/zápis | První komponenta. |
y | float | čtení/zápis | Druhá komponenta. |
Methods
| Methods | Methods | Methods |
|---|---|---|
length() | float | Eukleidovská délka vektoru: sqrt(x² + y²). |
normalize() | FVector2 | Vrátí kopii jednotkové délky. Vrací FVector2(0, 0) pro nulový vektor. |
dot(other) | float | Skalární součin s other. |
FVector2.parse(s) | FVector2 | Rozparsovat řetězec oddělený mezerami "x y" do FVector2. |
Methods +, -, * (skalár), / (skalár), a == operátory.
Methods
from aspose.threed.utilities import FVector2
uv = FVector2(0.5, 0.25)
print(uv.x, uv.y) # 0.5 0.25
print(uv.length()) # ~0.559
unit = uv.normalize()
print(round(unit.length(), 6)) # 1.0
a = FVector2(1.0, 0.0)
b = FVector2(0.0, 1.0)
print(a.dot(b)) # 0.0FVector3
Trojkomponentový vektor s jednoduchou přesností typu float x, y, a z komponenty.
class FVector3:
def __init__(self, x: float = 0.0, y: float = 0.0, z: float = 0.0): ...FVector3 také přijímá Vector3, Vector4, nebo FVector4 jako svůj první argument pro konverzi z těchto typů.
Methods
| Methods | Methods | Methods | Methods |
|---|---|---|---|
x | float | čtení/zápis | První komponenta. |
y | float | čtení/zápis | Druhá komponenta. |
z | float | čtení/zápis | Třetí komponenta. |
Podporuje přístup indexem: v[0], v[1], v[2].
Statické tovární metody
| Methods | Methods | Methods |
|---|---|---|
FVector3.zero() | FVector3 | (0, 0, 0) |
FVector3.one() | FVector3 | (1, 1, 1) |
FVector3.unit_x() | FVector3 | (1, 0, 0) |
FVector3.unit_y() | FVector3 | (0, 1, 0) |
FVector3.unit_z() | FVector3 | (0, 0, 1) |
Metody instance
| Methods | Methods | Methods |
|---|---|---|
normalize() | FVector3 | Vrátí kopii jednotkové délky. Vrací nulový vektor pro vstup nulové délky. |
Methods
from aspose.threed.utilities import FVector3
n = FVector3(0.0, 1.0, 0.0)
print(n.normalize()) # FVector3(0.0, 1.0, 0.0)
up = FVector3.unit_y()
print(up.x, up.y, up.z) # 0.0 1.0 0.0
# Convert from Vector3
from aspose.threed.utilities import Vector3
v = Vector3(1.0, 2.0, 3.0)
fv = FVector3(v)
print(fv) # FVector3(1.0, 2.0, 3.0)FVector4
Čtyřkomponentový vektor s jednoduchou přesností typu float x, y, z, a w komponenty. Toto je typ úložiště používaný VertexElementFVector.data.
class FVector4:
def __init__(self, x: float = 0.0, y: float = 0.0, z: float = 0.0, w: float = 0.0): ...FVector4 také přijímá FVector3, Vector3, nebo Vector4 jako jeho první argument.
Methods
| Methods | Methods | Methods | Methods |
|---|---|---|---|
x | float | čtení/zápis | První komponenta. |
y | float | čtení/zápis | Druhá komponenta. |
z | float | čtení/zápis | Třetí komponenta. |
w | float | čtení/zápis | Čtvrtá komponenta. |
Podporuje indexový přístup: v[0] prostřednictvím v[3].
Methods
from aspose.threed.utilities import FVector4, FVector3
# Direct construction
normal = FVector4(0.0, 0.0, 1.0, 0.0)
print(normal.z) # 1.0
# From FVector3
fv3 = FVector3(0.0, 1.0, 0.0)
fv4 = FVector4(fv3, 0.0)
print(fv4) # FVector4(0.0, 1.0, 0.0, 0.0)
# Index access
print(fv4[1]) # 1.0
fv4[3] = 1.0
print(fv4.w) # 1.0Vztah k vektorům s dvojitou přesností
| Jednopřesnostní | Dvojpřesnostní | Typické použití |
|---|---|---|
FVector2 | Vector2 | UV souřadnice uložené v prvcích vrcholů |
FVector3 | Vector3 | Normály, tangenty uložené v prvcích vrcholů |
FVector4 | Vector4 | Methods VertexElementFVector.data záznamy; také převod kontrolních bodů |
Při nastavování dat vrcholových elementů můžete předat buď třídu přesnosti. set_data() převádí Vector2/Vector3 hodnoty na FVector4 automaticky.
