Operation Manual

Vektormathematische Funktionen sind globale Methoden zum Ausführen von Operationen an Arrays, die als mathematische Vektoren behandelt
werden. Im Gegensatz zu den integrierten JavaScript-Methoden wie Math.sin werden diese Methoden ohne das Präfix Math verwendet. Sofern
keine anderen Festlegungen getroffen wurden, geben vektormathematische Methoden einen Wert mit der Dimension des größten
Eingabearrayobjekts zurück und füllen die fehlenden Elemente mit Nullen auf. Die Expression add([10, 20], [1, 2, 3]) gibt z. B. [11, 22, 3] zurück.
JJ Giffords Website enthält Erläuterungen und Beispiele zur Verwendung einfacher Geometrie und Trigonometrie mit Expressions.
Chris und Trish Meyer stellen auf ihrer ProVideo Coalition-Website zusätzliche Informationen über Vektorberechnungsmethoden und Arrays zur
Verfügung.
add(vec1, vec2) Rückgabetyp: Array.
Argumenttyp: vec1 und vec2 sind Arrays.
Addiert zwei Vektoren.
sub(vec1, vec2) Rückgabetyp: Array.
Argumenttyp: vec1 und vec2 sind Arrays.
Subtrahiert zwei Vektoren.
mul(vec, amount) Rückgabetyp: Array.
Argumenttyp: vec ist ein Array, amount ist eine Number (Zahl).
Multipliziert jedes Element des Vektors mit dem Betrag.
div(vec, amount) Rückgabetyp: Array.
Argumenttyp: vec ist ein Array, amount ist eine Number (Zahl).
Dividiert jedes Element des Vektors durch den Betrag.
clamp(value, limit1, limit2) Rückgabetyp: Number (Zahl) oder Array.
Argumenttyp: value, limit1 und limit2 sind Numbers (Zahlen) oder Arrays.
Der Wert jeder Komponente von value ist auf den Bereich zwischen den entsprechenden Werten limit1 und limit2 beschränkt.
Chris und Trish Meyer stellen in einem Artikel auf ihrer ProVideo Coalition-Website zusätzliche Informationen über die clamp-Methode zur
Verfügung.
dot(vec1, vec2) Rückgabetyp: Number (Zahl).
Argumenttyp: vec1 und vec2 sind Arrays.
Gibt das Punktprodukt (innere Punkte) der Vektorargumente zurück.
cross(vec1, vec2) Rückgabetyp: Array [2 oder 3].
Argumenttyp: vec1 und vec2 sind Arrays [2 oder 3].
Gibt das Vektorkreuzprodukt von vec1 und vec2 zurück. Weitere Informationen finden Sie in Mathematik- bzw. JavaScript-Referenzhandbüchern.
normalize(vec) Rückgabetyp: Array.
Argumenttyp: vec ist ein Array.
Normalisiert den Vektor, sodass die Länge 1,0 beträgt. Mit der normalize-Methode können Sie den Vorgangdiv(vec, length(vec)) abkürzen.
length(vec) Rückgabetyp: Number (Zahl).
Argumenttyp: vec ist ein Array.
Gibt die Länge des Vektors vec zurück.
length(point1, point2) Rückgabetyp: Number (Zahl).
Argumenttyp: point1 und point2 sind Arrays.
Gibt die Distanz zwischen zwei Punkten zurück. Das Argument point2 ist optional. So ist z. B. length(point1, point2) identisch mit length(sub(point1,
point2)).
Beispiel: Fügen Sie der Eigenschaft „Fokusentfernung“ einer Kamera folgende Expression hinzu, um die Fokalebene mit dem Zielpunkt der
Kamera zu verknüpfen, damit der Zielpunkt im Fokus bleibt:
length(position, pointOfInterest)
lookAt(fromPoint, atPoint) Rückgabetyp: Array [3].
Die Argumenttypen fromPoint und atPoint sind Arrays [3].
Das Argument fromPoint ist der Standort der auszurichtenden Ebene im Welt-Raum. Das Argument atPoint ist der Punkt im Welt-Raum, auf den
die Ebene gerichtet werden soll. Der Rückgabewert kann als Expression für die Eigenschaft „Ausrichtung“ verwendet werden, wobei die z-Achse
der Ebene auf atPoint gerichtet ist. Diese Methode eignet sich besonders für die Ausrichtung von Kameras und Lichtern. Wenn Sie diese
Expression für eine Kamera verwenden, deaktivieren Sie die Option „Automatische Ausrichtung“. Beispielsweise sorgt diese Expression für die
Eigenschaft „Ausrichtung“ eines Spotlichts dafür, dass die Lichtquelle auf den Ankerpunkt der Ebene 1 in derselben Komposition gerichtet wird:
lookAt(position, thisComp.layer(1).position)
654