Référence du fichier include/nds/arm9/PA_Text.h

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

#include "PA_BgTiles.h"
#include "text0.h"
#include "text1.h"
#include "text2.h"
#include "text3.h"
#include "text4.h"

Structures de données

struct  textborders

Macros

#define PA_InitCustomTextEx(screen, bg_select, tiles, map, pal)
#define TEXT_WHITE   0
#define TEXT_RED   1
#define TEXT_GREEN   2
#define TEXT_BLUE   3
#define TEXT_MAGENTA   4
#define TEXT_CYAN   5
#define TEXT_YELLOW   6
#define TEXT_LGRAY   7
#define TEXT_DGRAY   8
#define TEXT_BLACK   9
#define PA_SetTileLetter(screen, x, y, letter)   PA_SetMapTileAll(screen, PAbgtext[screen], x, y, (PA_textmap[screen][(u16)letter]&((1<<12)-1)) + (PAtext_pal[screen] << 12))
 Ecrire une lettre à l'écran.
#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.
#define PA_8bitCustomFont(bit8_slot, bit8_font)
 Ajouter une police perso dans le systeme de texte 8bit !! Doit être convertie avec PAGfx.
#define PA_SmartText   PA_8bitText

Définition de type

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

Fonctions

const unsigned short
PA_text_Map[768] 
__attribute__ ((aligned(4)))
void PA_CreateTextPal (u8 screen, u8 pal_number, u16 r, u16 g, u16 b)
void PA_PrintYPlus (u8 screen)
void PA_InitText (u8 screen, u8 bg_select)
 Ecrire du texte à l'écran. Ne marche qu'en modes 0-2.
void PA_SetTextTileCol (u8 screen, u8 color)
 Change la couleur du texte à écrire (ne change pas la couleur du texte déjà écrit).
void PA_OutputText (u8 screen, u16 x, u16 y, char *text,...)
 Ecrire du texte à l'écran. Ne marche qu'en modes 0-2.
u16 PA_OutputSimpleText (u8 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 (u8 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 (u8 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 (u8 screen, u16 r, u16 g, u16 b)
 Changer la couleur de base du texte à l'écran.
s16 PA_8bitText (u8 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_16bitText (u8 screen, s16 basex, s16 basey, s16 maxx, s16 maxy, char *text, u16 color, u8 size, u8 transp, s32 limit)
s16 PA_CenterSmartText (u8 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é...
void PA_CopyText (char *text1, char *text2)
 Comparer une chaine de caractère à une autre. Exemple : PA_CompareText(Playname, "Mollusk");.
void PA_InitTextBorders (u8 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 (u8 screen)
 Efface le text d'un boite à texte... Nécessite qu'il ait été initialisé avec PA_InitTextBorders.
u32 PA_SimpleBoxText (u8 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 (u8 screen)
 Effacer tout le texte sur un écran donné.
void PA_Print (u8 screen, char *text,...)
 Ecrire du texte à l'écran. Marche comme la fonction printf.
void PA_PrintLetter (u8 screen, char letter)
 Comme PA_Print, mais juste pour une lettre.
void PA_OutputTextSpecial0 (u8 screen, int x1, int y, char *text)
void PA_OutputTextSpecial1 (u8 screen, int x1, int y, char *text)
void PA_OutputTextSpecial2 (u8 screen, int x1, int y, char *text)
void PA_OutputTextSpecial3 (u8 screen, int x1, int y, char *text)
void PA_OutputTextSpecial4 (u8 screen, int x1, int y, char *text)
void PA_OutputTextSpecial5 (u8 screen, int x1, int y, char *text)

Variables

const int PA_text_Info [3]
u8 * bit8_tiles [10]
u32 pa_printx [2]
u32 pa_printy [2]
s16 pa_printscroll [2]
u16 textcol [2]
u8 PAbgtext [2]
u16 * PA_textmap [2]
u8 * PA_texttiles [2]
u16 * PA_textpal [2]
s8 PA_font [2]
const u8 * textData [10]
u8 policeheight [10]
u16 policewidth [10]
u8 * policesize [10]
u8 * text_tiles [10]
u16 * text_maps [10]
u8 * pa8bitdefaultsize [10]
u8 police8bitheight [10]
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 macros

#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);   }

#define PA_SmartText   PA_8bitText

#define TEXT_BLACK   9

#define TEXT_BLUE   3

#define TEXT_CYAN   5

#define TEXT_DGRAY   8

#define TEXT_GREEN   2

#define TEXT_LGRAY   7

#define TEXT_MAGENTA   4

#define TEXT_RED   1

#define TEXT_WHITE   0

#define TEXT_YELLOW   6


Documentation des définition de type

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

typedef void(* letterfp16bit)(u8 size, u8 screen, u16 x, u16 y, char lettertemp, u16 color)


Documentation des fonctions

const unsigned short PA_text_Map [768] __attribute__ ( (aligned(4))   ) 

void PA_CreateTextPal ( u8  screen,
u8  pal_number,
u16  r,
u16  g,
u16  b 
)

void PA_PrintYPlus ( u8  screen  ) 


Documentation des variables

u8* bit8_tiles[10]

s8 PA_font[2]

u32 pa_printx[2]

u32 pa_printy[2]

const int PA_text_Info[3]

u16* PA_textmap[2]

u16* PA_textpal[2]

u8* PA_texttiles[2]

u8 PAbgtext[2]

u16 PAtext_pal[2]

u8 policeheight[10]

u8* policesize[10]

u16 policewidth[10]

u16* text_maps[10]

u8* text_tiles[10]

u16 textcol[2]

const u8* textData[10]


Généré le Sat Jun 13 12:56:59 2009 pour PAlib - Programmer's Arsenal par  doxygen 1.5.8