Outils pour utilisateurs
**Ceci est une ancienne révision du document !** ----
===== Allegro — 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. ==== Exemple basique ==== Ce code montre comment créer un display, nettoyer le display et attend 10 secondes. <file c main.c> #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.\\ **al_flip_display** est appelé pour imprimer l'image du buffer de dessin à l'écran. 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 secondes. **al_rest** attend en paramètre des secondes, 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#articles|Sommaire]] >> [[allegro:events|Suivant]]
