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