Fxlib.h : Différence entre versions

De Casio Universal Wiki
Aller à : navigation, rechercher
Ligne 251 : Ligne 251 :
  
 
La fonction affiche à la position du curseur la chaîne de caractères passée en arguments. Elle ne renvoie rien.
 
La fonction affiche à la position du curseur la chaîne de caractères passée en arguments. Elle ne renvoie rien.
 +
 +
Attention les textes trop longs ne sont pas renvoyés à la ligne ! C'est à vous de découper votre chaîne et de déplacer le curseur via la fonction locate().
 +
 +
=== PrintRev ===
 +
prototype : ''void PrintRev(const unsigned char *str);''
 +
 +
La fonction affiche à la position du curseur la chaîne de caractères passée en arguments en couleurs inversées : pixels éteints sur fond de pixels allumés. Elle ne renvoie rien.
  
 
Attention les textes trop longs ne sont pas renvoyés à la ligne ! C'est à vous de découper votre chaîne et de déplacer le curseur via la fonction locate().
 
Attention les textes trop longs ne sont pas renvoyés à la ligne ! C'est à vous de découper votre chaîne et de déplacer le curseur via la fonction locate().

Version du 22 juin 2012 à 19:40

Article en cours de rédaction !


La librairie "fxlib.h" est la librairie qui contient toutes les fonctions de bases du kit de développement de Casio pour Graph 75/85/95 (SD). Il existe d'autres librairies communautaires bien plus simples et puissantes, mais certaines fonctions de "fxlib.h" sont nécessaires, et n'ont pas d'équivalent dans les librairies non-officielles.


Fonctions d'affichage

Bdisp_PutDisp_DD

prototype : void Bdisp_PutDisp_DD(void);

Affiche à l'écran le contenu de la VRAM (buffer stockant le contenu de l'écran virtuel). Ne prend aucun argument et ne renvoie aucune valeur.


Bdisp_AllClr_DD/ Bdisp_AllClr_VRAM/ Bdisp_AllClr_DDVRAM

prototypes :

void Bdisp_AllClr_DD(void);

void Bdisp_AllClr_VRAM(void);

void Bdisp_AllClr_DDVRAM(void);

Ne prend aucun argument et ne renvoie aucune valeur.

Bdisp_AllClr_DDVRAM() efface l'écran et la VRAM. Pour effacer uniquement l'écran, utiliser Bdisp_AllClr_DD(). Pour effacer uniquement la VRAM, utiliser Bdisp_AllClr_VRAM().


Bdisp_AreaClr_DD/ Bdisp_AreaClr_VRAM/ Bdisp_AreaClr_DDVRAM

prototypes :

void Bdisp_AreaClr_DD(const DISPBOX *pArea);

void Bdisp_AreaClr_VRAM(const DISPBOX *pArea);

void Bdisp_AreaClr_DDVRAM(const DISPBOX *pArea);

La fonction ne renvoie aucune valeur.

Efface une partie de l'écran. L'argument à passer (par pointeur) à cette fonction est une structure de la forme :

typedef struct tag_DISPBOX{ // Déclarée dans dispbios.h

int left; // 0~127

int top; // 0~63

int right; // 0~127

int bottom; // 0~63

} DISPBOX;


Bdisp_AreaReverseVRAM

prototype :

void Bdisp_AreaReverseVRAM(

int x1, // coordonnée x à gauche

int y1, // coordonnée y en haut

int x2, // coordonnée x à droite

int y2 // coordonnée y en bas

);

La fonction ne renvoie aucune valeur. Inverse une zone de l'écran (pixel éteint en allumé et allumé en éteint). Passez-lui en argument les coordonnées de la zone à inverser, comme indiqué ci-dessus).


Bdisp_GetDisp_DD/ Bdisp_GetDisp_VRAM

prototypes :

void Bdisp_GetDisp_DD(unsigned char * pData);

void Bdisp_GetDisp_VRAM(unsigned char * pData);

La fonction ne renvoie aucune valeur. Elle permet de stocker dans un tableau le bitmap des écrans de la VRAM (écran virtuel) ou du DD (écran graphique). On lui passe en argument (par pointeur) le tableau où le bitmap sera stocké.

La documentation ne précise rien de plus à propos de cette fonction, si ce n'est que le tableau sur lequel est stocké le bitmap doit avoir une taille de 1024 octets. On peut donc penser que la méthode de codage utilisée par Casio est : on regroupe les pixels par groupe de 8 (un octet), où chaque bit prend la valeur d'un pixel (allumé : 1, éteint : 0). Si l'on fait le calcul : (128*64)/8 = 1024.


Bdisp_PutDispArea_DD

prototype : void Bdisp_PutDispArea_DD(const DISPBOX *pArea);

Une des plus belles erreurs de la documentation de Casio ! Dans la doc ils ont mis les explications d'une autre fonction... Cette fonction permet d'afficher à l'écran graphique une zone de l'écran virtuel. On peut tout de même deviner que cette fonction demande en argument une structure (passage par pointeur) de la forme :

typedef struct tag_DISPBOX{ // Déclarée dans dispbios.h

int left; // 0~127

int top; // 0~63

int right; // 0~127

int bottom; // 0~63

} DISPBOX;


Bdisp_SetPoint_DD/ Bdisp_SetPoint_VRAM/ Bdisp_SetPoint_DDVRAM

prototypes :

void Bdisp_SetPoint_DD(int x,int y,unsigned char point);

void Bdisp_SetPoint_VRAM(int x,int y,unsigned char point);

void Bdisp_SetPoint_DDVRAM(int x,int y,unsigned char point);

Place ou supprime un pixel aux coordonnées x et y passées en argument. Ne renvoie aucune valeur. La troisième valeur passée en argument est le type de point : 1 pour mettre un pixel, 0 pour en enlever un. La première fonction permet d'agir sur l'écran graphique, la seconde dans la VRAM, et la troisième dans les deux.


Bdisp_GetPoint_VRAM

prototype : int Bdisp_GetPoint_VRAM(int x,int y);

Retourne la couleur du pixel dont les coordonnées sont passées en argument (1 pour un pixel allumé, 0 pour un pixel éteint).


Bdisp_WriteGraph_DD/ Bdisp_WriteGraph_VRAM/ Bdisp_WriteGraph_DDVRAM

prototypes :

void Bdisp_WriteGraph_DD(const DISPGRAPH *WriteGraph);

void Bdisp_WriteGraph_VRAM(const DISPGRAPH *WriteGraph);

void Bdisp_WriteGraph_DDVRAM(const DISPGRAPH *WriteGraph);


Affiche un bitmap sur la VRAM ou l'écran (ou les deux). Ne renvoie aucune valeur. Les arguments sont passés (par pointeur) dans une structure de la forme :


typedef struct tag_DISPGRAPH { // Déclarée dans dispbios.h

int x; // coordonnée x à gauche

int y; // coordonnée y à gauche

GRAPHDATA GraphData; // pointeur sur la structure contenant les données du bitmap (voir en dessous)

WRITEMODIFY WriteModify; // type d'écriture du graphe (IMB_WRITEMODIFY_NORMAL : écriture normale et IMB_WRITEMODIFY_REVERSE : écriture inverse).

WRITEKIND WriteKind; // mode d'écriture

} DISPGRAPH;


Le mode d'écriture peut être :

OR = allumé si le pixel de l'écran OU le pixel du bitmap sont allumés

AND = allumé si le pixel de l'écran ET le pixel du bitmap sont allumés

XOR = allumé si le pixel de l'écran OU le pixel du bitmap sont allumés, MAIS PAS LES DEUX


La structure contenant les données du bitmap prend cette forme :

typedef struct tag_GRAPHDATA{ // Déclarée dans dispbios.h

int width; // largeur du bitmap

int height; // hauteur du bitmap

unsigned char *pBitmap; // pointeur sur les données du bitmap

} GRAPHDATA;

Le bitmap est codé de la manière suivante : on regroupe les pixels par groupe de 8 (un octet), où chaque bit prend la valeur d'un pixel (allumé : 1, éteint : 0).

On peut s'interroger sur l'utilité de faire des fonctions avec passage d'arguments aussi complexe, mais n'oubliez pas que nous sommes chez Casio.


Bdisp_ReadArea_DD / Bdisp_ReadArea_VRAM

prototypes :

void Bdisp_ReadArea_DD (const DISPBOX *ReadArea,unsigned char *ReadData); void Bdisp_ReadArea_VRAM (const DISPBOX *ReadArea,unsigned char *ReadData);

Cette fonction permet de stocker une zone de l'écran graphique (DD) ou de l'écran virtuel (VRAM) sur un tableau, codé de la manière suivante : on regroupe les pixels par groupe de 8 (un octet), où chaque bit prend la valeur d'un pixel (allumé : 1, éteint : 0). La fonction ne retourne rien. On lui passe en argument (par pointeur) le tableau récepteur du bitmap et une structure de la forme :


typedef struct tag_DISPBOX { // Déclarée dans dispbios.h

int left; // 0~127

int top; // 0~63

int right; // 0~127

int bottom; // 0~63

} DISPBOX;


Bdisp_DrawLineVRAM

prototype :

void Bdisp_DrawLineVRAM(

int x1, // abscisse du premier point

int y1, // ordonnée du premier point

int x2, // abscisse du second point

int y2 // ordonnée du second point

);

La fonction trace une ligne entre deux points dont les coordonnées sont entières et de la forme : (0~127;0~63). Elle ne retourne rien.


Bdisp_ClearLineVRAM

prototype :

void Bdisp_ClearLineVRAM(

int x1, // abscisse du premier point

int y1, // ordonnée du premier point

int x2, // abscisse du second point

int y2 // ordonnée du second point

);

La fonction efface une ligne entre deux points dont les coordonnées sont entières et de la forme : (0~127;0~63). Elle ne retourne rien.


locate

prototype : void locate(int x,int y);

La fonction déplace le curseur à la position spécifiée par les arguments x et y de la forme (1~21;1~8).

Chaque "case" de l'écran correspond à un rectangle de 5*7 pixels.


Print

prototype : void Print(const unsigned char *str);

La fonction affiche à la position du curseur la chaîne de caractères passée en arguments. Elle ne renvoie rien.

Attention les textes trop longs ne sont pas renvoyés à la ligne ! C'est à vous de découper votre chaîne et de déplacer le curseur via la fonction locate().

PrintRev

prototype : void PrintRev(const unsigned char *str);

La fonction affiche à la position du curseur la chaîne de caractères passée en arguments en couleurs inversées : pixels éteints sur fond de pixels allumés. Elle ne renvoie rien.

Attention les textes trop longs ne sont pas renvoyés à la ligne ! C'est à vous de découper votre chaîne et de déplacer le curseur via la fonction locate().