# Documentation de la bibliothèque MLV-1.2.1

- Presentation
- Téléchargement
- Installation
- Compilation
- Exemples
- API
- Liste des fonctions
- bogues
- FAQ
- contacts

Énumérations | Fonctions
Référence du fichier MLV_mouse.h

Ce fichier définit les prototypes des fonctions qui permettent d'utiliser la souris. Plus de détails...

Aller au code source de ce fichier.

## Énumérations
enum | MLV_Mouse_button { MLV_BUTTON_LEFT = SDL_BUTTON_LEFT, MLV_BUTTON_MIDDLE = SDL_BUTTON_MIDDLE, MLV_BUTTON_RIGHT = SDL_BUTTON_RIGHT }
| Énumère les différents bouttons de la souris. Plus de détails...

## Fonctions
void | MLV_wait_mouse (int *x, int *y)
| Suspend l'exécution jusqu'à ce que l'utilisateur clique sur le bouton gauche de la souris. Plus de détails...
int | MLV_wait_mouse_or_seconds (int *x, int *y, int seconds)
| Suspend l'exécution jusqu'à ce que l'utilisateur clique sur le bouton gauche de la souris où jusqu'à ce qu'un nombre de secondes, passé en paramètres, se soient écoulées. Plus de détails...
const char * | MLV_convert_mouse_button_to_string (MLV_Mouse_button button_code)
| Convertit le code associé à un boutton de la souris (MLV_Mouse_button) en chaîne de caratères. Plus de détails...
MLV_Mouse_button | MLV_convert_string_to_mouse_button (const char *button_string)
| Convertit une chaîne de caractères en un code bouton. Plus de détails...
void | MLV_get_mouse_position (int *x, int *y)
| Renvoie la position courante de la souris. Plus de détails...
MLV_Button_state | MLV_get_mouse_button_state (MLV_Mouse_button mouse_button)
| Renvoie l'état (préssé ou relaché) d'un bouton de la souris. Plus de détails...

## Description détaillée

Ce fichier définit les prototypes des fonctions qui permettent d'utiliser la souris.

Auteur
  Adrien Boussicault
  Marc Zipstein

## Documentation du type de l'énumération

enum MLV_Mouse_button

Énumère les différents bouttons de la souris.

Valeurs énumérées
MLV_BUTTON_LEFT | Bouton gauche de la souris
MLV_BUTTON_MIDDLE | Bouton du milieu de la souris
MLV_BUTTON_RIGHT | Bouton droit de la souris

## Documentation des fonctions

const char* MLV_convert_mouse_button_to_string | ( | MLV_Mouse_button | button_code) |  |

Convertit le code associé à un boutton de la souris (MLV_Mouse_button) en chaîne de caratères.

Paramètres

  button_code | Le code du bouton.

Renvoie
  La chaîne de caratères correspondant au code du boutton de la souris passé en paramètre.

MLV_Mouse_button MLV_convert_string_to_mouse_button | ( | const char * | button_string) |  |

Convertit une chaîne de caractères en un code bouton.

Paramètres

  button_string | La chaîne de caractères à convertir.

Renvoie
  Le code bouton associé à la chaîne de caractères.

MLV_Button_state MLV_get_mouse_button_state | ( | MLV_Mouse_button | mouse_button) |  |

Renvoie l'état (préssé ou relaché) d'un bouton de la souris.

Paramètres

  mouse_button | Le code du bouton de la souris

Renvoie
  L'état du bouton.

Exemples:
  medium/10_mouse_or_keyboard_access.c.

void MLV_get_mouse_position | ( | int * | x,
|  | int * | y
| ) |  |

Renvoie la position courante de la souris.

Paramètres

  x | Coordonnée en X de la position de la souris dans la fenêtre.
  y | Coordonnée en Y de la position de la souris dans la fenêtre.

Exemples:
  medium/10_mouse_or_keyboard_access.c.

void MLV_wait_mouse | ( | int * | x,
|  | int * | y
| ) |  |

Suspend l'exécution jusqu'à ce que l'utilisateur clique sur le bouton gauche de la souris.

Au moment où l'utilisateur clique, la fonction retourne les coordonnées de la position de la souris dans la fenêtre.

Paramètres

  x | Coordonnée en X de la position de la souris dans la fenêtre.
  y | Coordonnée en Y de la position de la souris dans la fenêtre.

Exemples:
  beginner/05_mouse.c, et beginner/09_colors.c.

int MLV_wait_mouse_or_seconds | ( | int * | x,
|  | int * | y,
|  | int | seconds
| ) |  |

Suspend l'exécution jusqu'à ce que l'utilisateur clique sur le bouton gauche de la souris où jusqu'à ce qu'un nombre de secondes, passé en paramètres, se soient écoulées.

Au moment où l'utilisateur clique, la fonction retourne les coordonnées de la position de la souris dans la fenêtre.

Paramètres

  x | Coordonnée en X de la position de la souris dans la fenêtre.
  y | Coordonnée en Y de la position de la souris dans la fenêtre.
  seconds | Le nombre de second à attendre avant de quitter la fonction.

Renvoie
  Renvoie 1 si l'utilisateur a cliqué avec le bouton gauche de la souris, et 0 si le temps s'est écoulé.

Exemples:
  beginner/08_mouse_keyboard_timer.c.