Méthodes de conversion de l’espace calque

Les méthodes de conversion de l’espace calque permettent de convertir les valeurs d’un espace à un autre, par exemple de l’espace du calque à l’espace univers. Les méthodes « from » convertissent les valeurs de l’espace calque dans l’espace nommé (composition ou univers). Les méthodes « to » convertissent les valeurs de l’espace nommé (composition ou univers) dans l’espace calque. Chacune de ces méthodes utilise un argument optionnel pour déterminer l’instant auquel la transformation est calculée. Cependant, il est pratiquement toujours possible d’utiliser l’instant courant (par défaut).

Utilisez les méthodes de conversion vectorielles (« vec ») pour convertir un vecteur directionnel (différence entre deux valeurs de position, par exemple). Utilisez les méthodes non vectorielles pour convertir un point (une position, par exemple). Les espaces composition et univers sont identiques pour les calques 2D. Pour les calques 3D, l’espace composition est relatif à la caméra active, alors que l’espace univers en est indépendant.

toComp(point, t=time)

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

Type d’argument : point est un ensemble (Array) [2 ou 3] et t est un nombre (Number).

Convertit un point de l’espace calque dans l’espace composition.

fromComp(point, t=time)

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

Type d’argument : point est un ensemble (Array) [2 ou 3] et t est un nombre (Number).

Convertit un point de l’espace composition dans l’espace calque. Le point résultant dans un calque 3D peut avoir une valeur différente de zéro, même s’il se situe dans l’espace calque. Exemple : fromComp(thisComp.layer(2).position)

toWorld(point, t=time)

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

Type d’argument : point est un ensemble (Array) [2 ou 3] et t est un nombre (Number).

Convertit un point de l’espace calque dans l’espace univers (indépendant de la vue). Exemple :

  toWorld.effect("Bulge")("Bulge Center")

fromWorld(point, t=time)

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

Type d’argument : point est un ensemble (Array) [2 ou 3] et t est un nombre (Number).

Convertit un point de l’espace univers dans l’espace calque. Par exemple : fromWorld(thisComp.layer(2).position).

toCompVec(vec, t=time)

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

Type d’argument : vec est un ensemble (Array) [2 ou 3] et t est un nombre (Number).

Convertit un vecteur de l’espace calque dans l’espace composition. Par exemple : toCompVec([1, 0]).

fromCompVec(vec, t=time)

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

Type d’argument : vec est un ensemble (Array) [2 ou 3] et t est un nombre (Number).

Convertit un vecteur de l’espace composition dans l’espace calque. Par exemple (calque 2D) :

  dir=sub(position, thisComp.layer(2).position); 
  fromCompVec(dir)

toWorldVec(vec, t=time)

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

Type d’argument : vec est un ensemble (Array) [2 ou 3] et t est un nombre (Number).

Convertit un vecteur de l’espace calque dans l’espace univers. Exemple :

  p1 = effect("Eye Bulge 1")("Bulge Center");  
  p2 = effect("Eye Bulge 2")("Bulge Center");   
  toWorld(sub(p1, p2))

fromWorldVec(vec, t=time)

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

Type d’argument : vec est un ensemble (Array) [2 ou 3] et t est un nombre (Number).

Convertit un vecteur de l’espace univers dans l’espace calque. Par exemple : fromWorld(thisComp.layer(2).position).

fromCompToSurface(point, t=time)

Type de valeur renvoyé : Array [2].

Type d’argument : point est un ensemble (Array) [2 ou 3] et t est un nombre (Number).

Projette un point de l’espace composition à la surface du calque (valeur z à zéro) à l’endroit où il apparaît vu par la caméra active. Cette méthode est utile pour positionner des points de contrôle des effets. A n’utiliser qu’avec des calques 3D.