SDL_ListModes.3
资源名称:NETVIDEO.rar [点击查看]
上传用户:sun1608
上传日期:2007-02-02
资源大小:6116k
文件大小:2k
源码类别:
流媒体/Mpeg4/MP4
开发平台:
Visual C++
- .TH "SDL_ListModes" "3" "Tue 11 Sep 2001, 23:01" "SDL" "SDL API Reference"
- .SH "NAME"
- SDL_ListModes- Returns a pointer to an array of available screen dimensions for the given format and video flags
- .SH "SYNOPSIS"
- .PP
- fB#include "SDL&.h"
- .sp
- fBSDL_Rect **fBSDL_ListModesfPfR(fBSDL_PixelFormat *format, Uint32 flagsfR);
- .SH "DESCRIPTION"
- .PP
- Return a pointer to an array of available screen dimensions for the given format and video flags, sorted largest to smallest&. Returns fBNULLfP if there are no dimensions available for a particular format, or fB-1fR if any dimension is okay for the given format&.
- .PP
- If fBformatfR is fBNULLfP, the mode list will be for the format returned by fISDL_GetVideoInfo()fR->fBvfmtfR&. The fBflagfR parameter is an OR&'d combination of fIsurfacefR flags&. The flags are the same as those used fIfBSDL_SetVideoModefPfR and they play a strong role in deciding what modes are valid&. For instance, if you pass fBSDL_HWSURFACEfP as a flag only modes that support hardware video surfaces will be returned&.
- .SH "EXAMPLE"
- .PP
- .nf
- f(CWSDL_Rect **modes;
- int i;
- &.
- &.
- &.
- /* Get available fullscreen/hardware modes */
- modes=SDL_ListModes(NULL, SDL_FULLSCREEN|SDL_HWSURFACE);
- /* Check is there are any modes available */
- if(modes == (SDL_Rect **)0){
- printf("No modes available!
- ");
- exit(-1);
- }
- /* Check if or resolution is restricted */
- if(modes == (SDL_Rect **)-1){
- printf("All resolutions available&.
- ");
- }
- else{
- /* Print valid modes */
- printf("Available Modes
- ");
- for(i=0;modes[i];++i)
- printf(" %d x %d
- ", modes[i]->w, modes[i]->h);
- }
- &.
- &.fR
- .fi
- .PP
- .SH "SEE ALSO"
- .PP
- fIfBSDL_SetVideoModefPfR, fIfBSDL_GetVideoInfofPfR, fIfBSDL_RectfRfR, fIfBSDL_PixelFormatfRfR
- ..." created by instant / docbook-to-man, Tue 11 Sep 2001, 23:01