PAlib: PA API functions

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

# PA API functions

## Structures de données

struct | PAPI_all
struct | PAPI_checks
struct | PAPI_buttons
struct | PAPI_sliders

## Fonctions

void | PAPI_Init (u8 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 (u8 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 (u8 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 (u8 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 (u8 screen, s16 x, s16 y, u8 *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 (u8 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 | ( | u8 | 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 | ( | u8 | screen,
|  | s16 | x,
|  | s16 | y,
|  | u8 * | 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 u8 à changer quand on touche la boite. Utilisation : &nomdelavariable

void PAPI_Init | ( | u8 | 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 | ( | u8 | 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 | ( | u8 | 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 | ( | u8 | 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...