Créer des scripts
#################

Prérequis
*********

Les scripts sont listés au démarrage par After Effects, sous réserve de trois choses :

* il s'agit de **fichiers textes** dont **le nom de fichier** se termine par **.jsx** [#jsx]_
* Ces fichiers sont placés dans les dossiers scrutés au démarrage par After Effects (voir plus bas)
* Les fichiers sont présents dans lesdits dossiers **avant** le démarrage. [#redemarrer-after]_

Un éditeur de texte sera aussi nécéssaire.

Types de scripts
****************

Il est possible de définir deux grands types de scripts :

* les scripts ne créant pas de panneaux (mais pouvant créer des fenêtres ne pouvant être utilisées avec le système de panneaux) et accessibles via la barre de menu → ``Fichier`` → ``Scripts``
* les scripts « ScriptUI », créant des panneaux et accessibles via la barre de menu → ``Fenêtres``

Emplacement des dossiers
************************

Les dossiers ``Scripts`` et ``ScriptUI Panels`` sont utilisés pour placer les scripts utilisateurs. Leur emplacement diffère selon le système d'exploitation.

macOS
=====

* Scripts simples : ``/Applications/Adobe After Effects CC 20XX/Scripts/ScriptUI Panels/``
* Scripts utilisant ScriptUI : ``/Applications/Adobe After Effects CC 20XX/Scripts/ScriptUI Panels/``

MS-Windows
==========

* Scripts simples : ``C:\Programmes\Adobe\Adobe After Effects CC 20XX\Support Files\Scripts\``
* Scripts utilisant ScriptUI : ``C:\Programmes\Adobe\Adobe After Effects CC 20XX\Support Files\Scripts\ScriptUI Panels\``

.. note::

   C:\Users\Nom d'utilisateur\AppData\Roaming\Adobe\After Effects\18.1\Scripts\ScriptUI Panels

   Le dossier AppData est un dossier caché, il faudra demander l'affichage des dossiers cachés.

.. seealso::

   `Voir la documentation relative à l'emplacement des scripts. <https://helpx.adobe.com/fr/after-effects/user-guide.html/fr/after-effects/using/scripts.ug.html#loading_and_running_scripts>`_

En image
========

.. figure:: images/emplacements.png

   Emplacements des dossiers avec macOS

Créer un script
***************

Pour créer un script, il vous faudra simplement créer votre script dans le répertoire adapté avant le démarrage d'After Effects. Le script peut être modifié alors qu'After Effects est démarré.

.. note::

   Vous pouvez aussi charger un script directement via ``Fichier`` → ``Scripts`` → ``Exécuter le fichier de Script``.

.. [#jsx] https://ae-scripting.docsforadobe.dev/introduction/overview/?highlight=folder#the-jsx-and-jsxbin-file-name-extensions
.. [#redemarrer-after] https://ae-scripting.docsforadobe.dev/introduction/overview/?highlight=folder#running-scripts-directly-from-the-file-scripts-menu