Rendu automatisé avec le fichier exécutable aerender

Le fichier exécutable aerender (aerender.exe sous Windows) est un programme équipé d’une interface de ligne de commande permettant d’automatiser le rendu. Le fichier exécutable réside dans le même dossier que l’application primaire After Effects. Les emplacements par défaut :

Windows : \Program Files\Adobe\Adobe After Effects CS4\Support Files
Mac OS : /Applications/Adobe After Effects CS4

Pour utiliser le programme, vous devez saisir la commande aerender sur la ligne de commande (ou dans un script de commandes) suivie d’une série d’arguments facultatifs. Certains de ces arguments sont de simples options qui ne nécessitent pas d’arguments propres (par exemple, -reuse), tandis que d’autres en nécessitent (par exemple, -project project_path).

Saisissez la commande aerender -help pour afficher des informations de syntaxe.

La version et le numéro de version de l’application sont écrites en sortie standard (stdout).

Le rendu peut être réalisé soit par une instance After Effects en cours d’exécution soit par une instance nouvellement démarrée. Par défaut, aerender démarre une nouvelle instance d’After Effects, même s’il y en a déjà une en cours d’exécution. Pour utiliser l’instance en cours d’exécution, utilisez l’argument –reuse.

Cet exemple de commande demande à After Effects d’effectuer le rendu des images 1 à 10 de Composition_1 du projet_1.aep en une séquence numérotée de fichiers Photoshop à l’aide d’un rendu multi-ordinateur :

aerender -project c:\projects\project_1.aep -comp "Composition_1" -s 1 -e 10 
-RStemplate "Multi-Machine Settings" -OMtemplate "Multi-Machine Sequence" 
-output c:\output\project_1\frames[####].psd

Pour n’effectuer que le rendu de Composition_1 vers un fichier défini, saisissez cette commande :

aerender -project c:\projects\project_1.aep -comp "Composition_1" -output c :\output\project_1\project_1.avi

Pour effectuer le rendu de tous les éléments présents dans la file d’attente avec les paramètres sélectionnés dans le fichier de projet, saisissez cette commande :

aerender -project c:\projects\project_1.aep

Argument	Description
`–help`	Imprime un message d’utilisation.
`–version`	Affiche le numéro de version de l’exécutable aerender sur la console. N’effectue pas de rendu.
`–v verbose_flag`	`verbose_flag` spécifie le type de messages signalé : `ERRORS` : signale uniquement les erreurs fatales et les problèmes. `ERRORS_AND_PROGRESS` : (par défaut) signale les erreurs et la progression du rendu.
`–reuse`	Utilise une nouvelle fois l’instance en cours d’exécution d’After Effects (si présente) pour exécuter le rendu. Lors de l’utilisation d’une instance déjà en cours d’exécution, aerender enregistre les préférences sur le disque une fois le rendu terminé mais ne quitte pas After Effects. Si cet argument n’est pas utilisé, aerender lance une nouvelle instance d’After Effects, même s’il y en a déjà une en cours. Il quitte cette instance une fois le rendu terminé sans enregistrer les préférences.
`–mem_usage image_cache_percentmax_mem_percent`	`image_cache_percent` définit le pourcentage maximal de mémoire utilisée pour cacher le métrage et les images déjà rendues. `max_mem_percent` précise le pourcentage total de mémoire à la disposition d’After Effects. Pour ces deux valeurs, si la quantité de mémoire vive installée est inférieure à une quantité donnée (`n` gigaoctets), la valeur représente un pourcentage de la mémoire vive installée, soit un pourcentage de `n`. La valeur de `n` est de 2 Go pour 32 bits sous Windows, de 4 Go pour 64 bits sous Windows et de 3,5 Go pour Mac OS.
`–project project_path`	`project_path` est un chemin d’accès ou une URI spécifiant un fichier de projet à ouvrir. Si cet argument n’est pas utilisé, aerender fonctionne avec le projet actuellement ouvert. Si aucun projet n’est spécifié ou ouvert, il en résulte une erreur.
`–comp comp_name`	`comp_name` spécifie une composition pour laquelle un rendu doit être effectué. Si la composition est déjà dans la file d’attente de rendu, la première instance de cette composition se trouvant dans la file d’attente est rendue. Si la composition est dans le projet, mais pas dans la file d’attente de rendu, alors elle est ajoutée à la file d’attente, puis rendue. Si cet argument n’est pas utilisé, aerender effectue le rendu de l’ensemble de la file d’attente ; dans ce cas, seuls les arguments `–project`, `–log`, `–output`, `–v`, `–mem_usage` et `–close` sont utilisés et tous les autres arguments sont ignorés.
`–s start_frame`	`start_frame` est la première image traitée pour le rendu. Si cet argument n’est pas utilisé, aerender utilise la première image du fichier.
`–e end_frame`	`end_frame` est la dernière image traitée pour le rendu. Si cet argument n’est pas fourni, aerender utilise la dernière image du fichier.
`–i increment`	`increment` correspond au nombre d’images à parcourir avant d’effectuer le rendu d’une nouvelle image. Une valeur de 1 (par défaut) correspond au rendu de toutes les images. Des valeurs supérieures effectuent le rendu d’une image et l’utilisent `increment` fois en sortie, puis ignorent les `increment` images suivantes pour commencer une nouvelle fois le cycle. Des valeurs supérieures entraînent des rendus plus rapides, mais un mouvement plus saccadé.
`–OMtemplate output_module_template`	`output_module_template` correspond au nom du modèle à appliquer au module de sortie. Si le modèle n’existe pas, l’utilisation de cet argument entraîne une erreur. Si cet argument n’est pas utilisé, aerender utilise le modèle déjà défini pour le module de sortie.
`–RStemplate render_sett ings_template`	`render_settings_template` correspond au nom du modèle à appliquer à l’élément de rendu. Si le modèle n’existe pas, l’utilisation de cet argument entraîne une erreur. Si cet argument n’est pas utilisé, aerender utilise le modèle de rendu déjà défini pour l’élément.
`–output output_path`	`output_path` correspond à un chemin d’accès ou à une URI spécifiant la destination du fichier de sortie. Si cet argument n’est pas utilisé, aerender utilise le chemin d’accès défini dans le fichier de projet.
`–log log_file_path`	`log_file_path` correspond à un chemin d’accès ou à une URI spécifiant l’emplacement du compte-rendu. Si cet argument n’est pas utilisé, aerender utilise la sortie standard.
`–sound sound_flag`	Si `sound_flag` est défini sur `ON`, un son est lu une fois le rendu terminé. La valeur par défaut est définie sur `OFF`.
`–close close_flag`	`close_flag` spécifie si le projet doit être fermé une fois le rendu terminé, et si les modifications doivent être enregistrées. `DO_NOT_SAVE_CHANGES` : (par défaut) le projet est fermé et les modifications ne sont pas enregistrées. `SAVE_CHANGES` : le projet est fermé et les modifications sont enregistrées. `DO_NOT_CLOSE` : le projet reste ouvert en cas d’utilisation d’une instance en cours d’exécution d’After Effects (les nouvelles instances d’After Effects doivent toujours être quittées une fois que vous avez terminé).
`-rqindex index_in_render_queue`	`-rqindex` fonctionne comme `-comp`, sauf qu’il ne crée pas automatiquement un élément de rendu de la composition.
`-mp enable_flag`	Si `enable_flag` est égal à 0, d’autres processus ne sont pas créés pour effectuer le rendu de plusieurs images simultanément. Si `enable_flag` est égal à 1, d’autres processus peuvent être créés pour effectuer le rendu de plusieurs images simultanément, en fonction des paramètres de configuration du système et des préférences (voir la section Préférences de mémoire et de multitraitement).
`-continueOnMissingFootage`	L’opération de rendu se poursuit même si un élément de métrage est absent.

Sur son site Web After Effects Scripts, Lloyd Alvarez propose un script qui prend les éléments prêts pour le rendu dans la file d’attente de rendu et les envoie au rendu en arrière-plan à l’aide d’aerender.