====== Héros ======

L'objet Héros est un objet [[Personnage]] particulier : il possède plusieurs apparences prédéfinies et s'anime lorsqu'il se déplace. Il est également capable de se déplacer dans des objets [[Décor]].

{{ :objets:heros.png }}

===== Créer un objet Héros =====

  * Créer un objet Héros :

<code declick>
unHéros = new Héros()
</code>

  * Créer un objet Héros en chargeant une image depuis un fichier :

<code declick>
unHéros = new Héros("fichier.png")
</code>

{{information.png}} L'image chargée est affichée directement et remplace les images prédéfinies.

===== Actions =====

==== Actions des objets Personnage ====

Les objets Héros sont des objets Personnage particuliers : ils possèdent donc déjà [[personnage#Actions|toutes les actions des objets Personnage]].

==== Actions supplémentaires ====

  * Changer la représentation du Héros :

<code declick>
unHéros.changer("garçon")
</code>

{{ :objets:types_heros.png |}}

  * Arrêter le mouvement automatique du Héros lorsqu'il se déplace :

<code declick>
unHéros.arrêterMouvement()
</code>

  * Démarrer le mouvement automatique du Héros lorsqu'il se déplace :

<code declick>
unHéros.démarrerMouvement()
</code>

  * Définir la durée totale du mouvement de déplacement (la durée pendant laquelle toutes les images du déplacement s'affichent) :

<code declick>
unHéros.définirDuréeMouvement(500)
</code>

{{information.png}} la durée est en millisecondes : un délai de 1000 correspond à une seconde. La valeur par défaut dépend de la représentation choisie.

  * Définir la durée totale de l'animation de l'objet Héros lorsqu'il est à l'arrêt :

<code declick>
  unPersonnage.définirDuréeArrêt(1200)
</code>

{{information.png}} la durée est en millisecondes : un délai de 1000 correspond à une seconde. La valeur par défaut dépend de la représentation choisie.

  * Ajouter un objet [[Décor]] au Personnage :

<code declick>
  unPersonnage.ajouterDécor(unDécor)
</code>

{{information.png}} Lorsque le Héros est associé à un objet Décor, il ne peut pas circuler sur les zones bloquées de ce Décor.

/*
 *  * Ne plus associer cet objet à des objets [[objet:bloc|Blocs]] :
 *
 *  unPersonnage.supprimerBlocs()
 *
 */

===== Gestion des événements =====

Un objet Héros gère les mêmes événements qu'un objet [[Personnage#gestion_des_evenements|Personnage]]. Il peut en plus attraper des objets.

  * Donner la possibilité au Héros d'attraper un objet (objets [[Animation]], [[Personnage]], [[Item]] ou [[Héros]]) :

<code declick>
unHéros.peutAttraper(unObjet)
</code>

{{information.png |}} L'objet ''%%unObjet%%'' doit exister et être de catégorie [[Animation]], [[Personnage]], [[Item]] ou [[Héros]]. Lorsque le Héros passera sur cet objet, il le fera disparaître.

  * Ajouter une commande à exécuter lorsque l'objet Héros attrape un objet :

<code declick>
unHéros.siAttrape(unObjet, "commande")
</code>

{{information.png |}} Cette commande est en fait un raccourci pour les deux commandes suivantes : 
<code declick>
unHéros.peutAttraper(unObjet)
unHéros.siCollisionAvec(unObjet, "commande")
</code>

===== Modification de l'apparence =====

L'apparence par défaut du Héros peut être modifiée en ajoutant des images à l'objet.

  * Ajouter des images qui seront affichées en séquence pour tous les mouvements (images par défaut) :

<code declick>
unHéros.ajouterImage("image1.png")
unHéros.ajouterImage("image2.png")
  ...
</code>

{{information.png |}} Ces images sont affichées en boucle par l'objet Héros. Quand il se déplace, la boucle dure le temps défini par l'action ''%%définirDuréeMouvement%%''. Quand il est à l'arrêt, la boucle dure le temps défini par l'action ''%%définirDuréeArrêt%%''.

  * Ajouter des images qui seront affichées en séquence lorsque le Héros avance :

<code declick>
unHéros.ajouterImage("image1.png", "avancer")
unHéros.ajouterImage("image2.png", "avancer")
  ...
</code>

  * Ajouter des images qui seront affichées en séquence lorsque le Héros recule :

<code declick>
unHéros.ajouterImage("image1.png", "reculer")
unHéros.ajouterImage("image2.png", "reculer")
  ...
</code>


  * Ajouter des images qui seront affichées en séquence lorsque le Héros est à l'arrêt :

<code declick>
unHéros.ajouterImage("image1.png", "arrêt")
unHéros.ajouterImage("image2.png", "arrêt")
  ...
</code>