Afficher son premier sprite avec la SDL 2.0

SDL_Surface est une structure utilisée pour contenir un ensemble de pixels et les informations nécessaires pour utiliser ces pixels. Voici la liste des champs de la structure :

SDL_Rect représente un rectangle. Pour cela, quatre champs sont définis :

La fonction SDL_LoadBMP() charge une surface à partir d'un fichier BMP, ainsi elle prend en paramètre une chaine de caractères : chemin menant au fichier BMP à charger.

Lorsque le chargement est réussi, la fonction SDL_LoadBMP() retourne un pointeur sur SDL_SurfaceSDL_Surface, sinon, la fonction retourne NULL. Vous pouvez connaître la raison avec SDL_GetError().

Vous devez définir l'endroit où votre sprite sera copié en utilisant la structure SDL_RectSDL_Rect :

SDL_Rect dest = { 640/2 - pSprite->w/2,480/2 - pSprite->h/2, 0, 0};

Les deux premiers champs de la structure SDL_Rect servent à indiquer où nous voulons copier le sprite (position de son coin supérieur gauche). Les deux derniers champs sont inutiles pour la fonction SDL_BlitSurface().

Ici, nous voulons centrer le sprite dans notre fenêtre de résolution 640 x 480. Pour ce faire, nous calculons le centre de la fenêtre : 640/2 , 480/2. Mais cela ne suffit pas, car le sprite est dessiné en partant de son coin supérieur gauche. Il est donc nécessaire de le décaler afin que son centre corresponde au centre de la fenêtre. Le centre du sprite s'obtient en divisant la largeur et la hauteur par deux (comme pour la fenêtre). Nous pouvons récupérer la largeur et la hauteur de la structure SDL_SurfaceSDL_Surface avec les champs 'w' et 'h' : pSprite->w/2, pSprite->h/2. Connaissant le centre du sprite, il est maintenant possible de nous décaler pour faire correspondre celui-ci avec le centre de l'image : centre_de_l'image - centre_du_sprite. Ce qui donne dans le code : 640/2 - pSprite->w/2,480/2 - pSprite->h/2.

Si vraiment vous n'y arrivez pas, prenez une feuille de papier, dessiner un rectangle assez grand pour votre fenêtre, un carré pour votre sprite et écrivez les positions x et y des points. Cela devrait devenir clair.

SDL_BlitSurface() nécessite un pointeur sur une instance de SDL_Surface comme destination de son opération de copie. Le sprite doit être affiché dans la fenêtre, mais celle-ci est de type SDL_Window. Il est possible de récupérer la SDL_Surface associée à votre fenêtre (SDL_Window) grâce à la fonction SDL_GetWindowSurface(). Comme nous l'avons vu dans le tutoriel précédent, la structure SDL_Window contient une SDL_Surface représentant les pixels de la fenêtre. Cette surface peut être récupérée comme suit :

SDL_Surface pWinSurf = SDL_GetWindowSurface(pWindow);

II-C-2-a. Les paramètres de SDL_GetWindowSurface()▲

II-C-2-b. La valeur de retour de SDL_GetWindowSurface()▲

Vous avez tous les éléments pour copier votre sprite dans la fenêtre :

• la surface source, chargée avec SDL_LoadBMP()Chargement Sprite ;
• la surface de destination récupérée grâce à SDL_GetWindowSurface() ;
• l'emplacement voulu pour le spriteDéfinition de la destination du sprite.

Il suffit d'appeler SDL_BlitSurface() avec les paramètres préparés :

SDL_BlitSurface(pSprite,NULL,SDL_GetWindowSurface(pWindow),&dest);

II-C-3-a. Les paramètres de SDL_BlitSurface()▲

II-C-3-b. La valeur de retour de SDL_BlitSurface()▲

Arrivé ici, rien ne va apparaître à l'écran. En effet, SDL_BlitSurface() copiera le sprite sur la surface de l'écran, sauf que celle-ci est une zone mémoire et ne correspond pas à l'écran physique. Pour afficher cette surface à l'écran, il suffit d'appeler SDL_UpdateWindowSurface() qui forcera la mise à jour de la fenêtre et prendra donc en compte le changement de la surface :

SDL_UpdateWindowSurface(pWindow);

Voilà, vous pouvez maintenant voir le sprite à l'écran.

II-C-4-a. Le paramètres de SDL_UpdateWindowSurface()▲

II-C-4-b. La valeur de retour de SDL_UpdateWindowSurface()▲

Tout comme pour la fenêtre, une fois que vous n'avez plus besoin du sprite, vous devez libérer la mémoire associée. La fonction pour ce faire est SDL_FreeSurface() :

SDL_FreeSurface(pSprite);

II-C-5-a. Le paramètre de SDL_FreeSurface()▲

Voici le code d'affichage d'un sprite :

SDL_Surface* pSprite = SDL_LoadBMP("./data/dvp.bmp");
if ( pSprite )
{
    SDL_Rect dest = { 640/2 - pSprite->w/2,480/2 - pSprite->h/2, 0, 0};
    SDL_BlitSurface(pSprite,NULL,SDL_GetWindowSurface(pWindow),&dest); // Copie du sprite
    
    SDL_UpdateWindowSurface(pWindow); // Mise à jour de la fenêtre pour prendre en compte la copie du sprite
    SDL_Delay(3000); /* Attendre trois secondes, que l'utilisateur voit la fenêtre */
    
    SDL_FreeSurface(pSprite); // Libération de la ressource occupée par le sprite
}
else
{
    fprintf(stdout,"Échec de chargement du sprite (%s)\n",SDL_GetError());
}

La structure SDL_Renderer peut être assimilée à un pinceau. C'est grâce à SDL_Renderer que vous allez pouvoir afficher des éléments dans la fenêtre et cela, en utilisant la carte graphique, si vous le souhaitez.

La SDL_Texture peut être perçue comme une SDL_SurfaceSDL_Surface, mais placée dans la mémoire de la carte graphique (et donc, utilisable par celle-ci). Vous pouvez la créer à partir d'une SDL_Surface.

La fonction SDL_CreateRenderer() accepte trois paramètres :

• la fenêtre (SDL_Window) pour laquelle le SDL_Renderer doit être créé ;
• un index spécifiant le SDL_Renderer à initialiser ou -1 pour utiliser le premier supportant les options indiquées ;
• des options sur le SDL_Renderer.

III-B-1-a. Options du SDL_Renderer▲

SDL_CreateRenderer() retourne en toute logique un pointeur sur une instance de SDL_Renderer. En cas d'erreur la fonction retourne NULL et des informations sur celle-ci seront disponibles en appelant SDL_GetError().

SDL_CreateTextureFromSurface() nécessite deux paramètres :

• le SDL_Renderer pour lequel la texture est créée ;
• la SDL_Surface sur laquelle se baser pour créer la SDL_Texture.

La fonction retourne un pointeur sur la SDL_Texture nouvellement créée. Si une erreur est survenue, un pointeur NULL sera retourné et un message d'erreur explicite pourra être récupéré avec SDL_GetError().

La fonction accepte quatre paramètres :

• la texture pour laquelle vous voulez récupérer des informations ;
• le format des pixels de la texture ;
• l'état d'accès de la texture ;
• la largeur ;
• la hauteur.

Le format, l'état d'accès, la largeur et la hauteur sont des pointeurs afin de permettre à la fonction d'écrire les données.

La fonction retourne zéro en cas de réussite ou une valeur négative en cas d'erreur. SDL_GetError() donnera une description de l'erreur.

Cette fonction prend en paramètres :

• le SDL_Renderer (sachant que le SDL_Rendererest créé à partir d'une fenêtre, il affichera le sprite sur celle-ci) ;
• la SDL_Texture à copier ;
• le rectangle source (permettant ainsi de ne copier qu'une sous-partie d'une texture) ;
• le rectangle destination.

La fonction retourne zéro lorsque tout a bien été ou un entier négatif en cas d'erreur. SDL_GetError() donnera une description de l'erreur.

La fonction prend en paramètre le SDL_Renderer à mettre à jour.

La fonction prend en paramètre la SDL_Texture à détruire.

La fonction prend en paramètre le SDL_Renderer à détruire.

La fonction accepte trois paramètres :

• la surface à colorier ;
• le rectangle dans la surface à colorier ou NULL pour colorier l'intégralité de la surface ;
• la couleur à utiliser.

La fonction retourne zéro ou un entier négatif si une erreur a eu lieu. Vous pouvez utiliser SDL_GetError().

Pour indiquer la couleur de nettoyage à la bibliothèque, il faut utiliser la fonction SDL_SetRenderDrawColor() :

SDL_SetRenderDrawColor(renderer, 255, 0, 0, 255);

IV-B-1-a. Les paramètres de SDL_SetRenderDrawColor()▲

La fonction retourne zéro ou un entier négatif si une erreur a eu lieu. Vous pouvez utiliser SDL_GetError().

La fonction en SDL 2 pour effectuer le nettoyage est SDL_RenderClear :

SDL_RenderClear(renderer);

IV-B-3-a. Le paramètre de SDL_RenderClear()▲

IV-B-3-b. La valeur de retour de SDL_RenderClear()▲