- value
- Type de valeur renvoyé : Number, Array ou String.
Renvoie la valeur d’une propriété à l’instant courant.
- valueAtTime(t)
- Type de valeur renvoyé : Number ou Array.
Type d’argument : t est un nombre (Number).
Renvoie la valeur d’une propriété à l’instant indiqué, en secondes.
Par exemple, pour que la valeur de la propriété de chaque image soit choisie de manière aléatoire parmi quatre valeurs, définissez vos quatre valeurs comme des images clés à 0, 1, 2 et 3 secondes, puis appliquez l’expression suivante à la propriété :
valueAtTime(random(4))
- velocity
- Type de valeur renvoyé : Number ou Array.
Renvoie la valeur de la vitesse temporelle à l’instant courant. Pour les propriétés spatiales, comme Position, il renvoie la valeur du vecteur tangent. Le résultat est de même dimension que la propriété.
- velocityAtTime(t)
- Type de valeur renvoyé : Number ou Array.
Type d’argument : t est un nombre (Number).
Renvoie la valeur de la vitesse temporelle à l’instant indiqué.
- speed
- Type de valeur renvoyé : Number.
Renvoie une valeur de vitesse (1D et positive) égale à la vitesse à laquelle la propriété change à l’instant par défaut. Cet élément ne peut être utilisé que pour les propriétés spatiales.
- speedAtTime(t)
- Type de valeur renvoyé : Number.
Type d’argument : t est un nombre (Number).
Renvoie la valeur de la vitesse spatiale à l’instant indiqué.
- wiggle(freq, amp, octaves=1, amp_mult=.5, t=time)
- Type de valeur renvoyé : Number ou Array.
Type d’argument : freq, amp, octaves, amp_mult et t sont des nombres (Number).
Applique un tremblement aléatoire (secousses) à la valeur de la propriété.
La valeur freq est la fréquence en tremblements par seconde.
La valeur amp est l’amplitude en unités de la propriété à laquelle elle est appliquée.
La valeur octaves est le nombre d’octaves de bruit à cumuler. Cette valeur permet de contrôler le niveau de détail dans le tremblement. Choisissez une valeur supérieure à 1 (par défaut) pour inclure des fréquences plus élevées, ou inférieure pour inclure des harmoniques d’amplitude dans le tremblement.
amp_mult est la valeur par laquelle amp est multiplié pour chaque octave. Cette valeur permet de contrôler la vitesse de filtrage des harmoniques. La valeur par défaut est 0,5 ; une valeur plus proche de 1 permet d’ajouter des harmoniques de même amplitude que la fréquence de base, alors qu’une valeur plus proche de 0 permet d’ajouter moins de détails.
t représente l’instant de départ de base. Cette valeur est établie par défaut à l’instant courant. Utilisez ce paramètre si vous souhaitez obtenir un tremblement de la valeur de la propriété échantillonnée à un instant différent.
Exemple : position.wiggle(5, 20, 3, .5) génère environ 5 tremblements par seconde avec une taille moyenne de 20 pixels. En plus du tremblement principal, il est possible de produire deux niveaux supplémentaires de tremblements détaillés à une fréquence de 10 et 20 tremblements par seconde, et des tailles respectives de 10 et 5 pixels.
Dans cet exemple, qui porte sur une propriété à deux dimensions telle que Echelle, les deux dimensions tremblent avec la même intensité :
v = wiggle(5, 10);
[v[0], v[0]]
Cet exemple, sur une propriété à deux dimensions, tremble uniquement le long de l’axe y :
freq = 3;
amp = 50;
w = wiggle(freq,amp);
[value[0],w[1]];
- temporalWiggle(freq, amp, octaves=1, amp_mult=.5, t=time)
- Type de valeur renvoyé : Number ou Array.
Type d’argument : freq, amp, octaves, amp_mult et t sont des nombres (Number).
Echantillonne la propriété à l’instant de tremblement. La valeur freq mesure la fréquence en tremblements par seconde ; amp mesure l’amplitude en unités de la propriété à laquelle il s’applique ; octaves est le nombre d’octaves à cumuler ; amp_mult est le multiplicateur de amp pour chaque octave et t est l’instant de départ de base. Pour que cette fonction soit significative, la propriété qu’elle échantillonne doit être animée puisqu’elle n’altère que le moment de l’échantillonnage et non sa valeur. Par exemple : scale.temporalWiggle(5, .2).
- smooth(width=.2, samples=5, t=time)
- Type de valeur renvoyé : Number ou Array.
Type d’argument : width, samples et t sont des nombres (Number).
Lisse la valeur de la propriété dans le temps, en convertissant les variations importantes et brèves de la valeur en variations plus petites et réparties de manière uniforme. Ce lissage s’effectue en appliquant à la valeur de la propriété un filtre « Box » à l’instant indiqué. width est la plage de temps (en secondes) sur laquelle la moyenne du filtre est évaluée. La valeur samples est égale au nombre d’échantillons discrets, répartis uniformément dans le temps. Une valeur plus élevée permet d’obtenir un meilleur lissage (mais une performance moindre). Il est préférable que samples soit impair afin que la valeur à l’instant courant soit incluse dans la moyenne. Par exemple : position.smooth(.1, 5).
- loopIn(type="cycle", numKeyframes=0)
- Type de valeur renvoyé : Number ou Array.
Lit en boucle, vers l’avant, un segment de durée mesuré à partir de la première image clé du calque jusqu’au point de sortie du calque. La boucle est lue à partir du point d’entrée du calque. La valeur numKeyframes définit le segment qui est lu en boucle : ce segment correspond à la partie du calque qui va de la première image clé à l’image clé numKeyframes+1. Par exemple, loopIn("cycle", 3) lit en boucle le segment délimité par la première et la quatrième image clé. La valeur par défaut, 0, indique que toutes les images clés seront lues en boucle.
Les méthodes de lecture en boucle des images clés permettent de répéter une série d’images clés. Vous pouvez utiliser ces méthodes sur la plupart des propriétés. Sont exclues les propriétés qu’il est impossible d’exprimer par des valeurs numériques simples dans le panneau Montage, notamment la propriété Texte source, les propriétés de tracés de formes et la propriété Histogramme de l’effet Niveaux. Si elles sont trop grandes, les valeurs d’images clés ou de durées indiquées sont ramenées à la valeur maximale autorisée. De trop petites valeurs produisent une boucle constante.
Type de boucle
|
Résultat
|
|---|
cycle
|
(par défaut) Répète le segment spécifié.
|
pingpong
|
Répète le segment spécifié en alternant les répétitions vers l’avant et vers l’arrière.
|
offset
|
Répète le segment spécifié tout en décalant chaque cycle selon la différence de la valeur de la propriété au début et à la fin du segment, multipliée par le nombre de lectures en boucle du segment.
|
continue
|
Ne répète pas le segment spécifié, mais continue à animer une propriété en fonction de la rapidité de la première ou de la dernière image clé. Par exemple, si la dernière image clé de la propriété Echelle d’un calque indique 100 %, le calque continue sa mise à l’échelle, à partir de la valeur 100 % jusqu’au point de sortie au lieu de retourner directement au point de sortie. Ce type n’accepte pas les arguments images clés ou de durée.
|
- loopOut(type="cycle", numKeyframes=0)
- Type de valeur renvoyé : Number ou Array.
Lit en boucle, vers l’arrière, un segment de durée mesuré à partir de la dernière image clé du calque jusqu’au point d’entrée du calque. La boucle est lue jusqu’au point de sortie du calque. Le segment à lire en boucle est déterminé par le nombre d’images clés spécifié. La valeur numKeyframes indique le nombre de segments d’images clés à lire en boucle ; la plage spécifiée est mesurée à partir de la dernière image clé. Par exemple, loopOut("cycle", 1) lit en boucle le segment délimité par la dernière image clé et l’avant-dernière image clé. La valeur par défaut, 0, indique que toutes les images clés seront lues en boucle. Consultez l’entrée loopIn pour plus de détails.
Sur son blog omino pixel, David Van Brink met à disposition un article pédagogique et un projet-type qui expliquent comment utiliser les effets Echo et Laboratoire de particules, ainsi que la méthode loopOut, pour animer un nid grouillant de bactéries stylisées.
- loopInDuration(type="cycle", duration=0)
- Type de valeur renvoyé : Number ou Array.
Lit en boucle, vers l’avant, un segment de durée mesuré à partir de la première image clé du calque jusqu’au point de sortie du calque. La boucle est lue à partir du point d’entrée du calque. Le segment à lire en boucle est déterminé par la durée spécifiée. La valeur Duration indique le nombre de secondes de la composition à lire en boucle dans le segment ; la plage spécifiée est mesurée à partir de la première image clé. Par exemple, loopInDuration("cycle", 1) lit en boucle la première seconde de la totalité de l’animation. La valeur par défaut, 0, indique que le segment à lire en boucle doit commencer au point de sortie du calque. Consultez l’entrée loopIn pour plus de détails.
- loopOutDuration(type="cycle", duration=0)
- Type de valeur renvoyé : Number ou Array.
Lit en boucle, vers l’arrière, un segment de durée mesuré à partir de la dernière image clé du calque jusqu’au point d’entrée du calque. La boucle est lue jusqu’au point de sortie du calque. Le segment à lire en boucle est déterminé par la durée spécifiée. La valeur Duration indique le nombre de secondes de la composition à lire en boucle dans le segment ; la plage spécifiée est mesurée à partir de la dernière image clé. Par exemple, loopOutDuration("cycle", 1) lit en boucle la dernière seconde de la totalité de l’animation. La valeur par défaut, 0, indique que le segment à lire en boucle doit commencer au point d’entrée du calque. Consultez l’entrée loopIn pour plus de détails.
- key(index)
- Type de valeur renvoyé : Key ou MarkerKey.
Type d’argument : index est un nombre (Number).
Renvoie l’objet Key ou MarkerKey en fonction de son numéro. Par exemple, key(1) renvoie la première image clé.
- key(markerName)
- Type de valeur renvoyé : MarkerKey.
Type d’argument : markerName est une chaîne de caractères (String).
Renvoie l’objet MarkerKey portant ce nom. A n’utiliser qu’avec les propriétés de repère.
- nearestKey(t)
- Type de valeur renvoyé : Key ou MarkerKey.
Renvoie l’objet Key ou MarkerKey le plus proche de l’instant spécifié.
- numKeys
- Type de valeur renvoyé : Number.
Renvoie le nombre d’images clés d’une propriété. Renvoie le nombre de repères d’une propriété de repère.
Remarque : si vous utilisez la commande Séparer les dimensions pour séparer les dimensions de la propriété Position afin d’obtenir des composants individuels, le nombre d’images clés change et la valeur renvoyée par cette méthode est alors modifiée.
- propertyGroup(countUp = 1)
- Type de valeur renvoyé : Group.
Renvoie un groupe de propriétés lié à la propriété sur laquelle l’expression est écrite. Si, par exemple, vous ajoutez l’expression propertyGroup(1) à la propriété Rotation d’un tracé, l’expression prend comme cible le groupe de propriétés Transformer qui contient la propriété Rotation. Si, en revanche, vous ajoutez propertyGroup(2), l’expression prend comme cible le groupe de propriétés Pinceau. Cette méthode vous permet d’établir des relations entre des propriétés, indépendamment de leur nom. Cette méthode s’avère particulièrement utile lors de la duplication de propriétés contenant des expressions.
La méthode numProperties pour propertyGroup renvoie le nombre de propriétés dans le groupe de propriétés.
L’exemple suivant renvoie le nombre de propriétés du groupe contenant la propriété sur laquelle l’expression est rédigée :
thisProperty.propertyGroup(1).numProperties
- propertyIndex
- Type de valeur renvoyé : Number.
Renvoie l’index d’une propriété par rapport à d’autres propriétés de son groupe de propriétés, y compris les groupes de propriétés contenus dans les masques, effets, animations de texte, sélecteurs, formes, suivis et points de suivi.
- name
- Type de valeur renvoyé : String.
Renvoie le nom de la propriété ou du groupe de propriétés.
