SDL_ListModes.3
上传用户:sun1608
上传日期:2007-02-02
资源大小:6116k
文件大小:2k
源码类别:

流媒体/Mpeg4/MP4

开发平台:

Visual C++

  1. .TH "SDL_ListModes" "3" "Tue 11 Sep 2001, 23:01" "SDL" "SDL API Reference" 
  2. .SH "NAME"
  3. SDL_ListModes- Returns a pointer to an array of available screen dimensions for the given format and video flags
  4. .SH "SYNOPSIS"
  5. .PP
  6. fB#include "SDL&.h"
  7. .sp
  8. fBSDL_Rect **fBSDL_ListModesfPfR(fBSDL_PixelFormat *format, Uint32 flagsfR);
  9. .SH "DESCRIPTION"
  10. .PP
  11. 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&.
  12. .PP
  13. 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&.
  14. .SH "EXAMPLE"
  15. .PP
  16. .nf
  17. f(CWSDL_Rect **modes;
  18. int i;
  19. &.
  20. &.
  21. &.
  22. /* Get available fullscreen/hardware modes */
  23. modes=SDL_ListModes(NULL, SDL_FULLSCREEN|SDL_HWSURFACE);
  24. /* Check is there are any modes available */
  25. if(modes == (SDL_Rect **)0){
  26.   printf("No modes available!
  27. ");
  28.   exit(-1);
  29. }
  30. /* Check if or resolution is restricted */
  31. if(modes == (SDL_Rect **)-1){
  32.   printf("All resolutions available&.
  33. ");
  34. }
  35. else{
  36.   /* Print valid modes */
  37.   printf("Available Modes
  38. ");
  39.   for(i=0;modes[i];++i)
  40.     printf("  %d x %d
  41. ", modes[i]->w, modes[i]->h);
  42. }
  43. &.
  44. &.fR
  45. .fi
  46. .PP
  47. .SH "SEE ALSO"
  48. .PP
  49. fIfBSDL_SetVideoModefPfR, fIfBSDL_GetVideoInfofPfR, fIfBSDL_RectfRfR, fIfBSDL_PixelFormatfRfR
  50. ..." created by instant / docbook-to-man, Tue 11 Sep 2001, 23:01