Vector3 — Aspose.3D FOSS for Java

Example

Vector3 является вектором двойной точности из 3 компонентов с x, y, и z компонентов. Он используется повсеместно в Aspose.3D для позиций, направлений, нормалей и значений масштаба. Все арифметические операции возвращают новые Vector3 экземпляры; оригинал не изменяется.

import com.aspose.threed.*;

// Construct from components
Vector3 v = new Vector3(1.0, 2.0, 3.0);

// Copy constructor
Vector3 v2 = new Vector3(v);

// Default (zero vector)
Vector3 zero = new Vector3();

Example

ExampleExample
Vector3()Создаёт нулевой вектор (0, 0, 0)
Vector3(double x, double y, double z)Создаёт из трёх компонентов
Vector3(Vector3 other)Конструктор копирования

Публичные поля

Vector3 использует публичные поля для доступа к компонентам (не методы getter/setter):

ExampleExampleExampleExample
xdoublev.xX‑компонент
ydoublev.yY‑компонент
zdoublev.zZ‑компонент

Вычисляемые свойства

ExampleExampleExampleExample
lengthdoublegetLength()Евклидова длина (sqrt(x^2+y^2+z^2)), только для чтения
length2doublegetLength2()Квадрат длины, только для чтения; дешевле, чем getLength() когда требуется только сравнение

Статические поля

ExampleExampleExample
ZEROVector3Vector3(0, 0, 0)
ONEVector3Vector3(1, 1, 1)
UNIT_XVector3Vector3(1, 0, 0)
UNIT_YVector3Vector3(0, 1, 0)
UNIT_ZVector3Vector3(0, 0, 1)

Example

ExampleТип возвращаемого значенияExample
set(double x, double y, double z)voidУстанавливает все три компонента на месте
dot(Vector3 rhs)doubleСкалярное произведение с другим Vector3
cross(Vector3 rhs)Vector3Векторное произведение – возвращает вектор, перпендикулярный обоим операндам
normalize()Vector3Возвращает копию единичной длины; возвращает нулевой вектор, если длина равна нулю
angleBetween(Vector3 dir)doubleУгол в радианах между этим вектором и dir
angleBetween(Vector3 dir, Vector3 up)doubleЗнаковый угол в радианах, проецируемый на плоскость, определяемую up
sin()Vector3Покомпонентный синус
cos()Vector3Покомпонентный косинус
compareTo(Vector3 other)intЛексикографическое сравнение: возвращает -1, 0 или 1
Vector3.parse(String s)Vector3Статический. Разбирает "x y z" строковое представление

Example

import com.aspose.threed.*;
import com.aspose.threed.Scene;

// Basic arithmetic
Vector3 a = new Vector3(1.0, 0.0, 0.0);
Vector3 b = new Vector3(0.0, 1.0, 0.0);

// Dot and cross products
double dot = a.dot(b);           // 0.0
Vector3 perp = a.cross(b);      // Vector3(0, 0, 1)

// Normalize
Vector3 direction = new Vector3(3.0, 4.0, 0.0);
Vector3 unit = direction.normalize();   // Vector3(0.6, 0.8, 0.0)
System.out.println(unit.getLength());    // 1.0

// Angle between vectors
double angle = a.angleBetween(b);
System.out.println(Math.toDegrees(angle));   // 90.0

// Use with a scene node transform
Scene scene = new Scene();
Node node = scene.getRootNode().createChildNode("box");
node.getTransform().setTranslation(new Vector3(10.0, 0.0, 0.0));

См. также

 Русский