head 1.1; branch 1.1.1; access ; symbols start:1.1.1.1 PAlibDoc:1.1.1; locks ; strict; comment @# @; 1.1 date 2005.11.02.08.30.35; author jandujar; state Exp; branches 1.1.1.1; next ; 1.1.1.1 date 2005.11.02.08.30.35; author jandujar; state Exp; branches ; next ; desc @@ 1.1 log @Initial revision @ text @ PA_lib: PA API functions

PA API functions


Structures de données

struct  PAPI_all
struct  PAPI_checks
struct  PAPI_buttons
struct  PAPI_sliders

Fonctions

void PAPI_Init (bool screen)
 Initialise le systeme d'API PA... DOIT être utilisé avant tout utilisation de l'API. Ne peut être utilisé QUE sur un fond de 8 bit, ne pas oublier de le charger...
void PAPI_SetImages (bool screen, void *images, void *palette)
 Changer le set d'images utilisé par l'API... Ceci permet d'utiliser ses propres boutons, etc... J'expliquerai un peu plus tard comment utiliser tout ca correctement
void PAPI_ReInit (bool screen)
 ReInitialise le systeme d'API PA... Ceci remet à 0 les boutons, les checkbox, etc... Tout ce qu'il reste à faire c'est d'effacer l'écran
void PAPI_LoadPal (bool screen)
 Charge la palette de l'API, dans les couleurs des fonds, position 208. A utiliser à chaque fois que l'on change la palette des fonds
u8 PAPI_CreateCheck (bool screen, s16 x, s16 y, bool *var)
 Créé une nouvelle boite à cocher. Renvoie le numéro de la boite dans l'API
void PAPI_CheckCheck (void)
 Vérifie toutes les boites à cocher
u8 PAPI_CreateButton (bool screen, s16 x, s16 y, s16 lx, s16 ly, fp funct, char *text, u8 color, s8 textsize)
 Créé nouveau bouton. Renvoie le numéro du bouton dans l'API
void PAPI_CheckButton (void)
 Vérifie toutes les boutons

Variables

PAPI_checks PAPI_check [2][32]
PAPI_all PAPI_checkinfo [2]
PAPI_buttons PAPI_button [2][64]
PAPI_all PAPI_buttoninfo [2]

Description détaillée

PA API functions

Documentation des fonctions

u8 PAPI_CreateButton bool  screen,
s16  x,
s16  y,
s16  lx,
s16  ly,
fp  funct,
char *  text,
u8  color,
s8  textsize
 

Créé nouveau bouton. Renvoie le numéro du bouton dans l'API

Paramètres:
screen Ecran sur lequel charger le bouton
x Position X du coin supérieur gauche
y Position Y du coin supérieur gauche
lx Largeur, typiquement 16 ou 32, peut être n'importe quoi
ly Hauteur...
funct Fonction à charger quand le bouton est touché. Utilisation : &nomdelafonction
text Texte à afficher sur le bouton
color Couleur du texte dans la palette (0-255)
textsize Taille du texte, en général 1, mais peut être plus pour des gros boutons !!! la macro define TEXT_ALLSIZES doit être mise dans PA9.h (et install.bat réutilisé) pour activer les autres taille que 1

u8 PAPI_CreateCheck bool  screen,
s16  x,
s16  y,
bool *  var
 

Créé une nouvelle boite à cocher. Renvoie le numéro de la boite dans l'API

Paramètres:
screen Ecran sur lequel charger un checkbox
x Position X du coin supérieur gauche
y Position Y du coin supérieur gauche
var Variable de type bool à changer quand on touche la boite. Utilisation : &nomdelavariable

void PAPI_Init bool  screen  ) 
 

Initialise le systeme d'API PA... DOIT être utilisé avant tout utilisation de l'API. Ne peut être utilisé QUE sur un fond de 8 bit, ne pas oublier de le charger...

Paramètres:
screen Ecran sur lequel l'initialiser

void PAPI_LoadPal bool  screen  ) 
 

Charge la palette de l'API, dans les couleurs des fonds, position 208. A utiliser à chaque fois que l'on change la palette des fonds

Paramètres:
screen Ecran sur lequel l'initialiser

void PAPI_ReInit bool  screen  ) 
 

ReInitialise le systeme d'API PA... Ceci remet à 0 les boutons, les checkbox, etc... Tout ce qu'il reste à faire c'est d'effacer l'écran

Paramètres:
screen Ecran sur lequel l'initialiser

void PAPI_SetImages bool  screen,
void *  images,
void *  palette
 

Changer le set d'images utilisé par l'API... Ceci permet d'utiliser ses propres boutons, etc... J'expliquerai un peu plus tard comment utiliser tout ca correctement

Paramètres:
screen Ecran sur lequel l'initialiser
images Set d'images
palette Palette utilisée par le set d'images, 16 couleurs...


Généré le Fri Oct 28 23:18:13 2005 pour PA_lib par  doxygen 1.3.9.1
@ 1.1.1.1 log @Initial import of PalibDoc, begin on PAlib0.64b @ text @@