global
######
.. note::
Cette documentation est calquée sur l'article *Global* de la documentation `ae-expressions.docsforadobe.dev <https://ae-expressions.docsforadobe.dev/global.html>`_.
comp(``nom``)
*************
**Description**
Permet d'obtenir la référence d'une composition grâce à son nom.
**Paramètres**
======= ==============================
``nom`` String (*chaîne de caractères*)
======= ==============================
**Type**
Comp (*composition*)
----
footage(``nom``)
****************
**Description**
Permet d'obtenir la référence d'un métrage grâce à son nom.
**Paramètres**
======= =============================
``nom`` String (chaîne de caractères)
======= =============================
**Type**
Footage (*métrage*)
----
thisProject
***********
**Description**
Permet d'obtenir la référence du projet qui contient l'expression.
**Type**
Project (*projet*)
----
thisComp
********
**Description**
Permet d'obtenir la référence de la composition qui contient l'expression.
**Type**
Comp
----
thisLayer
*********
**Description**
Permet d'obtenir la référence du calque qui contient l'expression.
.. note::
*thisLayer* est l'objet par défaut, son usage est donc normalement optionnel.
Ainsi ``width`` revient à ``thisLayer.width``.
**Type**
Layer (*calque*), Light (*lumière*), ou Camera (*caméra*).
----
thisProperty
************
**Description**
Représente la propriété qui contient l'expression. Par exemple si vous écrivez une expression sur la propriété rotation, thisProperty correspondra à celle-ci.
**Type**
Property (*propriété*)
----
time
****
**Description**
Représente le temps écoulé depuis le début de la composition en secondes à l'instant où l'expression est évaluée.
**Type**
Number (*Nombre*)
----
posterizeTime(``images_par_seconde``)
*************************************
**Description**
Cette expression vous permet de régler la fréquence à laquelle l'expression sera évaluée.
Par exemple, imaginons que votre composition soit à 50ips, vous pouvez régler un changement toutes les 1ips :
.. code-block::javascript
posterizeTime(1);
random()
**Paramètres**
====================== =================
``images_par_seconde`` Number (*Nombre*)
====================== =================
La valeur ``images_par_seconde`` devient la fréquence à laquelle l'expression est évaluée.
**Type**
Number
.. note::
Il est possible de faire varier la fréquence :
.. code-block:: javascript
// les 3 premières secondes
if ( time < 3 ) {
posterizeTime( 1 ); // 1 ips
// après
} else {
posterizeTime( 4 ); // 4 ips
}
// l'expression à évaluer
Math.floor( random() * 1000 )
----
value
*****
**Description**
Représente la valeur à l'instant de l'évaluation de la propriété contenant l'expression.
Il s'agit de la valeur de la propriété et non de celle évaluée de l'expression.
**Type**
Number, Array, or String
----
colorDepth
**********
**Description**
Renvoie la profondeur de couleur. Renverra par exemple ``16`` si le projet est paramétré en 16 bits par canal.
**Type**
Number (*nombre*)