Premiers pas avec les quickscripts et la manipulation de cartons
Les quickscripts permettent de manipuler le carton en automatique.
Nous allons voir ci dessous les éléments principaux de l'utilisation de cette console.
virtualbook
La variable virtualbook contient le carton en cours de manipulation. On peut alors connaitre sur cet objet :
- La gamme (Scale)
- les trous (Hole)
- des évènements complémentaires (markers, mesures ..)
Tutoriel 1 : lister les trous du carton
lister les trous d'un carton : tapez virtualbook.getHolesCopy() dans la console, puis appuyez sur "Executer ..."
le résultat apparait dans la partie du bas.
la fonction appelée retourne une liste contenant tous les trous, les trous sont caractérisés par:
- un no de piste dans le carton (de 0 au nombre de pistes) : track
- une date de début du trou (en microseconde depuis le début du carton ): timestamp
- une longueur de trou (en microseconde depuis le debut du trou) : length
Commande :
def c = virtualbook.getHolesCopy()
print c[0] // on prends le premier
Resultat :
>> start script execution
900000 Note 44 Longueur 100000 micro
Script executed in 0: 0: 43
null
pour connaitre les proprietes du trou, vous pouvez utiliser la fonction "dump" :
Commande :
def d = virtualbook.getHolesCopy()
d[0].dump()
Resultat :
>> start script execution
900000 Note 44 Longueur 100000 micro
Script executed in 0: 0:105
<org.barrelorgandiscovery.virtualbook.Hole@4983ae77 timestamp=900000 length=100000 piste=44>
propriétés :
\<org.barrelorgandiscovery.virtualbook.Hole@4983ae77 timestamp=900000 length=100000 piste=44>
Pour accéder aux propriétés il suffit de mentionner son nom.
Commande :
def d = virtualbook.getHolesCopy()
def n = d[0]
println n.dump()
println n.piste
println n.timestamp
println n.length
Resultat :
>> start script execution
<org.barrelorgandiscovery.virtualbook.Hole@4983ae77 timestamp=900000 length=100000 piste=44>
44
900000
100000
Script executed in 0: 0: 84
null
Tutoriel 2 : Ajouter / Modifier / Supprimer des trous
Dans cette section, nous allons modifier les trous d'un carton, en modifiant le debut, la longueur ou en changeant la piste :
Modifions le debut d'un trou
Commande :
import groovy.aprint.transform.*
use(HoleCategory) {
def d = virtualbook.getHolesCopy()
def n = d[0] // on prends un trou
println n.dump() // on l'affiche
def h = n.beginAt(0) // on met le debut à 0
println h.dump() // on l'affiche
virtualbook.removeHole(n) // on enleve le trou initial
virtualbook.addHole(h) // on ajoute le nouveau trou modifié
}
Resultat :
>> start script execution
<org.barrelorgandiscovery.virtualbook.Hole@4983ae77 timestamp=900000 length=100000 piste=44>
<org.barrelorgandiscovery.virtualbook.Hole@1353d7 timestamp=0 length=100000 piste=44>
Script executed in 0: 0: 32
null
Aller plus loin
la documentation complete de cet objet est disponible ici :