Comment importer un script externe ?

Cet article explique comment importer des scripts écrits en Javascript dans Harmony Essentials.

Lignes directrices pour les scripts

Avant d'importer un script externe, prenez note des points suivants :

• Les scripts destinés à l'importation doivent être au format javascript (.js).
• Les scripts externes ne peuvent pas être contenus dans un dossier zippé ou compressé.
• Des icônes personnalisées peuvent être créées pour les scripts externes afin de les rendre plus facilement reconnaissables dans la barre d'outils «Scripting» de Harmony.
• Un fichier d'interface utilisateur (.ui) ou un fichier d'icône (.png) sera également importé lorsque:
  • Ils se trouvent dans le même dossier que le script
  • Ils ont le même nom de fichier que le script
• Vous pouvez définir des dossiers personnalisés pour l'enregistrement des scripts, voir Stockage des scripts dans un répertoire personnalisé.
• Pour en savoir plus sur les scripts dans Harmony, voir A propos de Scripting.

Étape 1 : Importation d'un script

1. Ouvrir la fenêtre «Script Editor» en effectuant l'une des opérations suivantes :
   • Dans le menu supérieur, sélectionnez Windows > Script Editor.
   • Dans n'importe quelle vue, sélectionnez le bouton «Add View» et choisissez «Script Editor».
2. La vue «Script Editor» s’ouvre:

3. Pour localiser un script à importer, effectuez l'une des opérations suivantes :
   • Dans la barre d’outils «Script Editor» , sélectionnez le bouton «Import Script».
   • Dans le coin supérieur gauche de la vue «Script Editor», cliquez sur le Menu et sélectionnez File > Import Script.

4. Une fenêtre de navigateur apparaît.
5. Recherchez le script dans le répertoire de l'ordinateur et sélectionnez le bouton Open pour l'importer.
6. La boîte de dialogue «Save Script» apparaîtra :

7. Dans le menu déroulant, choisissez l'emplacement où vous souhaitez enregistrer le script :
   • User: Le script est enregistré dans le dossier «preferences» de l'utilisateur. Vous pourrez exécuter et modifier le script dans n'importe quelle scène tant que vous serez connecté en tant que même utilisateur.
   • Scene: Enregistre le script dans le sous-dossier «scripts» de la scène. N'importe qui pourra éditer et exécuter le script lorsqu'il travaillera sur cette scène spécifique.
   • System Variable: Enregistre le script dans le répertoire d'environnement variable TOONBOOM_GLOBAL_SCRIPT_LOCATION. Cette option n'est disponible que si cette variable d'environnement est définie.
8. Répétez les instructions 2 à 8 autant de fois que nécessaire pour importer tous vos scripts.