Vos premières fenêtres SDL 2

L'unique paramètre de la fonction permet de définir les composants que la bibliothèque doit initialiser. Ceux-ci peuvent être :

Dans le code mis en avant ci-dessus, la valeur de retour de la fonction est vérifiée afin de quitter le programme lors d'un cas d'erreur. Lorsqu'une erreur se produit, la valeur est différente de 0. Afin d'informer l'utilisateur (et, bien souvent le programmeur), un message clair est affiché sur la sortie standard d'erreur. La fonction SDL_GetError() permet de récupérer un descriptif de l'erreur rencontrée par la bibliothèque.

SDL_CreateWindow() attend plusieurs paramètres afin de créer la fenêtre. Ceux-ci sont :

• le nom à afficher ;
• la position en X ;
• la position en Y ;
• la taille en largeur ;
• la taille en hauteur ;
• les options (plein écran, fenêtre OpenGLFenêtre OpenGL (3D)…).

Pour la position, vous pouvez utiliser SDL_WINDOWPOS_UNDEFINED ou SDL_WINDOWPOS_CENTERED, deux valeurs spéciales indiquant que c'est à la bibliothèque de déterminer la position de la fenêtre. La première valeur laisse le libre champ à la bibliothèque de placer la fenêtre où elle le souhaite, la seconde permet de toujours avoir une fenêtre centrée sur l'écran.

III-A-1. Les options de création de la fenêtre▲

La fonction SDL_CreateWindow() renvoie un pointeur sur une variable de type SDL_WindowLa structure SDL_Window, représentant la fenêtre. Chaque fois que vous devez agir sur cette fenêtre, vous devez indiquer la variable retournée.

En cas d'erreur, la variable retournée aura la valeur NULL. Comme pour l'initialisation de la bibliothèqueInitialisation de la bibliothèque, vous pouvez utiliser SDL_GetError() pour avoir une chaîne de caractères décrivant l'erreur.

Une fenêtre OpenGL se construit de la même manière qu'une fenêtre normale : avec la fonction SDL_CreateWindow(). Toutefois, pour que OpenGL puisse dessiner dedans, il faut obligatoirement spécifier l'option SDL_WINDOW_OPENGL lors de la création.

Depuis la SDL 2, il est possible d'afficher et de gérer plusieurs fenêtres SDL. Cela est possible grâce à l'introduction de la structure SDL_Window, représentant une fenêtre. En effet, chaque appel à SDL_CreateWindow() retournera un pointeur sur une variable SDL_Window différente, permettant ainsi de les identifier par la bibliothèque. Lorsque vous souhaitez agir sur telle ou telle fenêtre, il suffira d'utiliser la variable correspondante.

De multiples fonctions sont disponibles dans la bibliothèque afin d’interagir avec la bibliothèque. Voici un récapitulatif :

Afin de fournir un jeu ou une application qui ne contraint pas l'utilisateur et ne dérange pas ses habitudes (ce qui pourrait entrainer un mécontentement), il est conseillé d'éviter l'imposition du mode plein écran. Toutefois, le proposer en option (par exemple, au démarrage de l'application) est une bonne idée.

Vous pouvez aussi opter pour la mise en place d'une touche permettant de passer à la volée du mode fenêtré au mode plein écran et inversement. Pour cela, vous devrez utiliser la fonction : SDL_SetWindowFullscreen().

VIII-A-1. Les paramètres de SDL_SetWindowFullscreen▲

VIII-A-2. La valeur de retour de SDL_SetWindowFullscreen▲

VIII-A-3. Exemple▲

SDL_Event event;
while (SDL_PollEvent(&event)) // Récupération des actions de l'utilisateur
{
    switch(event.type)
    {
        case SDL_QUIT: // Clic sur la croix
            quit=1;
            break;
        case SDL_KEYUP: // Relâchement d'une touche
            if ( event.key.keysym.sym == SDLK_f ) // Touche f
            {
                // Alterne du mode plein écran au mode fenêtré
                if ( fullscreen == 0 )
                {
                    fullscreen = 1;
                    SDL_SetWindowFullscreen(pWindow,SDL_WINDOW_FULLSCREEN);
                }
                else if ( fullscreen == 1 )
                {
                    fullscreen = 0;
                    SDL_SetWindowFullscreen(pWindow,0);
                }
            }
            break;
    }
}

Dans une optique proche de l'option pour le mode fenêtré/plein écran, il est intéressant pour l'utilisateur d'avoir le choix de la résolution de l'application. Vous devrez donc rechercher les résolutions disponibles sur sa machine et lui proposer de choisir parmi l'une d'elles. Le code suivant permet de détecter les résolutions utilisables :

// On récupère le nombre de modes d'affichage pour l'écran 0
int modeNumber = SDL_GetNumDisplayModes(0);
if (modeNumber < 0)
{
 fprintf(stdout,"Échec lors de la récupération du nombre de modes (%s)\n",SDL_GetError());
 return -2;
}
fprintf(stdout,"Vous avez %d mode(s) d'affichage\n", modeNumber);

// Affichage des différents modes
SDL_DisplayMode displayMode;
for (i = 0 ; i < modeNumber ; i++)
{
    error = SDL_GetDisplayMode(0, i, &displayMode);
    if (error < 0)
    {
        fprintf(stdout, "Échec lors de la récupération du mode d'affichage (%s)\n", SDL_GetError());
        return -3;
    }
    
    fprintf(stdout, "Mode %d : %dx%dx%d\n", i, displayMode.w, displayMode.h, displayMode.refresh_rate);
}

Ce code doit être inséré après l'initialisation de la SDLInitialisation de la bibliothèque (et avant son arrêtArrêter la SDL).

Pour afficher les résolutions disponibles, il est nécessaire d'utiliser les fonctions SDL_GetNumDisplayMode() et SDL_GetDisplayMode(). La première retourne le nombre de modes d'affichage disponibles, la seconde, remplit une structure avec les informations du mode d'affichage.

VIII-B-1. Les paramètres de SDL_GetNumDisplayMode()▲

VIII-B-2. La valeur de retour de SDL_GetNumDisplayMode()▲

VIII-B-3. Les paramètres de SDL_GetDisplayMode()▲

VIII-B-4. La valeur de retour de SDL_GetDisplayMode()▲

VIII-B-5. La structure SDL_DisplayMode▲