PDF (adobe.com)

Méthodes des nombres aléatoires

seedRandom(offset, timeless=false)
Type de valeur renvoyé : aucun.

Type d’argument : offset est un nombre (Number), timeless est un booléen (Boolean).

Les méthodes random et gaussRandom utilisent une valeur de générateur qui contrôle la séquence de nombres. Par défaut, la valeur est calculée en tant que fonction d’un identifiant de calque unique, de la propriété à l’intérieur du calque, de l’instant courant et d’une valeur de décalage de 0. Appelez seedRandom pour définir le décalage sur une valeur différente de 0 et créer une séquence aléatoire différente.

Utilisez true pour l’argument timeless afin de ne pas utiliser l’instant courant comme générateur aléatoire. L’utilisation de true pour l’argument timeless vous permet de générer un nombre aléatoire ne variant pas en fonction du moment d’évaluation.

La valeur offset, contrairement à la valeur timeless, permet également de contrôler la valeur initiale de la fonction wiggle (tremblement).

Par exemple, cette expression attribue à la propriété Opacité une valeur aléatoire sans variation temporelle :

  seedRandom(123456, true); 
  random()*100

La multiplication par 100 dans cet exemple convertit la valeur entre 0 et 1 renvoyée par la méthode random en un nombre compris entre 0 et 100. Cette plage est plus généralement utilisée pour la propriété Opacité dont la valeur est comprise entre 0 % et 100 %.

random()
Type de valeur renvoyé : Number.

Renvoie un nombre aléatoire dans la plage 0 à 1.

random(maxValOrArray)
Type de valeur renvoyé : Number ou Array.

Type d’argument : maxValOrArray est un nombre (Number) ou un ensemble (Array).

Si maxValOrArray est un nombre, cette méthode renvoie un nombre compris entre 0 et maxValOrArray. Si maxValOrArray est un ensemble (Array), cette méthode renvoie un ensemble de même dimension que maxValOrArray, dont chaque composant se situe entre 0 et le composant correspondant de maxValOrArray.

random(minValOrArray, maxValOrArray)
Type de valeur renvoyé : Number ou Array.

Type d’argument : minValOrArray et maxValOrArray sont des nombres (Number) ou des ensembles (Array).

Si minValOrArray et maxValOrArray sont des nombres, cette méthode renvoie un nombre compris entre minValOrArray et maxValOrArray. Si les arguments sont des ensembles, cette méthode renvoie un ensemble ayant la même dimension que l’argument doté de la plus grande dimension, chaque composant dans la plage du composant correspondant de minValOrArray au composant correspondant de maxValOrArray. Par exemple, l’expression random([100, 200], [300, 400]) renvoie un ensemble dont la première valeur se situe dans la plage 100 à 300 et dont la deuxième valeur est dans la page 200 à 400. Si les dimensions des deux ensembles d’entrée ne correspondent pas, les valeurs de dimension supérieure de l’ensemble le plus court sont complétées par des zéros.

gaussRandom()
Type de valeur renvoyé : Number.

Renvoie un nombre aléatoire. Les résultats ont une distribution gaussienne. Environ 90 % des résultats se situent entre 0 et 12, et les 10 % restant se situent hors de cette plage.

gaussRandom(maxValOrArray)
Type de valeur renvoyé : Number ou Array.

Type d’argument : maxValOrArray est un nombre (Number) ou un ensemble (Array).

Lorsque maxValOrArray est un nombre (Number), cette méthode renvoie un nombre aléatoire. Environ 90 % des résultats se situent entre 0 et maxValOrArray, et les 10 % restant se situent hors de cette plage. Lorsque maxValOrArray est un ensemble (Array), cette méthode renvoie un ensemble de valeurs aléatoires, de même dimension que maxValOrArray. 90 % des valeurs se situent entre 0 et maxValOrArray, et les 10 % restant se situent hors de cette plage. Les résultats ont une distribution gaussienne.

gaussRandom(minValOrArray, maxValOrArray)
Type de valeur renvoyé : Number ou Array.

Type d’argument : minValOrArray et maxValOrArray sont des nombres (Number) ou des ensembles (Array).

Si minValOrArray et maxValOrArray sont des nombres (Number), cette méthode renvoie un nombre aléatoire. Environ 90 % des résultats se situent entre minValOrArray et maxValOrArray, et les 10 % restant se situent hors de cette plage. Si les arguments sont des ensembles, cette méthode renvoie un ensemble de nombres aléatoires de même dimension que l’argument de dimension maximale. Pour chaque composant, environ 90% des résultats se situent dans la plage entre le composant correspondant de minValOrArray et le composant correspondant de maxValOrArray, et les 10 % restant se situent hors de cette plage. Les résultats ont une distribution gaussienne.

noise(valOrArray)
Type de valeur renvoyé : Number.

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

Renvoie un nombre dans la plage -1 à 1. Le bruit n’est pas véritablement aléatoire : il s’appuie sur le bruit Perlin qui signifie que les valeurs renvoyées de deux valeurs d’entrée proches seront également généralement proches l’une de l’autre. Ce type de bruit est utile lorsque vous souhaitez obtenir une séquence de nombres apparemment aléatoires à faible variation comme c’est généralement le cas pour l’animation d’un mouvement naturel apparemment aléatoire. Par exemple, rotation + 360*noise(time)