DirectX en mode plein écran

   Quand vous travaillez avec DirectDraw, la première chose à faire consiste à créer l'objet DirectDraw. Cet objet propose des méthodes pour créer et gérer ses objets enfants, telles les surfaces ou les palettes. Chaque objet enfant possède, de son côté, des méthodes qui peuvent servir à accéder à d'autres fonctionnalités de DirectDraw. L'objet DirectDraw fournit aussi des méthodes qui permettent de connaître les capacités du système hôte, de déterminer la quantité de mémoire vidéo disponible et d'effectuer d'autres tâches générales concernant la gestion d'affichage.

HRESULT WINAPI DirectDrawCreateEx

Valeurs possibles pour le paramètre lpGUID de DirectDrawCreateEx :

   Cette fonction crée un objet DirectDraw7 avec une interface IDirectDraw7. DirectX fournit une interface IDirectDraw7, qui est l'interface la plus récente pour ce qui concerne la version 7.0.

LPDIRECTDRAW7 lpDD;

if(FAILED(DirectDrawCreateEx(NULL, (LPVOID*)&lpDD, IID_IDirectDraw7,
                             NULL))
   MessageBox(hWnd, "Impossible de créer l'objet DirectDraw.",
                    "Erreur", MB_OK);

   Cet exemple qui appelle une interface IDirectDraw7 requière au minimum une installation de DirectX 7.0. Cet exemple ne vérifie pas l'installation pour simplifier au maximum le code, mais vous pouvez rajouter cette vérification grâce à l'exemple "GetDXVersion" du répertoire "samples\multimedia\dxmisc\src\getdxver" du SDK.

   Le niveau coopératif définit la façon dont votre application interagira avec le système et avec les autres applications. Vous devez régler le niveau coopératif avant d'appeler d'autres méthodes de DirectDraw : sinon bon nombre d'entre elles échoueront.

HRESULT IDirectDraw7::SetCooperativelevel

Valeurs possibles pour le paramètre dwFlags de IDirectDraw7::SetCooperativelevel :

// -------------------------------------------------------------
// Définit le niveau coopératif en mode plein écran.
// Nous donne la possibilité de modifier la résolution.
// Autorise le redémarrage du système via CTRL + ALT + SUPPR.
// -------------------------------------------------------------

if(FAILED(lpDD->SetCooperativeLevel(hwnd, DDSCL_EXCLUSIVE |
                                          DDSCL_FULLSCREEN |
                                          DDSCL_ALLOWREBOOT))
  MessageBox(hWnd, "Impossible de définir le niveau coopératif.",
                   "Erreur", MB_OK);

   Par mode vidéo (display mode) de DirectDraw, on entend une certaine combinaison de largeur d'écran, de format d'écran et de taux de rafraîchissement. Le fait d'avoir plusieurs modes vidéo offre des avantages : certains modes apportent un plus grand nombre de couleurs, d'autres peuvent afficher plus de données, d'autres encore sont plus rapides. Malheureusement, le choix d'un mode vidéo pour votre application est en général une affaire de compromis : une plus grande surface d'affichage et un plus grand nombre de couleurs se paient souvent par une animation plus saccadée.

HRESULT IDirectDraw7::SetDisplayMode

// -------------------------------------------------------------
// Définit le nouveau mode vidéo.
// -------------------------------------------------------------

if(FAILED(lpDD->SetDisplayMode(640, 480, 16, NULL, NULL))
  MessageBox(hWnd, "Impossible de définir le mode vidéo.",
                   "Erreur", MB_OK);

   Une surface est un tampon mémoire géré comme un rectangle : c'est une feuille de papier virtuelle que votre application manipule, copie et réorganise.

   Les surfaces peuvent se diviser en plusieurs catégories générales. La surface primaire est la surface proposée à l'utilisateur. La surface la plus élémentaire n'est qu'un morceau de mémoire géré par DirectDraw, que l'on appelle surface off-screen. Les surfaces off-screen servent à stocker les illustrations utilisées par les applications, par exemple les arrière-plans et les sprites.

HRESULT IDirectDraw7::CreateSurface

DDSURFACEDESC2 desc;
ZeroMemory(&desc, sizeof(desc));
desc.dwSize = sizeof(desc);
desc.dwFlags = DDSD_BACKBUFFERCOUNT | DDSD_CAPS;
desc.dwBackBufferCount = 1;
desc.ddsCaps.dwCaps = DDSCAPS_PRIMARYSURFACE | DDSCAPS_FLIP |
                      DDSCAPS_COMPLEX;
if(FAILED(lpDD->CreateSurface(&desc, &primsurf, NULL)))
  MessageBox(hWnd, "Impossible de créer la surface primaire.",
                   "Erreur", MB_OK);