Documentation de la bibliothèque MLV-3.1.0

medium/01_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 bibliothèque MLV :

À chaque fois qu'un utilisateur déplace la sourris, appuie sur les touches d'un clavier, ou entre du texte dans une boîte de saisie, un événèment est créé par la bibliothèque 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>
//
// Fonction qui s'occupe de l'affichage de la démonstration.
//
void affichage( int nb, int width, int height ){
//
// Nettoie l'écran pour un nouvel affichage
//
//
// Affiche la consigne
//
10, 10,
"Appuyer sur shift+k et relâcher uniquement la touche k pour quitter !",
);
//
// Affiche le nombre de fois qu'une touche a été appuyée depuis le debut
// du programme.
//
10, 40,
"Nombre de fois que l'on a appuyé sur une touche : %i",
nb
);
//
// Met à jour la fenêtre
//
}
//
// 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
// informations conernant les évènements de typeclavier.
// Variable contenant le code associé au type d'un évènement.
MLV_Event event;
//
// Créé et affiche la fenêtre
//
"medium - 1 - keyboard events", "keyboard events", width, height
);
//
// Met a jour l'affichage
//
affichage( nb, width, height );
//
// On compte le nombre de fois que l'utilisateur a appuyé sur une
// touche.
// On s'arrête quand la touche q a été rélachée suite à une combinaison
// shift+q.
//
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_k ) &&
( state == MLV_RELEASED )
)
);
//
// Ferme la fenêtre
//
return 0;
}
/*
* This file is part of the MLV Library.
*
* Copyright (C) 2010,2011,2012,2013 Adrien Boussicault, Marc Zipstein
*
*
* This Library is free software: you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version.
*
* This Library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this Library. If not, see <http://www.gnu.org/licenses/>.
*/
MLV_create_window
void MLV_create_window(const char *window_name, const char *icone_name, unsigned int width, unsigned int height)
Créé une fenêtre dont la taille, et les différents noms sont passés en paramètres.
MLV_Event
MLV_Event
Énumère les différents types d'évènement de la bibliothèque MLV.
Definition: MLV_event.h:46
MLV_get_event
MLV_Event MLV_get_event(MLV_Keyboard_button *key_sym, MLV_Keyboard_modifier *key_mod, int *unicode, char **texte, MLV_Input_box **input_box, int *mouse_x, int *mouse_y, MLV_Mouse_button *mouse_button, MLV_Button_state *state)
Cette fonction récupère un évènement dans la file d'attente, remplit en fonction de l'évènement récup...
MLV_Keyboard_button
MLV_Keyboard_button
Énumère l'ensemble des codes des touches du clavier.
Definition: MLV_keyboard.h:50
MLV_free_window
void MLV_free_window()
Ferme la fenêtre de la bibliothèque MLV.
MLV_update_window
void MLV_update_window()
Met à jour l'affichage de la fenêtre.
MLV_draw_text
void MLV_draw_text(int x, int y, const char *text, MLV_Color color,...)
Imprime un texte donné à une position et une couleur données.
MLV_RELEASED
@ MLV_RELEASED
Definition: MLV_device_with_buttons.h:45
MLV_KEY
@ MLV_KEY
Definition: MLV_event.h:48
MLV_COLOR_GREEN
#define MLV_COLOR_GREEN
Definition: MLV_color.h:931
MLV_all.h
Fichier d'entête principal incluant tous les autres fichiers entêtes de la bibliothèque MLV.
MLV_clear_window
void MLV_clear_window(MLV_Color color)
Éfface la fenêtre et la remplace par un monochrome de la couleur donnée en paramètre.
MLV_PRESSED
@ MLV_PRESSED
Definition: MLV_device_with_buttons.h:44
MLV_Keyboard_modifier
MLV_Keyboard_modifier
Énumère l'ensemble des codes associées aux différents modes du clavier.
Definition: MLV_keyboard.h:299
MLV_shift_key_was_pressed
int MLV_shift_key_was_pressed(MLV_Keyboard_modifier modifier_code)
Renvoie vrai si le code, passé en paramètre, correspond à l'état appuyé de la touche de combinaison s...
MLV_Button_state
MLV_Button_state
Énumère les différents états possibles d'un bouton.
Definition: MLV_device_with_buttons.h:43
MLV_COLOR_BLACK
#define MLV_COLOR_BLACK
Definition: MLV_color.h:379