Class Vector3

Pakket: @aspose/3d (v24.12.0)

Vector3 is het primaire wiskundige type dat door de hele @aspose/3d API wordt gebruikt voor posities, richtingen, Euler-hoeken en schaalfactoren. Het wordt geëxporteerd vanuit de @aspose/3d/utilities sub-pad.

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

Bereken het middelpunt tussen twee posities en normaliseer een richtingsvector.

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)`	Construeer uit drie numerieke componenten.
`new Vector3(v)`	Vul alle drie componenten met dezelfde scalare waarde.

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`x`	`number`	De X-component. Leesbaar en schrijfbaar.
`y`	`number`	De Y-component. Leesbaar en schrijfbaar.
`z`	`number`	De Z-component. Leesbaar en schrijfbaar.
`length`	`number` (alleen-lezen)	Euclidische lengte: `sqrt(x² + y² + z²)`.
`length2`	`number` (alleen-lezen)	Vierkante lengte: `x² + y² + z²`. Goedkoper dan `length` wanneer alleen de grootten worden vergeleken.
`zero`	`Vector3` (alleen-lezen)	Retourneert een nieuw `Vector3(0, 0, 0)`.
`one`	`Vector3` (alleen-lezen)	Retourneert een nieuwe `Vector3(1, 1, 1)`.
`unitX`	`Vector3` (alleen-lezen)	Retourneert een nieuwe `Vector3(1, 0, 0)`.
`unitY`	`Vector3` (alleen-lezen)	Retourneert een nieuwe `Vector3(0, 1, 0)`.
`unitZ`	`Vector3` (alleen-lezen)	Retourneert een nieuwe `Vector3(0, 0, 1)`.

ImageRenderOptions

set(x, y, z)

Wijzigt de vector in‑place door alle drie componenten in te stellen.

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

dot(rhs)

Retourneert het scalair product van deze vector en 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)

Retourneert een nieuwe Vector3 dat het kruisproduct is van deze vector en 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()

Retourneert een nieuwe Vector3 met dezelfde richting maar een eenheidslengte. Retourneert (0, 0, 0) als deze vector een lengte van nul heeft.

normalize(): Vector3

minus(v)

Retourneert een nieuwe Vector3 gelijk aan this - v.

minus(v: Vector3): Vector3

times(scalar)

Retourneert een nieuwe Vector3 gelijk aan this * scalar.

times(scalar: number): Vector3

angleBetween(dir, up?)

Retourneert de hoek in radialen tussen deze vector en dir. Als up is opgegeven, wordt de hoek berekend in het vlak loodrecht op up (ondertekende hoek in dat vlak).

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

sin()

Retourneert een nieuwe Vector3 met Math.sin toegepast componentgewijs.

sin(): Vector3

cos()

Retourneert een nieuwe Vector3 met Math.cos toegepast componentgewijs.

cos(): Vector3

equals(other)

ImageRenderOptions true als alle drie componenten strikt gelijk zijn.

equals(other: Vector3): boolean

compareTo(other)

ImageRenderOptions -1, 0, of 1 met lexicografische ordening op (x, y, z).

compareTo(other: Vector3): number

static parse(input)

Parseert een door witruimte gescheiden tekenreeks van drie getallen naar een Vector3. Gooit een uitzondering als het formaat ongeldig is.

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

Retourneert een string in de vorm Vector3(x, y, z).

toString(): string