Documentation de la bibliothèque MLV-1.2.1

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.
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.
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.
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().
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().
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.
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.
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.
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.
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().
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().
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.
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.
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.
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.

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
xLa coordonnée en X de la position du coin Nord-Ouest de la boîte.
yLa coordonnée en Y de la position du coin Nord-Ouest de la boîte.
messageLe texte à afficher.
borderColorLa couleur des bordures.
sizeInterligneLa taille de l'interligne.
textColorLa couleur du texte.
backgroundColorLa couleur du fond de la boîte.
text_justificationLa justification du texte.
imageL'image sur laquel le texte doit être ecrit.
pileUne 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
xLa coordonnée en X de la position du coin Nord-Ouest de la boîte.
yLa coordonnée en Y de la position du coin Nord-Ouest de la boîte.
messageLe texte à afficher.
borderColorLa couleur des bordures.
sizeInterligneLa taille de l'interligne.
textColorLa couleur du texte.
backgroundColorLa couleur du fond de la boîte.
text_justificationLa justification du texte.
pileUne 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
xLa coordonnée en X de la position du coin Nord-Ouest de la boîte.
yLa coordonnée en Y de la position du coin Nord-Ouest de la boîte.
messageLe texte à afficher.
fontLa fonte de caractères utilisée pour dessiner le texte.
borderColorLa couleur des bordures.
sizeInterligneLe taille de l'interligne.
textColorLa couleur du texte.
backgroundColorLa couleur du fond de la boîte.
text_justificationLa justification du texte.
imageL'image sur laquel le texte doit être ecrit.
pileUne 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
xLa coordonnée en X de la position du coin Nord-Ouest de la boîte.
yLa coordonnée en Y de la position du coin Nord-Ouest de la boîte.
messageLe texte à afficher.
fontLa fonte de caractères utilisée pour dessiner le texte.
borderColorLa couleur des bordures.
sizeInterligneLa taille de l'interligne.
textColorLa couleur du texte.
backgroundColorLa couleur du fond de la boîte.
text_justificationLa justification du texte.
pileUne 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
xLa coordonnée en X de la position du coin Nord-Ouest de la boîte.
yLa coordonnée en Y de la position du coin Nord-Ouest de la boîte.
widthLa largeur de la boîte.
heightLa hauteur de la boîte.
messageLe texte à afficher.
sizeInterligneLa taille de l'interligne.
borderColorLa couleur des bordures.
textColorLa couleur du texte.
backgroundColorLa couleur du fond de la boîte.
text_justificationLa justification du texte.
horizontal_positionLa position horizontale du texte dans la boîte.
vertical_positionLa position verticale du texte dans la boîte.
imageL'image sur laquel le texte doit être ecrit.
pileUne 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
xLa coordonnée en X de la position du coin Nord-Ouest de la boîte.
yLa coordonnée en Y de la position du coin Nord-Ouest de la boîte.
widthLa largeur de la boîte.
heightLa hauteur de la boîte.
messageLe texte à afficher.
sizeInterligneLa taille de l'interligne.
borderColorLa couleur des bordures.
textColorLa couleur du texte.
backgroundColorLa couleur du fond de la boîte.
text_justificationLa justification du texte.
horizontal_positionLa position horizontale du texte dans la boîte.
vertical_positionLa position verticale du texte dans la boîte.
pileUne 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
xLa coordonnée en X de la position du coin Nord-Ouest de la boîte.
yLa coordonnée en Y de la position du coin Nord-Ouest de la boîte.
widthLa largeur de la boîte.
heightLa hauteur de la boîte.
messageLe texte à afficher.
fontLa fonte caractères utilisée pour dessiner le texte.
sizeInterligneLa taille de l'interligne.
borderColorLa couleur des bordures.
textColorLa couleur du texte.
backgroundColorLa couleur du fond de la boîte.
text_justificationLa justification du texte.
horizontal_positionLa position horizontale du texte dans la boîte.
vertical_positionLa position verticale du texte dans la boîte.
imageL'image sur laquel le texte doit être ecrit.
pileUne 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
xLa coordonnée en X de la position du coin Nord-Ouest de la boîte.
yLa coordonnée en Y de la position du coin Nord-Ouest de la boîte.
widthLa largeur de la boîte.
heightLa hauteur de la boîte.
messageLe texte à afficher.
fontLa fonte de caractères utilisée pour dessiner le texte.
sizeInterligneLa taille de l'interligne.
borderColorLa couleur des bordures.
textColorLa couleur du texte.
backgroundColorLa couleur du fond de la boîte.
text_justificationLa justification du texte.
horizontal_positionLa position horizontale du texte dans la boîte.
vertical_positionLa position verticale du texte dans la boîte.
pileUne 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
xCoordonnée en X du coin Nord-Ouest du texte
yCoordonnée en Y du coin Nord-Ouest du texte
texttexte à afficher
colorcouleur du tracé
pileUne 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
xLa coordonnée en X du coin Nord-Ouest du texte.
yLa coordonnée en Y du coin Nord-Ouest du texte.
textLe texte à afficher.
fontLa fonte de caractères utilisée pour dessiner le texte.
colorLa couleur du tracé.
imageL'image sur laquel le texte doit être ecrit.
pileUne 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
xLa coordonnée en X du coin Nord-Ouest du texte.
yLa coordonnée en Y du coin Nord-Ouest du texte.
textLe texte à afficher.
colorLa couleur du tracé.
fontLa fonte de caractères utilisée pour dessiner le texte.
pileUne 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
messageLe texte qui sera affiché lorsque vous utiliserez MLV_draw_adapted_text_box().
sizeInterligneLa taille de l'interligne.
result_widthLa largeur de la boîte que vous obtiendrez en utilisant MLV_draw_adapted_text_box().
result_heightLa hauteur de la boîte que vous obtiendrez en utilisant MLV_draw_adapted_text_box().
pileUne 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
messageLe texte qui sera affiché lorsque vous utiliserez MLV_draw_adapted_text_box_with_font().
fontLa fonte de caractères utilisée pour dessiner le texte.
sizeInterligneLa taille de l'interligne.
result_widthLa largeur de la boîte que vous obtiendrez en utilisant MLV_draw_adapted_text_box_with_font().
result_heightLa hauteur de la boîte que vous obtiendrez en utilisant MLV_draw_adapted_text_box_with_font().
pileUne 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
textLe texte qui doit être affiché.
widthLa largeur du texte.
heightLa hauteur du texte.
pileUne 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
textLe texte qui doit être affiché.
widthLa largeur du texte.
heightLa hauteur du texte.
fontLa fonte de caractères utilisée pour afficher le texte.
pileUne liste d'arguments supplémentaires