Animation

Un objet Animation est un objet graphique très complet : il peut prendre plusieurs apparences, se déplacer, détecter des collisions, etc.

• Créer un objet Animation :

uneAnimation = new Animation()

• Créer un objet Animation en chargeant une image depuis un fichier :

uneAnimation = new Animation("fichier.png")

L'image chargée est affichée directement

• Placer l’Animation :

uneAnimation.définirPosition(300,200)
uneAnimation.définirPositionCentre(300,200)

• Récupérer les coordonnées de l’Animation :

uneAnimation.récupérerCoordonnéeX()
uneAnimation.récupérerCoordonnéeY()

• Montrer / Cacher l’animation :

uneAnimation.montrer()
uneAnimation.cacher()

• Ajouter une image :

uneAnimation.ajouterImage("fichier.png")

• Ajouter une image en l'assignant à un ensemble d'images :

uneAnimation.ajouterImage("fichier.png", "ensemble")

• Supprimer une des images :

uneAnimation.supprimerImage("fichier.png")

• Supprimer les images d'un ensemble d'images :

uneAnimation.supprimerImages("ensemble")

• Afficher une des images :

uneAnimation.afficherImage("fichier.png")

L’objet Animation prend automatiquement la taille de l’image qu’il affiche.

• Afficher l’image suivante / l'image précédente :

uneAnimation.afficherImageSuivante()
uneAnimation.afficherImagePrécédente()

• Afficher l’image suivante / l'image précédente d'un ensemble d'images :

uneAnimation.afficherImageSuivante("ensemble")
uneAnimation.afficherImagePrécédente("ensemble")

• Rendre une couleur transparente :

uneAnimation.rendreTransparent("couleur")

• Faire bouger l’Animation :

uneAnimation.avancer(50)
uneAnimation.reculer(50)
uneAnimation.monter(50)
uneAnimation.descendre(50)
uneAnimation.allerA(0,0)

• Faire bouger l’Animation sans s’arrêter :

uneAnimation.avancer()
uneAnimation.reculer()
uneAnimation.monter()
uneAnimation.descendre()

ou

uneAnimation.avancerToujours()
uneAnimation.reculerToujours()
uneAnimation.monterToujours()
uneAnimation.descendreToujours()

• Arrêter l’Animation :

uneAnimation.arrêter()

• Changer la vitesse :

uneAnimation.définirVitesse(100)

la vitesse par défaut est de 100. Une vitesse de 0 rend l'Animation immobile.

• Supprimer l’objet Animation :

uneAnimation.supprimer()

Un objet Animation peut surveiller les collisions qui se produisent avec d'autre objets Animation, Promeneur ou Héros.

• Pour chaque collision, on peut dire à l'objet Animation d'exécuter des commandes :

uneAnimation.siCollision("commande")

• On peut dire à l'objet Animation de n'exécuter des commandes que s'il rencontre un objet particulier, grâce à l'action :

uneAnimation.siCollision("commande", objet)

ou

uneAnimation.siCollisionAvec(objet, "commande")

• On peut également dire à l'objet Animation de n'exécuter des commandes que s'il rencontre une catégorie d'Animations :

uneAnimation.siCollision("commande", "catégorie")

ou

uneAnimation.siCollisionAvec("catégorie", "commande")

• Définir la catégorie d'une Animation :

uneAnimation.définirCatégorie("catégorie")

Si on fait plusieurs fois appel à une des actions ci-dessus, les commandes s'ajoutent. Par exemple :

uneAnimation.siCollision("commande1")
uneAnimation.siCollision("commande2")

L'objet Animation exécutera « commande1 » puis « commande2 » dès qu'il détecte une collision.

• Désactiver / Réactiver la détection des collisions :

uneAnimation.surveillerCollisions(false)
uneAnimation.surveillerCollisions(true)

par défaut, la détection des collisions est activée.