Méthodes de calcul vectoriel

Les fonctions de calcul vectoriel sont des méthodes globales qui effectuent des opérations sur des ensembles, en les traitant comme des vecteurs mathématiques. Contrairement aux méthodes JavaScript (comme Math.sin), il est inutile d’utiliser le préfixe Math avec ces méthodes. Sauf indication contraire, les méthodes de calcul vectoriel sont modérées en ce qui concerne les dimensions et renvoient une valeur correspondant à la dimension de l’objet d’ensemble d’entrée le plus important et remplissent les éléments manquants avec des zéros. Par exemple, l’expression add([10, 20]+[1, 2, 3]) renvoie[11, 22, 3].

JJ Gifford propose des explications et des exemples démontrant comment appliquer des notions simples de géométrie et de trigonométrie aux expressions : www.adobe.com/go/learn_ae_jjgiffordexpressionsgeometrytrig_fr.

add(vec1, vec2)

Type de valeur renvoyé : Array.

Type d’argument : vec1 et vec2 sont des ensembles (Array).

Ajoute deux vecteurs.

sub(vec1, vec2)

Type de valeur renvoyé : Array.

Type d’argument : vec1 et vec2 sont des ensembles.

Soustrait deux vecteurs.

mul(vec, amount)

Type de valeur renvoyé : Array.

Type d’argument: vec est un ensemble (Array), amount est un nombre (Number).

Multiplie chaque élément du vecteur par la valeur amount.

div(vec, amount)

Type de valeur renvoyé : Array.

Type d’argument : vec est un ensemble (Array), amount est un nombre (Number).

Divise chaque élément du vecteur par la valeur amount.

clamp(value, limit1, limit2)

Type de valeur renvoyé : Number ou Array.

Type d’argument : value, limit1 et limit2 sont des nombres (Number) ou des ensembles (Array).

La valeur de chaque composant de value doit être comprise entre les valeurs correspondantes de limit1 et limit2.

dot(vec1, vec2)

Type de valeur renvoyé : Number.

Type d’argument : vec1 et vec2 sont des ensembles (Array).

Renvoie le produit (interne) des arguments vectoriels.

cross(vec1, vec2)

Type de valeur renvoyé : Array [2 ou 3].

Type d’argument : vec1 et vec2 sont des ensembles (Array) [2 ou 3].

Renvoie le produit croisé de vec1 et vec2. Pour plus de détails, reportez-vous à un manuel de mathématiques ou à un manuel JavaScript.

normalize(vec)

Type de valeur renvoyé : Array.

Type d’argument : vec est un ensemble (Array).

Normalise le vecteur afin que sa longueur soit de 1,0. L’utilisation de la méthode normalize constitue un raccourci pour exécuter l’opération div(vec, length(vec)).

length(vec)

Type de valeur renvoyé : Number.

Type d’argument : vec est un ensemble (Array).

Renvoie la longueur du vecteur vec.

length(point1, point2)

Type de valeur renvoyé : Number.

Type d’argument : point1 et point2 sont des ensembles (Array).

Renvoie la distance entre deux points. L’argument point2 est facultatif. Par exemple, length(point1, point2) est identique à length(sub(point1, point2)).

lookAt(fromPoint, atPoint)

Type de valeur renvoyé : Array [3].

Type d’argument : fromPoint et atPoint sont des ensembles (Array) [3].

L’argument fromPoint représente la position dans l’espace univers du calque à orienter. L’argument atPoint représente le point de l’espace univers vers lequel orienter le calque. La valeur renvoyée peut être utilisée comme expression pour la propriété Orientation afin de pointer l’axe z du calque sur atPoint. Cette méthode est particulièrement utile pour les caméras et les lumières. En cas d’utilisation de cette expression avec une caméra, veillez à désactiver l’orientation automatique. Par exemple, cette expression sur la propriété Orientation d’un projecteur positionne le point lumineux sur le point d’ancrage du calque numéro 1 de la même composition : lookAt(position, thisComp.layer(1).position)