Class Vector3
חבילה: @aspose/3d (v24.12.0)
Vector3 הוא סוג המתמטיקה הראשי המשמש לאורך כל ה @aspose/3d ה-API למיקומים, כיוונים, זוויות אוילר וגורמי קנה מידה. הוא מיוצא מ- @aspose/3d/utilities תת‑נתיב.
export class Vector3import { Vector3 } from '@aspose/3d/utilities';
// or via the main entry point when used with Transform/GlobalTransform
import { Scene } from '@aspose/3d';ImageRenderOptions
חשב את נקודת האמצע בין שני מיקומים ונרמל וקטור כיוון.
import { Vector3 } from '@aspose/3d/utilities';
const a = new Vector3(1, 0, 0);
const b = new Vector3(0, 0, 4);
// Midpoint: average the components manually
const mid = new Vector3(
(a.x + b.x) * 0.5,
(a.y + b.y) * 0.5,
(a.z + b.z) * 0.5
);
console.log(`Midpoint: ${mid}`);
// Midpoint: Vector3(0.5, 0, 2)
// Normalized direction from a to b
const dir = b.minus(a).normalize();
console.log(`Direction: ${dir}`);
// Direction: Vector3(-0.2425..., 0, 0.9701...)
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
new Vector3(x, y, z) | בנה משלושה רכיבים מספריים. |
new Vector3(v) | מלא את כל שלושת הרכיבים בערך סקלרי זהה. |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
x | number | הרכיב X. ניתן לקריאה ולכתיבה. |
y | number | הרכיב Y. ניתן לקריאה ולכתיבה. |
z | number | הרכיב Z. ניתן לקריאה ולכתיבה. |
length | number (קריאה בלבד) | אורך אוקלידי: sqrt(x² + y² + z²). |
length2 | number (קריאה בלבד) | אורך מרובע: x² + y² + z². זול יותר מ- length כאשר משווים רק גדלים. |
zero | Vector3 (קריאה בלבד) | מחזיר חדש Vector3(0, 0, 0). |
one | Vector3 (קריאה בלבד) | מחזיר חדש Vector3(1, 1, 1). |
unitX | Vector3 (קריאה בלבד) | מחזיר חדש Vector3(1, 0, 0). |
unitY | Vector3 (קריאה בלבד) | מחזיר חדש Vector3(0, 1, 0). |
unitZ | Vector3 (קריאה בלבד) | מחזיר חדש Vector3(0, 0, 1). |
ImageRenderOptions
set(x, y, z)
משנה את הווקטור במקום, ומגדיר את כל שלושת הרכיבים.
set(newX: number, newY: number, newZ: number): voiddot(rhs)
מחזיר את מכפלת הנקודה הסקלרית של וקטור זה ו rhs.
dot(rhs: Vector3): numberImageRenderOptions
import { Vector3 } from '@aspose/3d/utilities';
const up = new Vector3(0, 1, 0);
const dir = new Vector3(0.5, 0.5, 0).normalize();
const alignment = up.dot(dir);
console.log(`Dot: ${alignment.toFixed(4)}`); // Dot: 0.7071
cross(rhs)
מחזיר חדש Vector3 שהוא מכפלת הצטלבות של וקטור זה ו rhs.
cross(rhs: Vector3): Vector3ImageRenderOptions
import { Vector3 } from '@aspose/3d/utilities';
const right = new Vector3(1, 0, 0);
const up = new Vector3(0, 1, 0);
const forward = right.cross(up);
console.log(`Forward: ${forward}`);
// Forward: Vector3(0, 0, -1)
normalize()
מחזיר חדש Vector3 עם אותו כיוון אך באורך יחידה. מחזיר (0, 0, 0) אם לוקטור זה אורך אפס.
normalize(): Vector3minus(v)
מחזיר חדש Vector3 שווה ל this - v.
minus(v: Vector3): Vector3times(scalar)
מחזיר חדש Vector3 שווה ל this * scalar.
times(scalar: number): Vector3angleBetween(dir, up?)
מחזיר את הזווית ברדיאנים בין וקטור זה ל dir. אם up מסופק, הזווית מחושבת במישור המאונך ל up (זווית עם סימן במישור זה).
angleBetween(dir: Vector3, up?: Vector3): numbersin()
מחזיר ערך חדש Vector3 עם Math.sin מוחל רכיב-ברכיב.
sin(): Vector3cos()
מחזיר ערך חדש Vector3 עם Math.cos מוחל רכיב-ברכיב.
cos(): Vector3equals(other)
ImageRenderOptions true אם כל שלושת הרכיבים שווים בדיוק.
equals(other: Vector3): booleancompareTo(other)
ImageRenderOptions -1, 0, או 1 באמצעות סדר לקסיקוגרפי על (x, y, z).
compareTo(other: Vector3): numberstatic parse(input)
מפענח מחרוזת המופרדת ברווחים של שלושה מספרים ל Vector3. זורק שגיאה אם הפורמט אינו תקין.
static parse(input: string): Vector3ImageRenderOptions
import { Vector3 } from '@aspose/3d/utilities';
const v = Vector3.parse('1.5 2.0 -3.0');
console.log(`${v}`); // Vector3(1.5, 2, -3)
toString()
מחזיר מחרוזת בצורה Vector3(x, y, z).
toString(): string