Documentation de la bibliothèque MLV-0.5

medium/1_keyboard_events.c

Ce programme montre comment il est possible de récupérer des informations provenant de l'utilisateur lorsqu'il utilise son clavier sans bloquer l'exécution du programme.

Pour cela il utilise le système d'évènements de la librairie MLV :

À chaque fois qu'un utilisateur déplace la sourris, appuie sur les touches d'un clavier, ou entre du texte dans un prompt, un événèment est créé par la librairie MLV. Cet évènement est placé dans une file d'attente. Il est possible de récupérer toutes les informations concernant ces évènements en appelant la fonction MLV_get_event(). Cette fonction supprime le dernier évènement de la pile, l'analyse et renvoie, à l'aide de ses paramètres et de sa valeur de retour, toutes les informations le concernant.

#include <MLV/MLV_all.h>
#include <stdio.h>

#define TAILLE_MESSAGE 100

//
// Fonction qui s'occupe de l'affichage de la démonstration.
//
void affichage( int nb, int width, int height ){
        //
        // Déclaration de l'espace mémoire associé au message.
        //
        char message[TAILLE_MESSAGE];

        //
        // Nettoie l'écran pour un nouvel affichage
        //
        MLV_draw_filled_rectangle(
                0, 0, width, height, MLV_COLOR_BLACK
        );

        //
        // Affiche la consigne
        //
        MLV_draw_text(
                10, 10,
                "Appuyer sur   q    pour quitter !",
                MLV_COLOR_GREEN
        );

        //
        // Affiche le nombre de fois qu'une touche a été appuyée depuis le debut
        // du programme.
        //
        snprintf(
                message, TAILLE_MESSAGE, 
                "Nombre de fois que l'on a appuyé sur une touche : %i",
                nb
        );
        MLV_draw_text( 10, 40, message, MLV_COLOR_GREEN );

        //
        // Met à jour la fenêtre
        //
        MLV_actualise_window();
}


//
// Attention ! 
// Pour pouvoir compiler ce programme sous windows et sous macintosh, il faut, 
// pour la déclaration du main, respecter strictement la syntaxe suivante :
//
int main(int argc, char *argv[]){
        int width = 640, height = 460;    //Taille de la fenêtre
        int nb= 0 ;             // Nombre de fois qu'une touche a été appuyée
        int sym, mod, state;    // informations conernant les évènements de type
                                // clavier.
        MLV_Event event;        // Variable contenant le code associé au type
                                // d'un évènement.
        
        //
        // Créé et affiche la fenêtre
        //
        MLV_create_window(
                "medium - 1 - keyboard events", "keyboard events", width, height
        );

        //
        // Met a jour l'affichage
        //
        affichage( nb, width, height );

        //
        // Tant que la touche q n'a pas été appuyée,
        // on compte le nombre de fois que l'utilisateur a appuyé sur une
        // touche.
        //
        do {
                //
                // Récupère un évènement dans la file des évènements
                // non traités.
                //
                event = MLV_get_event( 
                        &sym, &mod, NULL, 
                        NULL, NULL,
                        NULL, NULL, NULL,
                        &state
                );

                //
                // Traite l'évènement s'il s'agit d'un évènement clavier
                //
                if( event == MLV_KEY ){
                        //
                        // Compte le nombre de fois qu'une touche a été
                        // préssée.
                        //
                        if( state == MLV_PRESSED ){
                                nb ++;
                        }

                        //
                        // Met à jour l'affichage
                        //
                        affichage( nb , width, height );
                };
        } while( !( ( sym == MLV_KEYBOARD_q ) && ( state == MLV_RELEASED ) ) );

        //
        // Ferme la fenêtre
        //
        MLV_free_window();
        return 0;
}