Les Repères (markers)

Toutes les informations d'un repère de calque sont contenues dans l'objet `MarkerValue()`. Cet objet possède 4 attributs : Commentaire, Chapitre, URL et Cible de l'image. Les 3 derniers attributs sont facultatifs et peuvent donc être omis. Chacun est représenté par une chaîne de caractères.

Nous devons d'abord créer un nouvel objet MarkerValue() et ensuite l'affecter à la propriété de Marker de notre calque grâce à la méthode `setValueAtTime()`. Il y a deux notations possibles pour faire référence à la propriété de Marker, `property("Marker")` ou directement `Marker`.

Supposons que nous voulions créer un repère sur notre calque à t = 1s. Nous ne souhaitons pas lui préciser un nom (commentaire) particulier ni aucun autre de ses attributs. Comme le premier paramètre est obligatoire, nous pouvons simplement mettre une chaîne de caractères vide "" afin qu'aucun texte n'apparaisse sur le calque. Nous écrirons par exemple :

      myLayer = app.project.activeItem.layer(1);

                              myMarker = new MarkerValue("");

                              myLayer.Marker.setValueAtTime(1,myMarker);

Si nous voulons un repère contenant plus d'informations, comme mettre un commentaire ou inclure un lien internet dans notre animation par exemple, on précise alors la valeur des attributs que l'on souhaite (on note que le deuxième attribut est une chaîne vide et le quatrième n'a pas été précisé) :

      myLayer = app.project.activeItem.layer(1);

                              myMarker = new MarkerValue("monCommentaire","","http://www.nabscripts.com");

                              myLayer.Marker.setValueAtTime(2,myMarker);