# Documentation de la bibliothèque MLV-1.2.1

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

Fonctions
Référence du fichier MLV_text_va.h

Ce fichier définit différents prototypes des fonctions permmettant d'afficher du texte et des boîtes de dialogues. Plus de détails...

Aller au code source de ce fichier.

## Fonctions
void | MLV_draw_text_va (int x, int y, const char *text, MLV_Color color, va_list pile)
| Imprime un texte donné à une position et une couleur données. Plus de détails...
void | MLV_draw_text_with_font_va (int x, int y, const char *text, const MLV_Font *font, MLV_Color color, va_list pile)
| Écrit du texte sur l'écran en utilisant une couleur et une fonte de caractères données en paramètres. Plus de détails...
void | MLV_draw_text_with_font_on_image_va (int x, int y, const char *text, const MLV_Font *font, MLV_Color color, MLV_Image *image, va_list pile)
| Écrit du texte sur une image en utilisant une couleur et une fonte de caractères données en paramètres. Plus de détails...
void | MLV_get_size_of_text_va (const char *text, int *width, int *height, va_list pile)
| Cette fonction calcule la taille du texte qui sera affiché sur l'écran à l'aide de la fonction MLV_draw_text(). Plus de détails...
void | MLV_get_size_of_text_with_font_va (const char *text, int *width, int *height, const MLV_Font *font, va_list pile)
| Cette fonction calcule la taille du texte qui sera affiché sur l'écran à l'aide de la fonction MLV_draw_text_with_font(). Plus de détails...
void | MLV_draw_adapted_text_box_with_font_va (int x, int y, const char *message, const MLV_Font *font, int sizeInterligne, MLV_Color borderColor, MLV_Color textColor, MLV_Color backgroundColor, MLV_Text_justification text_justification, va_list pile)
| Même chose que MLV_draw_adapted_text_box() mis à part que le texte est rendu avec une fonte de caractères donnée en paramètre. Plus de détails...
void | MLV_draw_adapted_text_box_va (int x, int y, const char *message, int sizeInterligne, MLV_Color borderColor, MLV_Color textColor, MLV_Color backgroundColor, MLV_Text_justification text_justification, va_list pile)
| Dessine une boîte contenant du texte. Plus de détails...
void | MLV_draw_adapted_text_box_on_image_va (int x, int y, const char *message, int sizeInterligne, MLV_Color borderColor, MLV_Color textColor, MLV_Color backgroundColor, MLV_Text_justification text_justification, MLV_Image *image, va_list pile)
| Même chose que MLV_draw_adapted_text_box() mis à part que le texte est rendu avec une fonte de caractères donnée en paramètre. Plus de détails...
void | MLV_draw_adapted_text_box_with_font_on_image_va (int x, int y, const char *message, const MLV_Font *font, int sizeInterligne, MLV_Color borderColor, MLV_Color textColor, MLV_Color backgroundColor, MLV_Text_justification text_justification, MLV_Image *image, va_list pile)
| Même chose que MLV_draw_adapted_text_box_with_font() mis à part que le texte est rendu sur une image et non directement à l'écran. Plus de détails...
int | MLV_get_size_of_adapted_text_box_va (const char *message, int sizeInterligne, int *result_width, int *result_height, va_list pile)
| Cette fonction calcule la taille de la boîte de texte qui serait obtenue si vous utilisez la fonction : MLV_draw_adapted_text_box(). Plus de détails...
int | MLV_get_size_of_adapted_text_box_with_font_va (const char *message, const MLV_Font *font, int sizeInterligne, int *result_width, int *result_height, va_list pile)
| Cette fonction calcule la taille de la boîte de texte qui serait obtenue si vous utilisez la fonction : MLV_draw_adapted_text_box_with_font(). Plus de détails...
void | MLV_draw_text_box_with_font_va (int x, int y, int width, int height, const char *message, const MLV_Font *font, int sizeInterligne, MLV_Color borderColor, MLV_Color textColor, MLV_Color backgroundColor, MLV_Text_justification text_justification, MLV_Horizontal_position horizontal_position, MLV_Vertical_position vertical_position, va_list pile)
| Même chose que la fonction MLV_draw_text_box() mis à part que le texte est rendu avec une fonte de caractères donnée en paramètre par l'utilisateur. Plus de détails...
void | MLV_draw_text_box_va (int x, int y, int width, int height, const char *message, int sizeInterligne, MLV_Color borderColor, MLV_Color textColor, MLV_Color backgroundColor, MLV_Text_justification text_justification, MLV_Horizontal_position horizontal_position, MLV_Vertical_position vertical_position, va_list pile)
| Dessine une boîte de taille donnée par l'utilisateur et contenant un texte donné par l'utilisateur. Plus de détails...
void | MLV_draw_text_box_with_font_on_image_va (int x, int y, int width, int height, const char *message, MLV_Font *font, int sizeInterligne, MLV_Color borderColor, MLV_Color textColor, MLV_Color backgroundColor, MLV_Text_justification text_justification, MLV_Horizontal_position horizontal_position, MLV_Vertical_position vertical_position, MLV_Image *image, va_list pile)
| Même chose que la fonction MLV_draw_text_box_with_font() mis à part que le texte n'est pas dessinné directement sur l'ecran, mais sur une une image. Plus de détails...
void | MLV_draw_text_box_on_image_va (int x, int y, int width, int height, const char *message, int sizeInterligne, MLV_Color borderColor, MLV_Color textColor, MLV_Color backgroundColor, MLV_Text_justification text_justification, MLV_Horizontal_position horizontal_position, MLV_Vertical_position vertical_position, MLV_Image *image, va_list pile)
| Même chose que MLV_draw_text_box() mis à part que le texte n'est pas écrit directement sur l'écran, mais sur une image à la place. Plus de détails...

## Description détaillée

Ce fichier définit différents prototypes des fonctions permmettant d'afficher du texte et des boîtes de dialogues.

Auteur
  Adrien Boussicault
  Marc Zipstein

## Documentation des fonctions

void MLV_draw_adapted_text_box_on_image_va | ( | int | x,
|  | int | y,
|  | const char * | message,
|  | int | sizeInterligne,
|  | MLV_Color | borderColor,
|  | MLV_Color | textColor,
|  | MLV_Color | backgroundColor,
|  | MLV_Text_justification | text_justification,
|  | MLV_Image * | image,
|  | va_list | pile
| ) |  |

Même chose que MLV_draw_adapted_text_box() mis à part que le texte est rendu avec une fonte de caractères donnée en paramètre.

Cette fonction est équivalente à la fonction MLV_draw_adapted_text_box_on_image() à l'exception qu'elle est apellée avec un paramètre de type va_list à la place d'une nombre variable d'arguments.

Pour plus de détail sur la fonction, aller voir la documentation de MLV_draw_adapted_text_box_on_image()

Paramètres

  x | La coordonnée en X de la position du coin Nord-Ouest de la boîte.
  y | La coordonnée en Y de la position du coin Nord-Ouest de la boîte.
  message | Le texte à afficher.
  borderColor | La couleur des bordures.
  sizeInterligne | La taille de l'interligne.
  textColor | La couleur du texte.
  backgroundColor | La couleur du fond de la boîte.
  text_justification | La justification du texte.
  image | L'image sur laquel le texte doit être ecrit.
  pile | Une liste d'arguments supplémentaires

void MLV_draw_adapted_text_box_va | ( | int | x,
|  | int | y,
|  | const char * | message,
|  | int | sizeInterligne,
|  | MLV_Color | borderColor,
|  | MLV_Color | textColor,
|  | MLV_Color | backgroundColor,
|  | MLV_Text_justification | text_justification,
|  | va_list | pile
| ) |  |

Dessine une boîte contenant du texte.

Cette fonction est équivalente à la fonction MLV_draw_adapted_text_box() à l'exception qu'elle est apellée avec un paramètre de type va_list à la place d'une nombre variable d'arguments.

Pour plus de détail sur la fonction, aller voir la documentation de MLV_draw_adapted_text_box()

Paramètres

  x | La coordonnée en X de la position du coin Nord-Ouest de la boîte.
  y | La coordonnée en Y de la position du coin Nord-Ouest de la boîte.
  message | Le texte à afficher.
  borderColor | La couleur des bordures.
  sizeInterligne | La taille de l'interligne.
  textColor | La couleur du texte.
  backgroundColor | La couleur du fond de la boîte.
  text_justification | La justification du texte.
  pile | Une liste d'arguments supplémentaires

void MLV_draw_adapted_text_box_with_font_on_image_va | ( | int | x,
|  | int | y,
|  | const char * | message,
|  | const MLV_Font * | font,
|  | int | sizeInterligne,
|  | MLV_Color | borderColor,
|  | MLV_Color | textColor,
|  | MLV_Color | backgroundColor,
|  | MLV_Text_justification | text_justification,
|  | MLV_Image * | image,
|  | va_list | pile
| ) |  |

Même chose que MLV_draw_adapted_text_box_with_font() mis à part que le texte est rendu sur une image et non directement à l'écran.

Cette fonction est équivalente à la fonction MLV_draw_adapted_text_box_with_font_on_image() à l'exception qu'elle est apellée avec un paramètre de type va_list à la place d'une nombre variable d'arguments.

Pour plus de détail sur la fonction, aller voir la documentation de MLV_draw_adapted_text_box_with_font_on_image()

Paramètres

  x | La coordonnée en X de la position du coin Nord-Ouest de la boîte.
  y | La coordonnée en Y de la position du coin Nord-Ouest de la boîte.
  message | Le texte à afficher.
  font | La fonte de caractères utilisée pour dessiner le texte.
  borderColor | La couleur des bordures.
  sizeInterligne | Le taille de l'interligne.
  textColor | La couleur du texte.
  backgroundColor | La couleur du fond de la boîte.
  text_justification | La justification du texte.
  image | L'image sur laquel le texte doit être ecrit.
  pile | Une liste d'arguments supplémentaires

void MLV_draw_adapted_text_box_with_font_va | ( | int | x,
|  | int | y,
|  | const char * | message,
|  | const MLV_Font * | font,
|  | int | sizeInterligne,
|  | MLV_Color | borderColor,
|  | MLV_Color | textColor,
|  | MLV_Color | backgroundColor,
|  | MLV_Text_justification | text_justification,
|  | va_list | pile
| ) |  |

Même chose que MLV_draw_adapted_text_box() mis à part que le texte est rendu avec une fonte de caractères donnée en paramètre.

Cette fonction est équivalente à la fonction MLV_draw_adapted_text_box_with_font() à l'exception qu'elle est apellée avec un paramètre de type va_list à la place d'une nombre variable d'arguments.

Pour plus de détail sur la fonction, aller voir la documentation de MLV_draw_adapted_text_box_with_font()

Paramètres

  x | La coordonnée en X de la position du coin Nord-Ouest de la boîte.
  y | La coordonnée en Y de la position du coin Nord-Ouest de la boîte.
  message | Le texte à afficher.
  font | La fonte de caractères utilisée pour dessiner le texte.
  borderColor | La couleur des bordures.
  sizeInterligne | La taille de l'interligne.
  textColor | La couleur du texte.
  backgroundColor | La couleur du fond de la boîte.
  text_justification | La justification du texte.
  pile | Une liste d'arguments supplémentaires

void MLV_draw_text_box_on_image_va | ( | int | x,
|  | int | y,
|  | int | width,
|  | int | height,
|  | const char * | message,
|  | int | sizeInterligne,
|  | MLV_Color | borderColor,
|  | MLV_Color | textColor,
|  | MLV_Color | backgroundColor,
|  | MLV_Text_justification | text_justification,
|  | MLV_Horizontal_position | horizontal_position,
|  | MLV_Vertical_position | vertical_position,
|  | MLV_Image * | image,
|  | va_list | pile
| ) |  |

Même chose que MLV_draw_text_box() mis à part que le texte n'est pas écrit directement sur l'écran, mais sur une image à la place.

Cette fonction est équivalente à la fonction MLV_draw_text_box_on_image() à l'exception qu'elle est apellée avec un paramètre de type va_list à la place d'une nombre variable d'arguments.

Pour plus de détail sur la fonction, aller voir la documentation de MLV_draw_text_box_on_image()

Paramètres

  x | La coordonnée en X de la position du coin Nord-Ouest de la boîte.
  y | La coordonnée en Y de la position du coin Nord-Ouest de la boîte.
  width | La largeur de la boîte.
  height | La hauteur de la boîte.
  message | Le texte à afficher.
  sizeInterligne | La taille de l'interligne.
  borderColor | La couleur des bordures.
  textColor | La couleur du texte.
  backgroundColor | La couleur du fond de la boîte.
  text_justification | La justification du texte.
  horizontal_position | La position horizontale du texte dans la boîte.
  vertical_position | La position verticale du texte dans la boîte.
  image | L'image sur laquel le texte doit être ecrit.
  pile | Une liste d'arguments supplémentaires

void MLV_draw_text_box_va | ( | int | x,
|  | int | y,
|  | int | width,
|  | int | height,
|  | const char * | message,
|  | int | sizeInterligne,
|  | MLV_Color | borderColor,
|  | MLV_Color | textColor,
|  | MLV_Color | backgroundColor,
|  | MLV_Text_justification | text_justification,
|  | MLV_Horizontal_position | horizontal_position,
|  | MLV_Vertical_position | vertical_position,
|  | va_list | pile
| ) |  |

Dessine une boîte de taille donnée par l'utilisateur et contenant un texte donné par l'utilisateur.

Cette fonction est équivalente à la fonction MLV_draw_text_box() à l'exception qu'elle est apellée avec un paramètre de type va_list à la place d'une nombre variable d'arguments.

Pour plus de détail sur la fonction, aller voir la documentation de MLV_draw_text_box()

Paramètres

  x | La coordonnée en X de la position du coin Nord-Ouest de la boîte.
  y | La coordonnée en Y de la position du coin Nord-Ouest de la boîte.
  width | La largeur de la boîte.
  height | La hauteur de la boîte.
  message | Le texte à afficher.
  sizeInterligne | La taille de l'interligne.
  borderColor | La couleur des bordures.
  textColor | La couleur du texte.
  backgroundColor | La couleur du fond de la boîte.
  text_justification | La justification du texte.
  horizontal_position | La position horizontale du texte dans la boîte.
  vertical_position | La position verticale du texte dans la boîte.
  pile | Une liste d'arguments supplémentaires

void MLV_draw_text_box_with_font_on_image_va | ( | int | x,
|  | int | y,
|  | int | width,
|  | int | height,
|  | const char * | message,
|  | MLV_Font * | font,
|  | int | sizeInterligne,
|  | MLV_Color | borderColor,
|  | MLV_Color | textColor,
|  | MLV_Color | backgroundColor,
|  | MLV_Text_justification | text_justification,
|  | MLV_Horizontal_position | horizontal_position,
|  | MLV_Vertical_position | vertical_position,
|  | MLV_Image * | image,
|  | va_list | pile
| ) |  |

Même chose que la fonction MLV_draw_text_box_with_font() mis à part que le texte n'est pas dessinné directement sur l'ecran, mais sur une une image.

Cette fonction est équivalente à la fonction MLV_draw_text_box_with_font_on_image() à l'exception qu'elle est apellée avec un paramètre de type va_list à la place d'une nombre variable d'arguments.

Pour plus de détail sur la fonction, aller voir la documentation de MLV_draw_text_box_with_font_on_image()

Paramètres

  x | La coordonnée en X de la position du coin Nord-Ouest de la boîte.
  y | La coordonnée en Y de la position du coin Nord-Ouest de la boîte.
  width | La largeur de la boîte.
  height | La hauteur de la boîte.
  message | Le texte à afficher.
  font | La fonte caractères utilisée pour dessiner le texte.
  sizeInterligne | La taille de l'interligne.
  borderColor | La couleur des bordures.
  textColor | La couleur du texte.
  backgroundColor | La couleur du fond de la boîte.
  text_justification | La justification du texte.
  horizontal_position | La position horizontale du texte dans la boîte.
  vertical_position | La position verticale du texte dans la boîte.
  image | L'image sur laquel le texte doit être ecrit.
  pile | Une liste d'arguments supplémentaires

void MLV_draw_text_box_with_font_va | ( | int | x,
|  | int | y,
|  | int | width,
|  | int | height,
|  | const char * | message,
|  | const MLV_Font * | font,
|  | int | sizeInterligne,
|  | MLV_Color | borderColor,
|  | MLV_Color | textColor,
|  | MLV_Color | backgroundColor,
|  | MLV_Text_justification | text_justification,
|  | MLV_Horizontal_position | horizontal_position,
|  | MLV_Vertical_position | vertical_position,
|  | va_list | pile
| ) |  |

Même chose que la fonction MLV_draw_text_box() mis à part que le texte est rendu avec une fonte de caractères donnée en paramètre par l'utilisateur.

Cette fonction est équivalente à la fonction MLV_draw_text_box_with_font() à l'exception qu'elle est apellée avec un paramètre de type va_list à la place d'une nombre variable d'arguments.

Pour plus de détail sur la fonction, aller voir la documentation de MLV_draw_text_box_with_font()

Paramètres

  x | La coordonnée en X de la position du coin Nord-Ouest de la boîte.
  y | La coordonnée en Y de la position du coin Nord-Ouest de la boîte.
  width | La largeur de la boîte.
  height | La hauteur de la boîte.
  message | Le texte à afficher.
  font | La fonte de caractères utilisée pour dessiner le texte.
  sizeInterligne | La taille de l'interligne.
  borderColor | La couleur des bordures.
  textColor | La couleur du texte.
  backgroundColor | La couleur du fond de la boîte.
  text_justification | La justification du texte.
  horizontal_position | La position horizontale du texte dans la boîte.
  vertical_position | La position verticale du texte dans la boîte.
  pile | Une liste d'arguments supplémentaires

void MLV_draw_text_va | ( | int | x,
|  | int | y,
|  | const char * | text,
|  | MLV_Color | color,
|  | va_list | pile
| ) |  |

Imprime un texte donné à une position et une couleur données.

Cette fonction est équivalente à la fonction MLV_draw_text() à l'exception qu'elle est apellée avec un paramètre de type va_list à la place d'une nombre variable d'arguments.

Pour plus de détail sur la fonction, aller voir la documentation de MLV_draw_text()

Paramètres

  x | Coordonnée en X du coin Nord-Ouest du texte
  y | Coordonnée en Y du coin Nord-Ouest du texte
  text | texte à afficher
  color | couleur du tracé
  pile | Une liste d'arguments supplémentaires

void MLV_draw_text_with_font_on_image_va | ( | int | x,
|  | int | y,
|  | const char * | text,
|  | const MLV_Font * | font,
|  | MLV_Color | color,
|  | MLV_Image * | image,
|  | va_list | pile
| ) |  |

Écrit du texte sur une image en utilisant une couleur et une fonte de caractères données en paramètres.

Cette fonction est équivalente à la fonction MLV_draw_text_with_font_on_image() à l'exception qu'elle est apellée avec un paramètre de type va_list à la place d'une nombre variable d'arguments.

Pour plus de détail sur la fonction, aller voir la documentation de MLV_draw_text_with_font_on_image()

Paramètres

  x | La coordonnée en X du coin Nord-Ouest du texte.
  y | La coordonnée en Y du coin Nord-Ouest du texte.
  text | Le texte à afficher.
  font | La fonte de caractères utilisée pour dessiner le texte.
  color | La couleur du tracé.
  image | L'image sur laquel le texte doit être ecrit.
  pile | Une liste d'arguments supplémentaires

void MLV_draw_text_with_font_va | ( | int | x,
|  | int | y,
|  | const char * | text,
|  | const MLV_Font * | font,
|  | MLV_Color | color,
|  | va_list | pile
| ) |  |

Écrit du texte sur l'écran en utilisant une couleur et une fonte de caractères données en paramètres.

Cette fonction est équivalente à la fonction MLV_draw_text_wih_font() à l'exception qu'elle est apellée avec un paramètre de type va_list à la place d'une nombre variable d'arguments.

Pour plus de détail sur la fonction, aller voir la documentation de MLV_draw_text_with_font()

Paramètres

  x | La coordonnée en X du coin Nord-Ouest du texte.
  y | La coordonnée en Y du coin Nord-Ouest du texte.
  text | Le texte à afficher.
  color | La couleur du tracé.
  font | La fonte de caractères utilisée pour dessiner le texte.
  pile | Une liste d'arguments supplémentaires

int MLV_get_size_of_adapted_text_box_va | ( | const char * | message,
|  | int | sizeInterligne,
|  | int * | result_width,
|  | int * | result_height,
|  | va_list | pile
| ) |  |

Cette fonction calcule la taille de la boîte de texte qui serait obtenue si vous utilisez la fonction : MLV_draw_adapted_text_box().

Cette fonction est équivalente à la fonction MLV_get_size_of_adapted_text_box() à l'exception qu'elle est apellée avec un paramètre de type va_list à la place d'une nombre variable d'arguments.

Pour plus de détail sur la fonction, aller voir la documentation de MLV_get_size_of_adapted_text_box()

Paramètres

  message | Le texte qui sera affiché lorsque vous utiliserez MLV_draw_adapted_text_box().
  sizeInterligne | La taille de l'interligne.
  result_width | La largeur de la boîte que vous obtiendrez en utilisant MLV_draw_adapted_text_box().
  result_height | La hauteur de la boîte que vous obtiendrez en utilisant MLV_draw_adapted_text_box().
  pile | Une liste d'arguments supplémentaires

Renvoie
  La fonction renvoie la taille de la boîte de texte.

int MLV_get_size_of_adapted_text_box_with_font_va | ( | const char * | message,
|  | const MLV_Font * | font,
|  | int | sizeInterligne,
|  | int * | result_width,
|  | int * | result_height,
|  | va_list | pile
| ) |  |

Cette fonction calcule la taille de la boîte de texte qui serait obtenue si vous utilisez la fonction : MLV_draw_adapted_text_box_with_font().

Cette fonction est équivalente à la fonction MLV_get_size_of_adapted_text_box_with_font() à l'exception qu'elle est apellée avec un paramètre de type va_list à la place d'une nombre variable d'arguments.

Pour plus de détail sur la fonction, aller voir la documentation de MLV_get_size_of_adapted_text_box_with_font()

Paramètres

  message | Le texte qui sera affiché lorsque vous utiliserez MLV_draw_adapted_text_box_with_font().
  font | La fonte de caractères utilisée pour dessiner le texte.
  sizeInterligne | La taille de l'interligne.
  result_width | La largeur de la boîte que vous obtiendrez en utilisant MLV_draw_adapted_text_box_with_font().
  result_height | La hauteur de la boîte que vous obtiendrez en utilisant MLV_draw_adapted_text_box_with_font().
  pile | Une liste d'arguments supplémentaires

Renvoie
  La fonction renvoie la taille de la boîte de texte.

void MLV_get_size_of_text_va | ( | const char * | text,
|  | int * | width,
|  | int * | height,
|  | va_list | pile
| ) |  |

Cette fonction calcule la taille du texte qui sera affiché sur l'écran à l'aide de la fonction MLV_draw_text().

Cette fonction est équivalente à la fonction MLV_get_size_of_text() à l'exception qu'elle est apellée avec un paramètre de type va_list à la place d'une nombre variable d'arguments.

Pour plus de détail sur la fonction, aller voir la documentation de MLV_get_size_of_text()

Paramètres

  text | Le texte qui doit être affiché.
  width | La largeur du texte.
  height | La hauteur du texte.
  pile | Une liste d'arguments supplémentaires

void MLV_get_size_of_text_with_font_va | ( | const char * | text,
|  | int * | width,
|  | int * | height,
|  | const MLV_Font * | font,
|  | va_list | pile
| ) |  |

Cette fonction calcule la taille du texte qui sera affiché sur l'écran à l'aide de la fonction MLV_draw_text_with_font().

Cette fonction est équivalente à la fonction MLV_get_size_of_text_with_font() à l'exception qu'elle est apellée avec un paramètre de type va_list à la place d'une nombre variable d'arguments.

Pour plus de détail sur la fonction, aller voir la documentation de MLV_get_size_of_text_with_font()

Paramètres

  text | Le texte qui doit être affiché.
  width | La largeur du texte.
  height | La hauteur du texte.
  font | La fonte de caractères utilisée pour afficher le texte.
  pile | Une liste d'arguments supplémentaires