7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
10 TITLE="SDL Library Documentation"
11 HREF="index.html"><LINK
14 HREF="video.html"><LINK
16 TITLE="SDL_VideoDriverName"
17 HREF="sdlvideodrivername.html"><LINK
19 TITLE="SDL_VideoModeOK"
20 HREF="sdlvideomodeok.html"></HEAD
31 SUMMARY="Header navigation table"
40 >SDL Library Documentation</TH
48 HREF="sdlvideodrivername.html"
62 HREF="sdlvideomodeok.html"
83 >SDL_ListModes -- Returns a pointer to an array of available screen dimensions for
84 the given format and video flags</DIV
86 CLASS="REFSYNOPSISDIV"
100 CLASS="FUNCSYNOPSISINFO"
101 >#include "SDL.h"</PRE
110 >(SDL_PixelFormat *format, Uint32 flags);</CODE
124 >Return a pointer to an array of available screen dimensions for the given
125 format and video flags, sorted largest to smallest. Returns
129 > if there are no dimensions available for a particular
133 > if any dimension is okay for
145 will be for the format returned by <A
146 HREF="sdlgetvideoinfo.html"
147 >SDL_GetVideoInfo()</A
158 > parameter is an OR'd combination of <A
159 HREF="sdlsurface.html"
161 > flags. The flags are the same as those used <A
162 HREF="sdlsetvideomode.html"
165 >SDL_SetVideoMode</TT
167 > and they play a strong role in deciding what modes are valid. For instance, if you pass <TT
170 > as a flag only modes that support hardware video surfaces will be returned.</P
180 CLASS="PROGRAMLISTING"
187 /* Get available fullscreen/hardware modes */
188 modes=SDL_ListModes(NULL, SDL_FULLSCREEN|SDL_HWSURFACE);
190 /* Check is there are any modes available */
191 if(modes == (SDL_Rect **)0){
192 printf("No modes available!\n");
196 /* Check if our resolution is restricted */
197 if(modes == (SDL_Rect **)-1){
198 printf("All resolutions available.\n");
201 /* Print valid modes */
202 printf("Available Modes\n");
203 for(i=0;modes[i];++i)
204 printf(" %d x %d\n", modes[i]->w, modes[i]->h);
218 HREF="sdlsetvideomode.html"
221 >SDL_SetVideoMode</TT
225 HREF="sdlgetvideoinfo.html"
228 >SDL_GetVideoInfo</TT
239 HREF="sdlpixelformat.html"
242 >SDL_PixelFormat</SPAN
251 SUMMARY="Footer navigation table"
262 HREF="sdlvideodrivername.html"
280 HREF="sdlvideomodeok.html"
290 >SDL_VideoDriverName</TD