PAlib: Référence du fichier PA_Text.h

Page principale | Modules | Liste des fichiers | Portée globale | Rechercher

# Référence du fichier PA_Text.h

Text system in tile mode. Plus de détails...

Aller au code source de ce fichier.

## Structures de données

struct | textborders

## Macros

#define | PA_InitCustomTextEx(screen, bg_select, tiles, map, pal)
#define | PA_InitCustomText(screen, bg_select, text) PA_InitCustomTextEx(screen, bg_select, text##_Tiles, text##_Map, text##_Pal)
| Initialiser le texte en utilisant une police perso
#define | PA_ShowFont(screen) PA_LoadBgMap(screen, PAbgtext[screen], (void*)PA_textmap[screen], BG_256X256)
| Affiche la police utilisée. C'est juste utile pour du débuggage, aucun intéret autrement

## Typedefs

typedef void(* | letterfp )(u8 size, bool screen, u16 x, u16 y, char lettertemp, u8 color)

## Fonctions

void | PA_CreateTextPal (bool screen, u8 pal_number, u16 r, u16 g, u16 b)
void | PA_InitText (bool screen, u8 bg_select)
| Ecrire du texte à l'écran. Ne marche qu'en modes 0-2
void | PA_SetTileLetter (bool screen, u16 x, u16 y, char letter)
| Ecrire une lettre à l'écran.
void | PA_SetTextTileCol (bool screen, u8 color)
| Change la couleur du texte à écrire (ne change pas la couleur du texte déjà écrit)
void | PA_OutputText (bool screen, u16 x, u16 y, char *text,...)
| Ecrire du texte à l'écran. Ne marche qu'en modes 0-2
u16 | PA_OutputSimpleText (bool screen, u16 x, u16 y, const char *text)
| Ecrire du texte tout simple à l'écran. Ne marche qu'en modes 0-2. Beaucoup plus rapide que PA_OutputText, masi aussi beaucoup plus limité... Renvoie le nombre de lettres
u32 | PA_BoxText (bool screen, u16 basex, u16 basey, u16 maxx, u16 maxy, const char *text, u32 limit)

Permet d'écrire du texte à l'écran, dans une boite délimitée au choix, et en choisissant le nombre de lettres à afficher (peut être utile pour afficher du texte en train de se taper, sinon suffit de mettre 10000 pour afficher tout d'un coup) Renvoie le nmobre de lettre écrites

u32 | PA_BoxTextNoWrap (bool screen, u16 basex, u16 basey, u16 maxx, u16 maxy, const char *text, u32 limit)

Permet d'écrire du texte à l'écran, dans une boite délimitée au choix, et en choisissant le nombre de lettres à afficher (peut être utile pour afficher du texte en train de se taper, sinon suffit de mettre 10000 pour afficher tout d'un coup) Renvoie le nombre de lettre écrites. Cette fonction coupe les mots...

void | PA_SetTextCol (bool screen, u16 r, u16 g, u16 b)
| Changer la couleur de base du texte à l'écran
s16 | PA_SmartText (bool screen, s16 basex, s16 basey, s16 maxx, s16 maxy, char *text, u8 color, u8 size, u8 transp, s32 limit)

Cette fonction permet d'écrire du texte à chasse variable à l'écran. Elle nécessite d'avoir un fond dessinable de 8 bits (cf PA_Init8bitBg). Les options sont la taille, la transparence, et les limites, ainsi que la couleur. Seul inconvénient : il n'accepte pas les commande comme d, etc... La fonction renvoie le nombre de charactères écrits

s16 | PA_CenterSmartText (bool screen, s16 basex, s16 basey, s16 maxx, s16 maxy, char *text, u8 color, u8 size, u8 transp)
| En gros la meme chose que SmartText, mais en centré...
bool | PA_CompareText (char *text1, char *text2)
| Comparer une chaine de caractère à une autre. Exemple : PA_CompareText(Playname, "Mollusk");
void | PA_CopyText (char *text1, char *text2)
| Comparer une chaine de caractère à une autre. Exemple : PA_CompareText(Playname, "Mollusk");
void | PA_InitTextBorders (bool screen, u8 x1, u8 y1, u8 x2, u8 y2)
| Initialise une boite à texte, avec la bordure. Ceci rend l'utilisation des textes délimités bien plus simple
void | PA_EraseTextBox (bool screen)
| Efface le text d'un boite à texte... Nécessite qu'il ait été initialisé avec PA_InitTextBorders
u32 | PA_SimpleBoxText (bool screen, const char *text, u32 limit)
| Ecrit du texte dans une zone délimitée. Similaire à PA_BoxText, mais sans avoir besoin de délimiter
void | PA_ClearTextBg (bool screen)
| Effacer tout le texte sur un écran donné
void | PA_OutputTextSpecial0 (bool screen, int x1, int y, char *text)
void | PA_OutputTextSpecial1 (bool screen, int x1, int y, char *text)
void | PA_OutputTextSpecial2 (bool screen, int x1, int y, char *text)
void | PA_OutputTextSpecial3 (bool screen, int x1, int y, char *text)
void | PA_OutputTextSpecial4 (bool screen, int x1, int y, char *text)
void | PA_OutputTextSpecial5 (bool screen, int x1, int y, char *text)

## Variables

u16 | textcol [2]
u8 | PAbgtext [2]
u16 * | PA_textmap [2]
u8 * | PA_texttiles [2]
u16 * | PA_textpal [2]
s8 | PA_font [2]
letterfp | letters [5]
u16 | PAtext_pal [2]
textborders | PA_TextBox [2]

## Description détaillée

Text system in tile mode.

Not much to say, just a good debug option...

## Documentation des macro

#define PA_InitCustomTextEx | ( | screen,
|  | bg_select,
|  | tiles,
|  | map,
|  | pal |  | ) |

Valeur:

    {\
       PAbgtext[screen] = bg_select;\
       PA_LoadSimpleBg(screen, bg_select, tiles, Blank, BG_256X256, 0, 1);\
       PA_LoadBgPal(screen, bg_select, (void*)pal);\
       PA_textmap[screen] = (u16*)map;PA_textpal[screen] = (u16*)pal;PAtext_pal[screen]=0;\
       u32 PAtexttempvar = 0; for (PAtexttempvar = 0; PAtexttempvar < 32*24; PAtexttempvar++) PA_SetTileLetter(screen, PAtexttempvar, 0, 0);   }