Comment importer un script externe ?

Cet article explique comment importer des scripts écrits en Javascript. Si vous souhaitez travailler avec Python, veuillez consulter les articles Vue de la console du script Python et Toon Boom Harmony -- Python Interface.

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'une des options suivantes en fonction de votre version d'Harmony :

Options Harmony Standalon :

• 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.

Options Harmony Server: 

• 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.
• Global: Enregistre le script dans le répertoire global des scripts de la base de données Harmony. Toute personne connectée à la base de données pourra modifier et exécuter ce script.
• Environment: Enregistre le script dans l'environnement de la scène en cours. N'importe qui pourra éditer et exécuter le script tant qu'il travaillera sur une scène dans ce même «Environnement».
• Job: Enregistre le script dans le répertoire «Job» de la scène en cours. N'importe qui pourra éditer et exécuter le script à condition de travailler sur une scène inclue sous le même répertoire «Job».
• 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.