Class Vector3

بسته: @aspose/3d (v24.12.0)

Vector3 نوع ریاضی اصلی است که در سراسر @aspose/3d API برای موقعیت‌ها، جهت‌ها، زوایای اویلر و عوامل مقیاس. از @aspose/3d/utilities مسیر فرعی.

export class Vector3
import { 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

ImageRenderOptionsImageRenderOptions
new Vector3(x, y, z)از سه مؤلفه عددی ساخته می‌شود.
new Vector3(v)تمام سه مؤلفه را با مقدار اسکالر یکسان پر می‌کند.

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
xnumberمؤلفه X. قابل خواندن و نوشتن.
ynumberمؤلفه Y. قابل خواندن و نوشتن.
znumberمولفه Z. قابل خواندن و نوشتن.
lengthnumber (فقط-خواندنی)طول اقلیدسی: sqrt(x² + y² + z²).
length2number (فقط-خواندنی)طول مربعی: x² + y² + z². ارزان‌تر از length وقتی فقط مقیاس‌ها را مقایسه می‌کنیم.
zeroVector3 (فقط-خواندنی)یک مقدار جدید برمی‌گرداند Vector3(0, 0, 0).
oneVector3 (فقط-خواندنی)یک مقدار جدید برمی‌گرداند Vector3(1, 1, 1).
unitXVector3 (فقط‑خواندنی)یک مقدار جدید برمی‌گرداند Vector3(1, 0, 0).
unitYVector3 (فقط‑خواندنی)یک مقدار جدید برمی‌گرداند Vector3(0, 1, 0).
unitZVector3 (فقط‑خواندنی)یک مقدار جدید برمی‌گرداند Vector3(0, 0, 1).

ImageRenderOptions

set(x, y, z)

بردار را در محل تغییر می‌دهد و هر سه مؤلفه را تنظیم می‌کند.

set(newX: number, newY: number, newZ: number): void

dot(rhs)

حاصل‌ضرب نقطه‌ای اسکالر این بردار و rhs.

dot(rhs: Vector3): number

ImageRenderOptions

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): Vector3

ImageRenderOptions

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(): Vector3

minus(v)

یک مقدار جدید را برمی‌گرداند Vector3 مساوی با this - v.

minus(v: Vector3): Vector3

times(scalar)

یک مقدار جدید را برمی‌گرداند Vector3 مساوی با this * scalar.

times(scalar: number): Vector3

angleBetween(dir, up?)

زاویه را به رادیان بین این بردار و dir. اگر up در صورت ارائه، زاویه در صفحه‌ای که بر … عمود است محاسبه می‌شود up (زاویه‌ی علامت‌دار در آن صفحه).

angleBetween(dir: Vector3, up?: Vector3): number

sin()

یک مقدار جدید برمی‌گرداند Vector3 با Math.sin به‌صورت مؤلفه‌به‌مؤلفه اعمال می‌شود.

sin(): Vector3

cos()

یک مقدار جدید برمی‌گرداند Vector3 با Math.cos به‌صورت مؤلفه‌به‌مؤلفه اعمال می‌شود.

cos(): Vector3

equals(other)

ImageRenderOptions true اگر هر سه مؤلفه به‌طور دقیق برابر باشند.

equals(other: Vector3): boolean

compareTo(other)

ImageRenderOptions -1, 0, یا 1 با استفاده از ترتیب لغت‌نامه‌ای بر (x, y, z).

compareTo(other: Vector3): number

static parse(input)

یک رشتهٔ سه عددی که با فاصله جدا شده‌اند را به یک Vector3. اگر قالب نامعتبر باشد، استثنا می‌اندازد.

static parse(input: string): Vector3

ImageRenderOptions

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
 فارسی