Module moteur_graphiqueSummary | | | Ce module permet la réalisation d’application graphique en mode double buffering. | | Type abstrait de donnée couleur utilisé dans les surfaces | | | | Permet la création d’une couleur RGB en fonction d’une surface, il y a dependances à cause notamment de différence entre une surface 32 ou 16 bits par exemple. | | Les copies de surface se réalise à partir de ce type abstrait | | | | Permet d’initialiser un rectangle à une certaine position et d’une certaine taille | | | | | | Permet de charger une police TTF à une certaine taille | | Permet la déstruction d’une font | | Ce type abstrait est une surface graphique se trouvant en mémoire vidéo. | | | | Permet la création d’une surface d’une certaine taille, la surface est en 32 bits. | | Permet d’écrire à une certaine position d’une surface une couleur | | Permet de copier une surface vers une autre à certaines positions et à certaine taille | | Ecrit un texte dans une surface et renvoit la surface correspondante, la surface est allouée automatiquement | | Permet de charger un fichier BMP du disque dur directement dans un type surface Les tailles de la surface sont automatiquement écrite, la mémoire est automatiquement allouée. | | Permet d’effacer toutes les couleurs de la surface par un rectangle noir recouvrant le tout | | Permet de détruire une surface que l’on a alloué par g_surfaceCreer ou g_surfaceCharger | | Ce type abstrait de donné est la fenetre principale graphique de l’application. | | | | Permet l’initialisation d’une G_fenetre en fonction de resolution et d’un mode plein écran ou non | | Permet de récuperer la surface graphique d’une fenetre | | Permet d’afficher la fenetre à l’écran. | | |
Documentation du module moteur_graphiqueCe module permet la réalisation d’application graphique en mode double buffering. Il est compatible sous tous les systèmes Windows, Linux, UNIX, Mac
couleurType abstrait de donnée couleur utilisé dans les surfaces Summary | | | Permet la création d’une couleur RGB en fonction d’une surface, il y a dependances à cause notamment de différence entre une surface 32 ou 16 bits par exemple. |
g_couleurCreerG_couleur g_couleurCreer( | G_surface | * | surface, | | int | | R, | | int | | G, | | int | | B | ) |
|
Permet la création d’une couleur RGB en fonction d’une surface, il y a dependances à cause notamment de différence entre une surface 32 ou 16 bits par exemple. Paramètressurface | la couleur est définie selon la surface | R | niveau de rouge (entre 0 et 255) | G | niveau de vert (entre 0 et 255) | B | niveau de bleu (entre 0 et 255) |
RetourLa couleur de niveau RGB PréconditionR, G et B doivent être entre 0 et 255
rectangleLes copies de surface se réalise à partir de ce type abstrait Summary | | | Permet d’initialiser un rectangle à une certaine position et d’une certaine taille |
g_rectangleInitialiservoid g_rectangleInitialiser( | G_rectangle | * | rect, | | int | | x, | | int | | y, | | int | | w, | | int | | h | ) |
|
Permet d’initialiser un rectangle à une certaine position et d’une certaine taille Paramètresx | position horizontale | y | position verticale | w | taille horizontale | h | taille verticale |
fontLe type abstrait font Summary | | | Permet de charger une police TTF à une certaine taille | | Permet la déstruction d’une font |
g_fontChargerG_font* g_fontCharger( | char | * | fichier, | | int | | taille | ) |
|
Permet de charger une police TTF à une certaine taille Paramètresfichier | le fichier du disque dur au format TTF | taille | la taille de la police voulue |
RetourRenvoit un pointeur de type G_font correpondant au font chargé ErreurSi le fichier n’est pas trouvé, NULL est retourné
g_fontDetruirevoid g_fontDetruire( | G_font | * | font | ) |
|
Permet la déstruction d’une font Paramètrefont | la font que l’on souhaite détruire |
G_surfaceCe type abstrait est une surface graphique se trouvant en mémoire vidéo. Il est similaire à une image Summary | | | Permet la création d’une surface d’une certaine taille, la surface est en 32 bits. | | Permet d’écrire à une certaine position d’une surface une couleur | | Permet de copier une surface vers une autre à certaines positions et à certaine taille | | Ecrit un texte dans une surface et renvoit la surface correspondante, la surface est allouée automatiquement | | Permet de charger un fichier BMP du disque dur directement dans un type surface Les tailles de la surface sont automatiquement écrite, la mémoire est automatiquement allouée. | | Permet d’effacer toutes les couleurs de la surface par un rectangle noir recouvrant le tout | | Permet de détruire une surface que l’on a alloué par g_surfaceCreer ou g_surfaceCharger |
g_surfaceCreerG_surface* g_surfaceCreer( | int | x, | | int | y | ) |
|
Permet la création d’une surface d’une certaine taille, la surface est en 32 bits. Paramètresx | taille horizontale de la surface souhaitée | y | taille verticale de la surface souhaitée |
RetourRetourne un pointeur vers la surface qui a été allouée ErreurSi la fonction n’a pas réussi à allouer la mémoire pour la surface, NULL est renvoyé
g_surfaceEcrireCouleurvoid g_surfaceEcrireCouleur( | G_surface | * | surface, | | int | | x, | | int | | y, | | G_couleur | | couleur | ) |
|
Permet d’écrire à une certaine position d’une surface une couleur Paramètressurface | la surface ou l’on souhaite écrire | x | la position horizontale | y | la position verticale | couleur | la couleur que l’on souhaite écrire |
g_surfaceCopievoid g_surfaceCopie( | G_surface | * | surface1, | | G_rectangle | * | rect1, | | G_surface | * | surface2, | | G_rectangle | * | rect2 | ) |
|
Permet de copier une surface vers une autre à certaines positions et à certaine taille Paramètressurface1 | la surface source | rect1 | le rectangle contient les origines et les longueurs que l’on souhaite copier | surface2 | la surface destination | rect2 | le rectangle contient les origines et les longueurs de l’endroit que l’on souhaite copier |
Si l’on souhaite copier toute la surface source, on peut plaçer rect1 à NULL, si l’on souhaite uniquement placé la source dans la destination à une certaine position sans se soucier des tailles, il suffit d’initialiser un rectangle avec les tailles à 0
g_surfaceEcrireTexteG_surface* g_surfaceEcrireTexte( | G_font | * | font, | | char | * | texte, | | G_couleur | | couleur_texte, | | G_couleur | | couleur_fond | ) |
|
Ecrit un texte dans une surface et renvoit la surface correspondante, la surface est allouée automatiquement Paramètresfont | le font de police que l’on souhaite | texte | le texte que l’on souhaite écrire | couleur_texte | la couleur du texte | couleur_font | la couleur du fond |
RetourRetourne une surface contenant le texte aux couleurs indiqués et au font précisé
g_surfaceChargerBMPG_surface* g_surfaceChargerBMP( | char | * | c | ) |
|
Permet de charger un fichier BMP du disque dur directement dans un type surface Les tailles de la surface sont automatiquement écrite, la mémoire est automatiquement allouée. La surface est allouée en mémoire vidéo. Paramètrec | chemin d’accès au fichier BMP |
RetourLa fonction retourne un pointeur de surface correspondante à l’image BMP, si le fichier est introuvable ou si la mémoire n’a pas été allouée, le pointeur NULL sera retourné.
g_surfaceEffacevoid g_surfaceEfface( | G_surface | * | s | ) |
|
Permet d’effacer toutes les couleurs de la surface par un rectangle noir recouvrant le tout Paramètres | la surface que l’on souhaite effacer |
g_surfaceDetruirevoid g_surfaceDetruire( | G_surface | * | surface | ) |
|
Permet de détruire une surface que l’on a alloué par g_surfaceCreer ou g_surfaceCharger Paramètres | la surface que l’on souhaite détruire |
G_fenetreCe type abstrait de donné est la fenetre principale graphique de l’application. Elle doit être unique. Le type nécessite une initialisation préliminaire, et une destruction finale. La G_fenetre* contient une surface graphique qui representera ce qui est affiché dedans. Summary | | | Permet l’initialisation d’une G_fenetre en fonction de resolution et d’un mode plein écran ou non | | Permet de récuperer la surface graphique d’une fenetre | | Permet d’afficher la fenetre à l’écran. | | |
g_fenetreInitialiserint g_fenetreInitialiser( | G_fenetre | * | fenetre, | | int | | resolutionx, | | int | | resolutiony, | | G_fenetre_mode | | mode | ) |
|
Permet l’initialisation d’une G_fenetre en fonction de resolution et d’un mode plein écran ou non Paramètresfenetre | la fenetre à initialiser | resolutionx | la résolution verticale de la fenetre | resolutiony | la résolution horizontale de la fenetre | mode | le mode plein écran ou non plein écran, les valeurs possibles sont: PLEIN_ECRAN et PAS_PLEIN_ECRAN |
RetourSi la fonction a réussi à initialiser la fenetre, EXIT_SUCCESS est retournée, dans le cas contraire EXIT_FAILURE est renvoyé
g_fenetreLireSurfaceG_surface* g_fenetreLireSurface( | G_fenetre* | ) |
|
Permet de récuperer la surface graphique d’une fenetre Paramètresfenetre | la fenetre que l’on souhaite recuperer la surface |
RetourUn pointeur vers la surface à recuperer
g_fenetreAffichervoid g_fenetreAfficher( | G_fenetre* | ) |
|
Permet d’afficher la fenetre à l’écran. Donc de mettre à jour la représentation Il est conseillé de la mettre à jour à chaque tour de boucle, l’utilité de cette fonction réside dans l’utilisation du double buffering pour éviter le phénomène de clignotement
g_fenetreDetruirevoid g_fenetreDetruire( | G_fenetre | * | fenetre | ) |
|
Detruit la fenetre Paramètrefenetre | la fenetre que l’on souhaite détruire |
|