Mr-Hide's Wiki

Cette page est en lecture seule. Vous pouvez afficher le texte source, mais ne pourrez pas le modifier. Contactez votre administrateur si vous pensez qu'il s'agit d'une erreur.
===== Displays =====

Dans cet article nous détaillerons un exemple simple sur la création d'un display et la définition de paramètres pour ce display.

==== Basic Example ====

Ce code montre comment créer un display, nettoyer le display et attend 10 secondes.

=== Code ===
<file c main>
#include <stdio.h>
#include <allegro5/allegro.h>

int main(int argc, char **argv)
{
   ALLEGRO_DISPLAY *display = NULL;

   if(!al_init()) {
      fprintf(stderr, "failed to initialize allegro!\n");
      return -1;
   }

   display = al_create_display(640, 480);
   if(!display) {
      fprintf(stderr, "failed to create display!\n");
      return -1;
   }

   al_clear_to_color(al_map_rgb(0,0,0));
   
   al_flip_display();

   al_rest(10.0);

   al_destroy_display(display);

   return 0;
}
</file>

=== Détails ===

<code c>#include <stdio.h>
#include <allegro5/allegro.h></code>

**stdio.h** est nécessaire pour la fonction **fprintf** et **allegro5/allegro.h** est nécessaire pour utiliser allegro !

<code c>int main(int argc, char **argv)
{</code>

Une fonction **main** standard avec le nombre et le tableau de ses paramètres.

<code c>if(!al_init()) {
      fprintf(stderr, "failed to initialize allegro!\n");
      return -1;
}</code>

Ici on initialise la lib allegro. En cas d'échec cette fonction renvoit **false** et un message est affiché sur stderr.

<code c>display = al_create_display(640, 480);</code>

**al_create_display** crée un display avec la taille spécifiée. En cas d'échec cette fonction renvoi **NULL**.

<code c>al_clear_to_color(al_map_rgb(0,0,0));</code>

**al_map_rgb** attend 3 paramètres, les valeurs pour les composantes rouge, verte et bleu de la couleur voulue, elle renvoi une structure **ALLEGRO_COLOR**.
**al_clear_to_color** efface le display //celui que l'on vient juste de créer// avec la couleur donnée.

<code c>al_flip_display();</code>

Par défaut Allegro crée deux buffers image -- celui affiché sur l'écran, et celui sur lequel on dessine. Une fois que vous avez fini de dessiner sur le buffer, vous êtes prêt à afficher le résultat sur l'écran. <code>al_flip_display</code> est appelé pour échanger les deux buffer image de manière à ce que le 1<sup>er</sup> soit affiché à l'écran et le 2<sup>ème</sup> devienne celui sur lequel on dessine. l'échec de l'appel à cette fonction affichera une fenêtre blanche.

<code c>al_rest(10.0);</code>

Ici on demande au programme d'attendre pendant 10 seconde. **al_rest** attend en paramètre des seconds, Néanmoins selon l'environnement cette fonction aura une précision jusqu'à une dizaine de milliseconde.

<code c>al_destroy_display(display);</code>

Cette fonction détruit notre display et libère la mémoire, elle doit être appelée quand vous vous apprêtez à fermer le programme.

C'est la fin de notre introduction aux displays avec Allegro 5.

[[allegro:start|Sommaire]] >> [[allegro:events|suite]]
Mr-Hide's Wiki

Outils pour utilisateurs

Outils du site

Outils de la page
