Quaternion

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

Quaternion wordt overal in de @aspose/3d API om rotaties zonder gimbal lock weer te geven. Het is het type dat wordt geretourneerd door Transform.rotation en GlobalTransform.rotation. Het identiteitsquaternion (1, 0, 0, 0) vertegenwoordigt geen rotatie. Quaternion wordt geëxporteerd vanuit de @aspose/3d/utilities sub-pad.

export class Quaternion

import { Quaternion } from '@aspose/3d/utilities';

ImageRenderOptions

Roteer een knooppunt 90° rond de Y‑as en interpoleer vervolgens soepel terug naar de identiteit.

import { Scene } from '@aspose/3d';
import { Quaternion } from '@aspose/3d/utilities';

const scene = new Scene();
const node = scene.rootNode.createChildNode('spinner');

// 90° around Y
const q90 = Quaternion.fromEulerAngle(0, Math.PI / 2, 0);
node.transform.rotation = q90;

// Slerp halfway back to identity
const identity = Quaternion.IDENTITY;
const half = Quaternion.slerp(0.5, q90, identity);
console.log(`Half rotation W: ${half.w.toFixed(4)}`);
// Half rotation W: 0.9239

ImageRenderOptions

Name	Type	Access	Description
`w`	`number`	Read/Write	Gets the w.
`x`	`number`	Read/Write	Gets the x.
`y`	`number`	Read/Write	Gets the y.
`z`	`number`	Read/Write	Gets the z.
`length`	`number`	Read	Gets the length.

ImageRenderOptions

Signature	Description
`constructor()`	Initializes a quaternion with the given w, x, y, and z components
`constructor(w: number, x: number, y: number, z: number)`
`constructor(w: number, x: number, y: number, z: number)`
`IDENTITY()` → `Quaternion`	Returns the identity quaternion representing no rotation
`normalize()` → `Quaternion`	Returns a unit‑length version of this quaternion
`conjugate()` → `Quaternion`	Returns the conjugate of the quaternion
`inverse()` → `Quaternion`	Returns the multiplicative inverse of the quaternion
`dot(q: Quaternion)` → `number`	Computes the dot product with another quaternion
`concat(rhs: Quaternion)` → `Quaternion`	Returns the concatenation (multiplication) of this quaternion with another
`eulerAngles()` → `Vector3`	Returns a Vector3 of Euler angles representing the rotation
`fromEulerAngle(pitch: number, yaw: number, roll: number)` → `Quaternion`	Overload accepts a Vector3 or numeric pitch with yaw and roll
`fromEulerAngle(vec: Vector3)` → `Quaternion`
`fromEulerAngle(pitch: Vector3	number, yaw: number, roll: number) `→` Quaternion`
`fromAngleAxis(a: number, axis: Vector3)` → `Quaternion`	Creates a quaternion from a rotation angle and axis vector
`fromRotation(orig: Vector3, dest: Vector3)` → `Quaternion`	Builds a quaternion that rotates from one direction vector to another
`interpolate(t: number, fromQ: Quaternion, toQ: Quaternion)` → `Quaternion`	Linearly interpolates between two quaternions using parameter t
`slerp(t: number, v1: Quaternion, v2: Quaternion)` → `Quaternion`	Performs spherical linear interpolation between two quaternions at t
`toString()` → `string`	Returns a string representation of the quaternion components
`equals(other: Quaternion)` → `boolean`	Checks whether another quaternion has identical component values
`toMatrix()` → `Matrix4`	Converts the quaternion into a 4×4 rotation matrix

Statische eigenschappen

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`Quaternion.IDENTITY`	`Quaternion`	Retourneert een nieuwe identiteitsquaternion `(1, 0, 0, 0)`.

Statische methoden

Quaternion.fromEulerAngle(pitch, yaw, roll)

Maakt een quaternion aan vanuit Euler‑hoeken in radialen.

static fromEulerAngle(pitch: number, yaw: number, roll: number): Quaternion
static fromEulerAngle(vec: Vector3): Quaternion

ImageRenderOptions

pitch number — Rotatie rond de X-as in radialen.

yaw number — Rotatie rond de Y-as in radialen.

roll number — Rotatie rond de Z-as in radialen.

— Of geef een enkele Vector3 — waarvan x, y, z bevat pitch, yaw en roll.

ImageRenderOptions

const q = Quaternion.fromEulerAngle(0, Math.PI / 4, 0); // 45° around Y console.log(W: ${q.w.toFixed(4)}); // W: 0.9239


---

### Quaternion.fromAngleAxis(angle, axis)

Maakt een quaternion die een rotatie van `angle` radialen rond `axis`.

```typescript
static fromAngleAxis(angle: number, axis: Vector3): Quaternion

ImageRenderOptions

angle number — Rotatiehoek in radialen.

axis Vector3 — De rotatie-as. Normalisatie is niet nodig.

ImageRenderOptions

import { Quaternion, Vector3 } from '@aspose/3d/utilities';

const axis = new Vector3(0, 1, 0);
const q = Quaternion.fromAngleAxis(Math.PI / 2, axis);
console.log(`Rotating 90° around Y — W: ${q.w.toFixed(4)}`);
// Rotating 90° around Y — W: 0.7071

Quaternion.fromRotation(orig, dest)

Maakt de kortste-boog quaternion die de richtingsvector orig naar dest.

static fromRotation(orig: Vector3, dest: Vector3): Quaternion

Quaternion.slerp(t, v1, v2)

Voert sferische lineaire interpolatie uit tussen v1 en v2 bij parameter t (0.0 = v1, 1.0 = v2).

static slerp(t: number, v1: Quaternion, v2: Quaternion): Quaternion

ImageRenderOptions

const start = Quaternion.fromEulerAngle(0, 0, 0); const end = Quaternion.fromEulerAngle(0, Math.PI, 0); const mid = Quaternion.slerp(0.5, start, end); console.log(Mid W: ${mid.w.toFixed(4)}); // Mid W: 0.7071


---

### Quaternion.interpolate(t, fromQ, toQ)

Alias voor `slerp`. Voert sferische lineaire interpolatie uit.

```typescript
static interpolate(t: number, fromQ: Quaternion, toQ: Quaternion): Quaternion

Instantie‑methoden

normalize()

Retourneert een nieuwe quaternion geschaald naar een eenheidslengte.

normalize(): Quaternion

conjugate()

Retourneert de geconjugeerde (w, -x, -y, -z).

conjugate(): Quaternion

inverse()

Retourneert de inverse quaternion. Gooit een fout als de quaternion een lengte van nul heeft.

inverse(): Quaternion

dot(q)

Retourneert het scalair product met quaternion q.

dot(q: Quaternion): number

concat(rhs)

Retourneert het quaternionproduct this * rhs, die de gecombineerde rotatie weergeeft van eerst toepassen this en vervolgens rhs.

concat(rhs: Quaternion): Quaternion

eulerAngles()

Retourneert de rotatie uitgedrukt als Eulerhoeken in radialen als een Vector3(pitch, yaw, roll).

eulerAngles(): Vector3

ImageRenderOptions

const q = Quaternion.fromEulerAngle(0, Math.PI / 3, 0); const euler = q.eulerAngles(); console.log(Yaw: ${euler.y.toFixed(4)}); // Yaw: 1.0472 (= π/3)


---

### toMatrix()

Converteert dit quaternion naar een equivalente `Matrix4` rotatiematrix.

```typescript
toMatrix(): Matrix4

equals(other)

ImageRenderOptions true als alle vier componenten strikt gelijk zijn.

equals(other: Quaternion): boolean

toString()

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

toString(): string