Matter.Vector

Das Matter.Vector-Modul enthält Methoden zum Erstellen und Bearbeiten von Vektoren. Vektoren sind die Grundlage aller geometriebezogenen Operationen in der Engine. Ein Matter.Vector-Objekt hat die Form { x: 0, y: 0 }.

Methoden

Matter.Vector.create(x, y) → Vector

Erstellt einen neuen Vektor.

Parameter

• x Number
• y Number

Gibt zurück

Vector: Einen neuen Vektor

Matter.Vector.add(vectorA, vectorB, [output]) → Vector

Addiert die beiden Vektoren.

Parameter

• vectorA Vector
• vectorB Vector
• [output] Vector optional

Gibt zurück

Vector: Ein neuer Vektor aus VektorA und VektorB wurde hinzugefügt

Matter.Vector.angle(vectorA, vectorB) → Number

Gibt den Winkel zwischen dem Vektor VektorB - VektorA und der x-Achse in Radiant zurück.

Parameter

• vectorA Vector
• vectorB Vector

Gibt zurück

Number: Der Winkel in Radiant

Matter.Vector.clone(vector) → Vector

Gibt einen neuen Vektor zurück, wobei x und y aus dem angegebenen Vektor kopiert wurden.

Parameter

• vector Vector

Gibt zurück

Vector: Einen neuen geklonten Vektor

Matter.Vector.cross(vectorA, vectorB) → Number

Gibt das Kreuzprodukt zweier Vektoren zurück.

Parameter

• vectorA Vector
• vectorB Vector

Gibt zurück

Number: Das Kreuzprodukt der beiden Vektoren

Matter.Vector.cross3(vectorA, vectorB, vectorC) → Number

Gibt das Kreuzprodukt dreier Vektoren zurück.

Parameter

• vectorA Vector
• vectorB Vector
• vectorC Vector

Gibt zurück:

Number: Das Kreuzprodukt der drei Vektoren

Matter.Vector.div(vector, scalar) → Vector

Dividiert einen Vektor und einen Skalar.

Parameter

• vector Vector
• scalar Number

Rückgaben

Vector: Ein neuer Vektor geteilt durch Skalar

Matter.Vector.dot(vectorA, vectorB) → Number

Gibt das Skalarprodukt zweier Vektoren zurück.

Parameter

• vectorA Vector
• vectorB Vector

Gibt zurück

Number: Das Skalarprodukt der beiden Vektoren

Matter.Vector.magnitude(vector) → Number

Gibt die Größe (Länge) eines Vektors zurück.

Parameter

• vector Vector

Gibt zurück

Number: Die Größe des Vektors

Matter.Vector.magnitudeSquared(vector) → Number

Gibt die Größe (Länge) eines Vektors zurück (und spart somit eine sqrt-Operation).

Parameter

• vector Vector

Gibt zurück

Number: Den quadrierten Betrag des Vektors

Matter.Vector.mult(vector, scalar) → Vector

Multipliziert einen Vektor und einen Skalar.

Parameter

• vector Vector
• scalar Number

Gibt zurück

Vector: Ein neuer Vektor multipliziert mit einem Skalar

Matter.Vector.neg(vector) → Vector

Negiert beide Komponenten eines Vektors, sodass er in die entgegengesetzte Richtung zeigt.

Parameter

• vector Vector

Gibt zurück

Vector: Der negierte Vektor

Matter.Vector.normalise(vector) → Vector

Normalisiert einen Vektor (so dass sein Betrag 1 ist).

Parameter

• vector Vector

Gibt zurück

Vector: Ein neuer normalisierter Vektor

Matter.Vector.perp(vector, [negate=false]) → Vector

Gibt den senkrechten Vektor zurück. Setzen Sie „negieren“ auf „true“ für die Senkrechte in die entgegengesetzte Richtung.

Parameter

• vector Vector
• [negate=false] Bool optional

Gibt zurück

Vector: Der senkrechte Vektor

Matter.Vector.rotate(vector, angle, [output]) → Vector

Dreht den Vektor um (0, 0) um den angegebenen Winkel.

Parameter

• vector Vector
• angle Number
• [output] Vector optional

Gibt zurück:

Vector: Der um (0, 0) gedrehte Vektor

Matter.Vector.rotateAbout(vector, angle, point, [output]) → Vector

Dreht den Vektor um einen angegebenen Punkt um einen angegebenen Winkel.

Parameter

• vector Vector
• angle Number
• point Vector
• [output] Vector optional

Gibt zurück:

Vector: Einen neuen Vektor, der um den Punkt gedreht ist:

Matter.Vector.sub(vectorA, vectorB, [output]) → Vector

Subtrahiert die beiden Vektoren.

Parameter

• vectorA Vector
• vectorB Vector
• [output] Vector optional

Gibt zurück

Vector: Ein neuer Vektor aus VektorA und VektorB subtrahiert

Eigenschaften/Optionen

Die folgenden Eigenschaften gelten, wenn sie unten angegeben sind, für Objekte, die von [Matter.Vector.create] erstellt wurden und können als [Optionen] an dieses übergeben werden.