• Expressions
• Scripting
• Downloads
• Contact

Scripting/Rendu/File de rendu

L'objet renderQueue

L'objet renderQueue permet d'accéder aux informations relatives à la file d'attente de rendu. Cet objet est une collection d'items, comme l'étaient les items de la fenêtre de projet ou en encore les calques d'une composition. On ajoute un élément à la file grâce à la méthode add(). On n'ajoute pas directement un élément à la file mais plutôt à sa collection d'items, notée items.

Pour ajouter par exemple la composition active à la file de rendu, on pourrait écrire:

myProj = app.project;
myComp = myProj.activeItem;
myRenderQueue = myProj.renderQueue;
myQueueItem = myRenderQueue.items.add(myComp);

Paramètres de rendu

Une fois que l'élément a été ajouté dans la file d'attente, il devient un item de sa collection. L'attribut numItems indique le nombre d'éléments se trouvant dans la file. On accède à un item de la file par la méthode item() en lui précisant l'index de l'élément (i.e., une valeur entre 1 et numItems).

Les fonctions suivantes permettent de régler les paramètres de rendu d'un item.

• applyTemplate()

  La méthode applyTemplate() permet de choisir un modèle prédéfini. Elle nécessite un seul paramètre qui est le nom du modèle à appliquer. Pour indiquer le modèle de paramètres qui s'appelle par exemple "best", on écrit:

  myQueueItem.applyTemplate("best");

  

  Modèle de paramètres de rendu

• outputModules et outputModule()

  L'objet outputModules contient l'ensemble des modules de sortie pour un élément de la file. On rappelle au passage qu'un seul rendu peut avoir plusieurs modules de sortie (on peut ajouter un module de sortie en sélectionnnant l'élément dans la file et en choisissant "Ajouter un modèle de sortie" dans le menu "Composition"). L'attribut numOutputModules représente le nombre de modules de sortie pour un item de la file (en général il est égal à 1).

  La méthode outputModule() permet d'accéder au modèle de sortie dont on précise l'index en paramètre. Par exemple si l'on souhaite appliqué le modèle de module de sortie nommé "QT_sorenson3_high", on pourrait écrire:

  myOM = myQueueItem.outputModule(1);
  myOM.applyTemplate("QT_sorenson3_high");
  

  

  Modèle de module de sortie

• logType

  Bien que l'option de compte-rendu (CR) ne soit en général pas d'une grande utilité, il est possible de la paramétrer par l'intermédiaire de l'attribut logType. Sa valeur est un type énuméré qui peut être LogType.ERRORS_ONLY, LogType.ERRORS_AND_SETTINGS ou LogType.ERRORS_AND_PER_FRAME_INFO (respectivement Erreurs uniquement, Paramètres supplémentaires ou Informations supplémentaires par image).

  myQueueItem.logType = LogType.ERRORS_AND_SETTINGS;

  

  Compte-rendu

• file

  Pour définir le fichier en sortie, il faut créer un nouvel objet fichier (new File()), en précisant le nom du fichier (chemin complet). Pour déterminer le dossier de destination, on peut le faire par exemple par l'intermédiaire d'une boîte de dialogue proposée à l'utilisateur. L'exemple suivant utilise un des modèles disponibles pour nommer le fichier (nom et taille de la composition):

  myPath = folderGetDialog("Choisir un dossier de destination:");
  myOM.file = new File(myPath.toString() + "/[compName]_[width]x[height].[fileExtension]");
  

  

  Fichier de sortie

• timeSpanStart et timeSpanDuration

  L'attribut timeSpanStart permet de définir l'instant dans la composition auquel le rendu doit débuter. L'attribut timeSpanDuration spécifie la durée. Les deux s'expriment en secondes.

  myQueueItem.timeSpanStart = 2;
  myQueueItem.timeSpanDuration = 5;
  

  

  Durée personnalisée

Le rendu

Pour lancer un rendu on utilise la méthode render(). Les items en attente seront rendus les uns après les autres en respectant l'ordre dans lequel ils se trouvent dans la file.

Rendu

• File de rendu