JsgVect3 Klassen

Es gibt neben JsgVect3 weitere Klassen, welche aus JsgVect3 Bestandteilen bestehen:

JsgVect3 Klasse

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

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

Hinweis: ein JsgVect3 Objekt kann auch als JsgVect2 Objekt bei entsprechenden Funktionen (z.B. Line()) verwendet werden.

JsgVect3 Funktionen

Weitere Funktionen mit JsgVect3 Objekten:

JsgVect3.New()

global JsgVect3.New( x, y, z )

x, y, z: Number

Komponenten des Vektors in 3D-Weltkoordinaten

Return: JsgVect3

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

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

JsgVect3.Null()

global JsgVect3.Null( )

Return: JsgVect3

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

JsgVect3.Ok()

global JsgVect3.Ok( Object )

Object: any or undefined

Return: Boolean

Gibt true zurück, wenn Object definiert ist und vom Typ JsgVect3 ist.

Ein Objekt ist vom Typ JsgVect3, wenn Object definiert ist und ein Array mit 3 Elementen ist.

Diese Funktion ist dazu gedacht, Fälle zu unterscheiden, falls eine Funktion verschiedene Argument-Typen akzeptiert.

function myFunc( arg ) {
  if (JsgVect3.Ok(arg)) {
    // handle arg as a JsgVect3
  } else {
    // handle arg as something else
  }
}

JsgVect3.Reset()

global JsgVect3.Reset( Vect )

Vect: JsgVect3

Zu ändernder Vektor

Return: Vect

Setzt alle Komponenten von Vect auf Null.

JsgVect3.Set()

global JsgVect3.Set( Dest, x, y, z )
global JsgVect3.Set( Dest, Src )

Dest: JsgVect3

Zu ändernder Vektor

Src: JsgVect3

Zu kopierender Vektor

x, y, z: Number

Komponenten des Vektors in 3D Weltkoordinaten

Return: Dest

Setzt die Komponenten von Dest auf die Werte x, y, und z, oder kopiert die Komponenten des Vektors Src in die Komponented dest Vektors Dest. Vergleiche auch mit der Funktion JsgVect3.CopyTo().

JsgVect3.Copy()

global JsgVect3.Copy( Src )

Src: JsgVect3

Zu kopierender Vektor

Return: JsgVect3

Kopie des Vektors src

Gibt eine Kopie des Vektors Src zurück.

JsgVect3.CopyTo()

global JsgVect3.CopyTo( Src, Dest )

Src: JsgVect3

Zu kopierender Vektor

Dest: JsgVect3

Die Komponenten von src werden in diesen Vektor kopiert

Return: Dest

Kopiert den Vektors Src komponentenweise in den Vektor Dest. Dest darf nicht undefined sein und muss vom Type JsgVect3 sein. Vergleiche auch mit der Funktion JsgVect3.Set().

JsgVect3.FromAngle()

global JsgVect3.FromAngle( HAng, VAng, Dist )

HAng: Number

Horizontaler Winkel, gemessen in der XY-Ebene von der X-Achse zur Y-Achse in Grad.

VAng: Number

Vertikaler Winkel, gemessen von der XY-Ebene zur Z-Achse in Grad.

Dist: Number

Distanz vom Ursprung zur Spitze des berechneten Vektors.

Return: JsgVect3

neuer Vektor

Berechnet einen Vektor vom Type JsgVect3 der Länge aDist. Seine Richtung wird durch die beiden Winkel HAng und VAng festgelegt.

JsgVect3.Scale()

global JsgVect3.Scale( Vect, s )

Vect: JsgVect3

Ursprungs-Vektor

s: Number

Skalierungsfaktor

Return: JsgVect3

neuer skalierter Vektor

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

JsgVect3.ScaleTo()

global JsgVect3.ScaleTo( Vect, s )

vect: JsgVect3

Vektor, der skaliert werden soll

s: Number

Skalierungsfaktor

Return: Vect

Multipliziert alle Komponenten von Vect mit der Zahl s. Der Vektor Vect wird somit verändert.

JsgVect3.Length2()

global JsgVect3.Length2( Vect )

Vect: JsgVect3

Return: Number(>=0)

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

JsgVect3.Length()

global JsgVect3.Length( Vect )

Vect: JsgVect3

Return: Number(>=0)

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

JsgVect3.Norm()

global JsgVect3.Norm( Vect )

Vect: JsgVect3

Return: JsgVect3

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.

JsgVect3.NormTo()

global JsgVect3.NormTo( Vect )

Vect: JsgVect3

Zu normierender Vektor

Return: Vect

Verändert die Komponenten von Vect so, dass dessen Länge 1 wird. Ist Vect ein Null-Vektor, wird er nicht verändert.

JsgVect3.Add()

global JsgVect3.Add( VectA, VectB )

VectA, VectB: JsgVect3

Return: JsgVect3

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

JsgVect3.AddTo()

global JsgVect3.AddTo( VectA, VectB )

VectA, VectB: JsgVect3

Return: VectA

Addiert alle Komponenten des Vektors VectB zum Vektor VectA. Der Vektor VectA wird somit verändert.

JsgVect3.Sub()

global JsgVect3.Sub( VectA, VectB )

VectA, VectB: JsgVect3

Return: JsgVect3

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

JsgVect3.SubFrom()

global JsgVect3.SubFrom( VectA, VectB )

VectA, VectB: JsgVect3

Return: VectA

Subtrahiert alle Komponenten des Vektors VectB vom Vektor VectA. Der Vektor VectA wird somit verändert.

JsgVect3.ScalarProd()

global JsgVect3.ScalarProd( VectA, VectB )

VectA, VectB: JsgVect3

Return: Number

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

JsgVect3.Mult()

global JsgVect3.Mult( VectA, VectB )

VectA, VectB: JsgVect3

Return: JsgVect3

Gibt das Vektorprodukt der beiden Vektoren VectA und VectB als neuen Vektor vom Typ JsgVect3 zurück.

JsgVect3.MultTo()

global JsgVect3.MultTo( VectRet, VectA, VectB )

VectRet: JsgVect3

Vektor, dessen Komponenten geändert werden

VectA, VectB: JsgVect3

Zu multiplizierende Vektoren

Return: VectRet

Berechnet das Vektorprodukt der beiden Vektoren VectA und VectA und speichert das Resultat komponentenweise im Vektor VectRet. Der Vektor VectRet wird somit verändert.

JsgVect3.Angle()

global JsgVect3.Angle( Vect1, Vect2 )

Vect1, Vect2: JsgVect3

Vektoren

Return: number

Berechnet den Winkel zwischen den zwei Vektoren. Die Vektoren müssen nicht normiert sein, sie werden von der Funktion normiert. Der berechnete Winkel wird in Bogenmass zurück gegeben und liegt im Bereich 0 bis Pi.