JsgVect2 Klasse

Ein 2D-Vektor wird als Array der Grösse 2 dargestellt. Auf die einzelnen Komponenten des Vektors kann über ihren Index zugegriffen werden: x-Komponente = v[0] usw.

Anstelle der Funktionen wie JsgVect2.New() zum Erzeugen von JsgVect2 Objekten kann auch direkt ein Array [ x, y ] verwendet werden.

JsgVect2 Objekte können mit JsgMat2 und JsgMat2 Matrizen transformiert werden.

JsgVect2 Funktionen

JsgVect2.New()

global JsgVect2.New( x, y )

x, y: Number

Komponenten des Vektors

Return: JsgVect2

Erzeugt ein JsgVect2 Objekt mit den angegeben Koordinaten. Ein JsgVect2 Objekt kann auch einfach als Array erzeugt werden:

var v = [ x, y ];  // = JsgVect2.New( x, y );

JsgVect2.Set()

global JsgVect2.Set( v, x, y )
global JsgVect2.Set( v, src )

v: JsgVect2

zu ändernder Vektor

x, y: Number

neue Koordinaten

src: JsgVect2

zu kopierender Vektor

Return v: JsgVect2

Ändert die Koordinaten des Vektors v zu x/y beziehungsweise src.

JsgVect2.Copy()

global JsgVect2.Copy( src )

src: JsgVect2

zu kopierender Vektor

Return: JsgVect2

Erzeugt einen neuen Vektor aus den Komponenten des src Vektors.

JsgVect2.CopyTo()

global JsgVect2.CopyTo( src, dest )

src: JsgVect2

zu kopierender Vektor

dest: JsgVect2

Ziel-Vektor

Return dest: JsgVect2

Kopiert die Koordinaten des Vektors src in die Koordinates des Vektors dest. Vergleiche auch mit der Funktion JsgVect2.Set().

JsgVect2.Null()

global JsgVect2.Null( )

Return: JsgVect2

Erzeugt einen JsgVect2 Objekt mit allen Koordinaten = 0, also einen Null-Vektor.

JsgVect2.Ok()

global JsgVect2.Ok( Any )

Any: -

Irgend ein Objekt oder undefiniert

Return: Boolean

true, wenn Any ein Array ist

Diese Funktion kann dazu verwendet werden, um zu prüfen, ob eine Variable oder ein Funktions-Parameter definiert ist und allenfalls vom Typ JsgVect2 ist. Letzteres wird aus Performacegründen nicht komplett getestet. So wird nur geschaut, ob es sich um einen beliebigen Array handelt.

Die Funktion Ok ist wiefolgt implementiert:

function JsgVect2.Ok( Any ) {
  return xArray(Any);
}

JsgVect2.Scale()

global JsgVect2.Scale( Vect, s )

Vect: JsgVect2

Ursprungs-Vektor

s: Number

Skalierungsfaktor

Return: JsgVect2

neuer skalierter Vektor

Gibt einen neuen Vektor zurück, der aus Vect gebildet wird, indem seine Komponenten mit s multipliziert werden.

JsgVect2.Add()

global JsgVect2.Add( VectA, VectB )

VectA, VectB: JsgVect2

Return: JsgVect2

Führt eine Vektor-Addition mit den beiden Vektoren VectA und VectB aus und gibt als Resultat einen neuen Vektor vom Type JsgVect2 zurück.

JsgVect2.Sub()

global JsgVect2.Sub( VectA, VectB )

VectA, VectB: JsgVect2

Return: JsgVect2

Führt eine Vektor-Subtraktion VectA minus VectB aus und gibt als Resultat einen neuen Vektor vom Typ JsgVect2 zurück.

JsgVect2.Length2()

global JsgVect2.Length2( Vect )

Vect: JsgVect2

Return: Number(>=0)

Gibt das Quadrat der Länge des Vektors Vect zurück.

JsgVect2.Length()

global JsgVect2.Length( Vect )

Vect: JsgVect2

Return: Number(>=0)

Gibt die Länge des Vektors Vect zurück.

JsgVect2.Norm()

global JsgVect2.Norm( Vect )

Vect: JsgVect2

Return: JsgVect2

Erzeugt aus Vect einen neuen Vektor, der die selbe Richtung aber die Länge 1 hat. Wenn Vect der Null-Vektor ist (seine Länge ist 0), so wird ein neuer Null-Vektor zurückgegeben.

JsgVect2.ScalarProd()

global JsgVect2.ScalarProd( VectA, VectB )

VectA, VectB: JsgVect2

Return: Number

Gibt das Skalarproduk der beiden Vektoren VectA und VectB zurück.

JsgVect2.VectProd()

global JsgVect2.VectProd( VectA, VectB )

VectA, VectB: JsgVect2

Return: Number

Gibt den Betrag des Vektorproduktes der beiden Vektoren VectA und VectB zurück.

Der Betrag des Vektorproduktes berechnet sich nach der Formel:

s = VectA[0] * VectB[1] - VectA[1] * VectB[0]

Dies entspricht dem Skalarprodukt des Vektors VectA mit dem um 90 Grad im Gegenuhrzeigersinn gedrehten Vektors VectB.

JsgVect2.Rotate()

global JsgVect2.Rotate( Vect, Angle )

Vect: JsgVect2

Angle: Number

Return: JsgVect2

Kopiert den Vektor Vect und rotiert die Kopie um den Winkel Angle. Die rotierte Kopie wird zurückgegeben. Angle muss in Radian angegeben werden. Positive Werte rotieren gegen den Uhrzeigersinn.

JsgVect2.Angle()

global JsgVect2.Angle( VectA, VectB )

VectA, VectB: JsgVect2

Return: Number

Gibt den Winkel zwischen den zwei Vektoren VectA und VectB in Radian zurück. Die beiden Vektoren müssen Normiert sein, siehe JsgVect2.Norm(). Der Winkel wird vom Vektor VectA aus zum Vektor VectB gemessen. Positive Werte bedeuten eine Rotation im Gegenuhrzeigersinn. Der berechnete Winkel hat einen Wertebereich von −π < ω ≤ π.