Aspose.3D FOSS
TypeScript
Quaternion

Quaternion

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

Quaternion käytetään koko @aspose/3d API:ssa kuvaamaan kiertoja ilman gimbal-lukkoa. Se on tyyppi, jonka palauttavat Transform.rotation ja GlobalTransform.rotation. Identiteettikvaternion (1, 0, 0, 0) edustaa ei-kiertoa. Quaternion viedään ulos kohteesta @aspose/3d/utilities alipolku.

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

ColladaSaveOptions

Kierrä solmua 90° Y-akselin ympäri ja interpoloi sitten sujuvasti takaisin identiteettiin.

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

ColladaSaveOptions

NameTypeAccessDescription
wnumberRead/WriteGets the w.
xnumberRead/WriteGets the x.
ynumberRead/WriteGets the y.
znumberRead/WriteGets the z.
lengthnumberReadGets the length.

ColladaSaveOptions

SignatureDescription
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() → QuaternionReturns the identity quaternion representing no rotation
normalize() → QuaternionReturns a unit‑length version of this quaternion
conjugate() → QuaternionReturns the conjugate of the quaternion
inverse() → QuaternionReturns the multiplicative inverse of the quaternion
dot(q: Quaternion) → numberComputes the dot product with another quaternion
concat(rhs: Quaternion) → QuaternionReturns the concatenation (multiplication) of this quaternion with another
eulerAngles() → Vector3Returns a Vector3 of Euler angles representing the rotation
fromEulerAngle(pitch: number, yaw: number, roll: number) → QuaternionOverload accepts a Vector3 or numeric pitch with yaw and roll
fromEulerAngle(vec: Vector3) → Quaternion
`fromEulerAngle(pitch: Vector3number, yaw: number, roll: number) → Quaternion`
fromAngleAxis(a: number, axis: Vector3) → QuaternionCreates a quaternion from a rotation angle and axis vector
fromRotation(orig: Vector3, dest: Vector3) → QuaternionBuilds a quaternion that rotates from one direction vector to another
interpolate(t: number, fromQ: Quaternion, toQ: Quaternion) → QuaternionLinearly interpolates between two quaternions using parameter t
slerp(t: number, v1: Quaternion, v2: Quaternion) → QuaternionPerforms spherical linear interpolation between two quaternions at t
toString() → stringReturns a string representation of the quaternion components
equals(other: Quaternion) → booleanChecks whether another quaternion has identical component values
toMatrix() → Matrix4Converts the quaternion into a 4×4 rotation matrix

Staattiset ominaisuudet

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
Quaternion.IDENTITYQuaternionPalauttaa uuden identiteettikvantin (1, 0, 0, 0).

Staattiset metodit

Quaternion.fromEulerAngle(pitch, yaw, roll)

Luo quaternionin Euler-kulmista radiaaneina.

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

ColladaSaveOptions

pitch number — Kierto X-akselin ympäri radiaaneina.

yaw number — Kierto Y-akselin ympäri radiaaneina.

roll number — Kierto Z-akselin ympäri radiaaneina.

Vaihtoehtoisesti, anna yksi Vector3 jonka x, y, z sisältää pitchin, yawin ja rollin.

ColladaSaveOptions

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)

Luo kvaternionin, joka edustaa kiertoa `angle` radiaania ympäri `axis`.

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

ColladaSaveOptions

angle number — Kiertokulma radiaaneina.

axis Vector3 — Kiertokulman akseli. Ei tarvitse olla normalisoitu.

ColladaSaveOptions 

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)

Luo lyhimmän kaaren kvaternionin, joka kiertää suuntavektorin orig kohteeseen dest.

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

Quaternion.slerp(t, v1, v2)

Suorittaa pallomainen lineaarisen interpoloinnin välillä v1 ja v2 parametrilla t (0.0 = v1, 1.0 = v2).

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

ColladaSaveOptions

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 funktiolle `slerp`. Suorittaa pallomainen lineaarinen interpolointi.

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

Lisäominaisuus (IOConfig-luokan lisäksi):

normalize()

Palauttaa uuden kvaternionin, joka on skaalattu yksikköpituuteen.

normalize(): Quaternion

conjugate()

Palauttaa konjugatin (w, -x, -y, -z).

conjugate(): Quaternion

inverse()

Palauttaa kvaternionin käänteisen. Heittää poikkeuksen, jos kvaternionin pituus on nolla.

inverse(): Quaternion

dot(q)

Palauttaa skalaarisen pistetulon kvaternionin kanssa q.

dot(q: Quaternion): number

concat(rhs)

Palauttaa kvaternionitulon this * rhs, edustaa yhdistettyä kiertoa, jossa ensin sovelletaan this ja sitten rhs.

concat(rhs: Quaternion): Quaternion

eulerAngles()

Palauttaa kierron, joka on esitetty Eulerin kulmina radiaaneina, muodossa Vector3(pitch, yaw, roll).

eulerAngles(): Vector3

ColladaSaveOptions

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

Muuntaa tämän kvaternionin vastaavaksi `Matrix4` kiertomatriisiksi.

```typescript
toMatrix(): Matrix4

equals(other)

ColladaSaveOptions true jos kaikki neljä komponenttia ovat täsmälleen samat.

equals(other: Quaternion): boolean

toString()

Palauttaa merkkijonon muodossa Quaternion(w, x, y, z).

toString(): string
 Suomi