Création d'une composition

Nous pouvons aisément créer une composition dans note projet. En termes de scripting on parlera d'ajouter au projet un item de type CompItem. Nous le ferons grâce à la méthode `addComp()`.

A titre d'exemple, commençons par vérifier si un projet est déjà ouvert et dans le cas contraire créons en un. On stockera cet objet projet dans la variable "myProj" :

      if (!app.project) myProj = app.newProject();

                           else myProj = app.project;

Il est important de noter ici que l'on n'ajoute pas directement une composition à l'objet "project" mais plutôt à sa collection d'items déjà présents, cette collection s'appelle `items`. Cette méthode nécessite six paramètres pour créer une composition : son nom, sa largeur, sa hauteur, le format des pixels, sa durée et enfin sa cadence (dans cet ordre).

Nous écrirons par exemple :

myProj.items.addComp("maCompoTest",720,576,1,10,25);

Si nous souhaitons dupliquer une composition par exemple, nous avons à notre disposition la méthode "duplicate()". Suposons que l'on veuille dupliquer la composition "maCompoTest", disons 8 fois, nous pourrions écrire cela :

      myItem = myProj.item(1);

                           for(i = 1; i <= 8; i++) {

                                  myItem.duplicate();

                           }

Si au contraire on souhaite supprimer un élément du projet, on utilise alors la méthode `remove()`. Attention, le nombre d'items contenus dans un projet se met à jour automatiquement, si bien que lorsque nous supprimons un item du projet, son attribut "numItems" diminue d'une unité.

Imaginons que nous voulions supprimer toutes ces compositions du projet, il est alors préférable pour ce genre de manipulations de procéder en "marche arrière". Cela signifie commencer par supprimer le dernier item puis remonter dans la liste jusqu'à ce qu'il n'y en ait plus (on note que l'itérateur "i" diminue d'une unité à chaque suppression).

      i = myProj.numItems;

                           while(i > 0) {

                                  myProj.item(i).remove();

                                  i--;

                           }