|
Centre d'aide
Les variables peuvent être une fonctionnalité utile pour l'exportation. Cet article explique la définition et l'application des variables dans Harmony Premium. Nous nous intéresserons plus particulièrement aux variables utilisées pour les noms de fichiers, mais vous trouverez à la fin de cet article une section consacrée à d'autres utilisations.
Qu’est-ce qu’une variable ?
Une variable est un mot ou une commande prédéterminée qui représente une valeur qui sera automatiquement modifiée lors de l'exportation en fonction du type de variable utilisée.
Dans Harmony, les variables sont précédées du préfixe $. L'utilisation de ce symbole indique à Harmony qu'une variable est utilisée et Harmony remplacera automatiquement cette variable par des informations spécifiques lors de l'exportation.
Par exemple, l'utilisation de la variable $Scene insérera automatiquement le nom de la scène à la place de la variable lors de l'exportation. Les variables peuvent également être utilisées ensemble pour exporter des informations plus spécifiques dans le nom du fichier.
Où dois-je utiliser les variables ?
Les variables peuvent être utilisées dans les champs « Folder » et « Filename » (onglet « Output ») des nœuds suivants:
- Noeud Write (Sections « Image Sequence » et « Movie »)
- Noeud CryptoMatte-Write
- Noeud Multi-Layer-Write
Si vous passez votre souris sur ces champs, une liste des variables disponibles apparaîtra :
À propos de l'utilisation des variables
Lorsque vous utilisez des variables dans les noms de fichiers, il est important de savoir ce qui suit :
- Toutes les variables doivent commencer par $, sinon elles ne seront pas reconnues comme des variables.
- Une orthographe correcte est importante, mais l'emploi des majuscules ne l'est pas.
- Les variables et les noms réguliers peuvent être combinés. Séparez-les par un trait de soulignement si vous souhaitez insérer des espaces entre eux. Par exemple : $Job$SceneNew ou $Job_$Scene_New.
- Certaines variables ne se remplacent pas par des informations, mais les ajoutent après le nom de la variable. Les variables suivantes fonctionnent ainsi et sont également indiquées dans le tableau ci-dessous:
- $Scene_Metadata
- $Environment_Name
- $Node_Metadata
- $Node_PortName
À propos des valeurs de remplissage
Certaines variables vous permettent d'ajouter des informations de remplissage, représentées par quelque chose qui ressemble à (%04d) dans la fenêtre contextuelle des variables Harmony. Les valeurs indiquées sont suggérées, et vous pouvez les ajuster selon vos besoins. Ces valeurs de remplissage doivent être placées à la fin de la variable, entre crochets, et représentent ce qui suit :
- %: Le définit comme une variable.
- 04: Définit le nombre minimum de chiffres. Le nombre obtenu comportera au moins quatre caractères.
- d: Indique que la valeur à formater est un entier décimal..
Exemple : Dans une scène où la résolution est de 1080x1920 ;
- La variable $Resolution_Width(%04d) exportera le nom de fichier 1920.
- La variable $Resolution_Width(%08d) exportera le nom de fichier 00001920.
Le remplissage peut être appliqué aux variables suivantes (également indiquées dans le tableau ci-dessous):
- $Version_ID
- $Resolution_Width
- $Resolution_Height
| NOTE: Si vous souhaitez savoir comment utiliser les variables lors de l'exportation, veuillez consulter Comment utiliser les variables lors de l'exportation ? |
Quelles variables sont disponibles ?
Les variables suivantes peuvent être utilisées dans les noms de fichiers et de dossiers Harmony lors de l'exportation. Veillez à les orthographier comme indiqué dans la colonne Variable (les majuscules ne sont pas obligatoires).
| Variable | Description/Résultat |
| $Environment | Nom de l'environnement serveur Harmony |
| $Job | Nom du segment « job » du serveur Harmony |
| $Scene | Nom de la scène (Harmony server et Standalone) |
| $Version_ID | ID de version de la scène, peut être sujet au remplissage par $Version_ID(%03d) |
| $Version_Name | Scene’s version name |
| $Scene_Metadata | Valeur Scene_Metadata, c'est-à-dire : $Scene_Metadata(nomDeLaMétadonnée) |
| $Environment_Name | Valeur de l'environnement système, c'est-à-dire : $Environment_Name(nomDeL'Environnement) |
| $Resolution_Name | Nom de la résolution de rendu actuelle |
| $Resolution_Width | Largeur actuelle de la résolution de rendu, peut être sujette au remplissage avec $Resolution_Width(%04d) |
| $Resolution_Height | Hauteur actuelle de la résolution de rendu, peut être sujette au remplissage avec $Resolution_Height(%04d) |
| $Colorspace | Nom de l'espace colorimétrique |
| $Node_Name | Nom du nœud de rendu |
| $Node_Group | Nom du groupe parent du nœud de rendu |
| $Node_Metadata | Valeur des métadonnées du nœud de rendu, par exemple : $Node_Metadata(nomDeLaMétadonnée) |
| $Node_PortName | Nom du port du nœud de rendu à l'index de port donné, par exemple : $Node_PortName(0) |
| $Date | Date actuelle au format (jj.mm.aaaa) |
Autres utilisations des variables
Voici quelques autres façons d'utiliser les variables avec ou dans Harmony :
- Utilisation des variables %PATH% et $PATH pour configurer le traitement par lots ou « Batch Processing » :
- Utilisation de la variable TOONBOOM_GLOBAL_SCRIPT_LOCATION pour enregistrer les scripts dans un répertoire personnalisé :