SDL_ListModes

SDL_ListModes -- Retourne un pointeur vers un tableau de dimensions d'écran disponibles pour le format et les flags vidéos donnés

Syntaxe

SDL_Rect** SDL_ListModes(SDL_PixelFormat* format, Uint32 flags);

Description

Le pointeur renvoyé est un tableau de pointeurs de SDL_Rect de dimensions d'écran disponibles pour le format et les flags vidéos donnés. Le tableau n'a aucune garantie d'être trié dans un ordre particulier. La fonction renvoie NULL s'il n'y a aucun mode disponible pour le format donné, ou -1 si n'importe quelle dimension marche pour ce format.

Paramètres

format [in]

flags [in]

Valeur de retour

NULL

-1

Le pointeur vers le tableau de SDL_Rect*

Exemple

   1 SDL_Rect** modes;
   2 int i;
   3 
   4 /* Récupère les modes plein écran et matériel disponibles */
   5 modes = SDL_ListModes(NULL, SDL_FULLSCREEN|SDL_HWSURFACE);
   6 
   7 /* Vérifie que des modes sont disponibles*/
   8 if (modes == (SDL_Rect**)0) {
   9     printf("Aucun mode vidéo disponible!\n");
  10     exit(-1);
  11 }
  12 
  13 /* Vérifie si nos choix de résolutions sont restreints */
  14 if (modes == (SDL_Rect**)-1) {
  15     printf("Toutes les résolutions sont disponibles.\n");
  16 }
  17 else{
  18     /* Affiche les modes valides */
  19     printf("Modes vidéo disponibles\n");
  20     for (i=0; modes[i]; ++i)
  21       printf("  %d x %d\n", modes[i]->w, modes[i]->h);
  22 }

Voir Aussi

SDL_SetVideoMode, SDL_VideoModeOK, SDL_GetVideoInfo, SDL_Rect, SDL_PixelFormat

Requis

Header

SDL.h

Version

1.2.13

Shared object

libSDL.so

DLL

SDL.dll


CategorySDLVideoFr

User comments

From digging through the source: the list returned by this call is statically allocated. You do not need to free it. Now, somebody help me out here for future reference, should I have just assumed that because it wasn't otherwise mentioned or should that sort of thing be documented explicitly?
-- cid 2005-??-??

SDL_ListModes doesn't quite give the list of all the modes that would work (X11). I was briefly filtering the available resolutions based on the values returned and removed it from Quake4 as it was way too restrictive. I don't know if it's a problem with SDL, or with Xxf86vm.
-- TTimo 2006-04-24

SDLDoc-fr/SDL_ListModes (last edited 2009-02-13 23:27:57 by AlexisDM)