retour aux mémos    

Affichage programmable du style d'un agent (animal)

Objectif: Attribuer une image à chaque agent qui pourra être affichée et modifiée en passant par la programmation.

Classes concernées

C_StyleAgent (affichage des images) / I_data (liste d’états d’un agent) / C_InspecteurImage (gestionnaire des images) / A_VisibleAgent / I_sim_constants

Modifications apportées

• Création de C_InspecteurImage dans le package épiphyte et de C_StyleAgent et  I_data dans le package affichage.
• Dans A_VisibleAgent : haveToChange() retourne vrai si une condition de changement de l’image est remplie.
• Dans I_sim_constants : Création d’une variable globale SELECT_AFFICHAGE qui permet de choisir la représentation des agents (image ou ellipse).

Mode de gestion par la plateforme

·        Dialogue avec le context

Le dialogue avec le context se fait après l’ajout des agents au context (à partir de la méthode build()). Dans le document xml du display dans lequel on veut utiliser le style, il faut modifier la ligne dans styles/entry. On a alors une première ligne qui correspond au path de l'agent, et une seconde qui est le path de son style. Il suffit d'écrire le package.class correspondant pour l'appliquer à la simulation.

·        Relation avec l’affichage

Pour modifier l’icône d’un agent, on ne passe plus par le 2D Shape Editor. L’affichage est géré par C_StyleAgent et les images par C_InspecteurImage.

Définir une image pour chaque agent

·        C’est le système épiphyte qui gère les images, par le biais de la classe C_InspecteurImage.

·        L’inspecteur d’images est instancié à l’initialisation, dans le ContextCreator, afin d’être disponible le plus tôt possible. Il charge toutes les images qui pourront être utilisées au cours de la simulation. Ceci permet de gagner du temps de calcul durant cette dernière.

·        C_StyleAgent initialise l'icône des agents avec la méthode getVSpatial(). Un VSpatial peut être une image ou une forme géométrique. Repast appelle cette méthode à chaque pas de temps et pour chaque agent. De plus, ces derniers possèdent tous leur VSpatial, inclus dans une liste gérée par Repast. Pour créer un VSpatial il faut utiliser un ShapeFactory2D et sa méthode createImage(String id, BufferedImage img) ou createCircle(float radius, int slices). L'id des VSpatial doit être différent pour chaque appelle de createImage(…). De ce fait, on peut prendre l'id de l'agent à qui il appartient ainsi que son âge pour le définir. L'image en paramètre est choisie grâce à C_InspecteurImage.selectIcon().

Mise à jour des images

• Cette étape se déroule dans getVSpatial() et getColor() de C_StyleAgent, à chaque pas de temps et pour chaque agent.
• On crée une fonction haveToChange() dans A_VisibleAgent qui contient les conditions de changement d’une image. Elle retournera vrai si au moins l'une d’entre elles est vérifiée, faux sinon. Si la réponse est positive :

·        Si on utilise la représentation par les images, on utilise la méthode createImage(...) dans getVSpatial() ;

·        Si on utilise la représentation par les ellipses, le VSpatial retourné dans getVSpatial() est créé au début de la simulation mais ne sera plus modifié dans cette classe. C'est la fonction getColor() qui va mettre à jour la couleur de l'ellipse à l'aide de C_InspecteurImage.getColor();

Affichage dans le display

• L’affichage ne se programme pas. C’est Repast qui gère cette partie.
• Au moment de l’initialisation, Repast appelle la fonction getVSpatial pour chaque agent inclus au context afin de créer et d'afficher leur icône. Ensuite, c’est la fonction getColor() qui est appelée mais elle n'est utile que si on représente nos agents par des ellipses.

Schéma: Diagramme de classes de gestion des images

retour aux mémos     retour au modèle        retour à la page d'accueil