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

流媒体/Mpeg4/MP4

开发平台:

Visual C++

  1. .TH "SDL_SetVideoMode" "3" "Tue 11 Sep 2001, 23:01" "SDL" "SDL API Reference" 
  2. .SH "NAME"
  3. SDL_SetVideoMode- Set up a video mode with the specified width, height and bits-per-pixel&.
  4. .SH "SYNOPSIS"
  5. .PP
  6. fB#include "SDL&.h"
  7. .sp
  8. fBSDL_Surface *fBSDL_SetVideoModefPfR(fBint width, int height, int bpp, Uint32 flagsfR);
  9. .SH "DESCRIPTION"
  10. .PP
  11. Set up a video mode with the specified width, height and bits-per-pixel&.
  12. .PP
  13. If fBbppfR is 0, it is treated as the current display bits per pixel&.
  14. .PP
  15. The fBflagsfR parameter is the same as the fBflagsfR field of the fIfBSDL_SurfacefRfR structure&. OR&'d combinations of the following values are valid&.
  16. .TP 20
  17. fBSDL_SWSURFACEfP
  18. Create the video surface in system memory
  19. .TP 20
  20. fBSDL_HWSURFACEfP
  21. Create the video surface in video memory
  22. .TP 20
  23. fBSDL_ASYNCBLITfP
  24. Enables the use of asynchronous updates of the display surface&. This will usually slow down blitting on single CPU machines, but may provide a speed increase on SMP systems&.
  25. .TP 20
  26. fBSDL_ANYFORMATfP
  27. Normally, if a video surface of the requested bits-per-pixel (fBbppfR) is not available, SDL will emulate one with a shadow surface&. Passing fBSDL_ANYFORMATfP prevents this and causes SDL to use the video surface, regardless of its pixel depth&.
  28. .TP 20
  29. fBSDL_HWPALETTEfP
  30. Give SDL exclusive palette access&. Without this flag you may not always get the the colors you request with fIfBSDL_SetColorsfPfR or fIfBSDL_SetPalettefPfR&.
  31. .TP 20
  32. fBSDL_DOUBLEBUFfP
  33. Enable hardware double buffering; only valid with SDL_HWSURFACE&. Calling fIfBSDL_FlipfPfR will flip the buffers and update the screen&. All drawing will take place on the surface that is not displayed at the moment&. If double buffering could not be enabled then fBSDL_FlipfP will just perform a fIfBSDL_UpdateRectfPfR on the entire screen&.
  34. .TP 20
  35. fBSDL_FULLSCREENfP
  36. SDL will attempt to use a fullscreen mode&. If a hardware resolution change is not possible (for whatever reason), the next higher resolution will be used and the display window centered on a black background&.
  37. .TP 20
  38. fBSDL_OPENGLfP
  39. Create an OpenGL rendering context&. You should have previously set OpenGL video attributes with fIfBSDL_GL_SetAttributefPfR&.
  40. .TP 20
  41. fBSDL_OPENGLBLITfP
  42. Create an OpenGL rendering context, like above, but allow normal blitting operations&. The screen (2D) surface may have an alpha channel, and fIfBSDL_UpdateRectsfPfR must be used for updating changes to the screen surface&.
  43. .TP 20
  44. fBSDL_RESIZABLEfP
  45. Create a resizable window&. When the window is resized by the user a fIfBSDL_VIDEORESIZEfPfR event is generated and fBSDL_SetVideoModefP can be called again with the new size&.
  46. .TP 20
  47. fBSDL_NOFRAMEfP
  48. If possible, fBSDL_NOFRAMEfP causes SDL to create a window with no title bar or frame decoration&. Fullscreen modes automatically have this flag set&.
  49. .PP
  50. .RS
  51. fBNote:  
  52. .PP
  53. Whatever fBflagsfR fBSDL_SetVideoModefP could satisfy are set in the fBflagsfR member of the returned surface&.
  54. .RE
  55. .PP
  56. .RS
  57. fBNote:  
  58. .PP
  59. The fBbppfR parameter is the number of bits per pixel, so a fBbppfR of 24 uses the packed representation of 3 bytes/pixel&. For the more common 4 bytes/pixel mode, use a fBbppfR of 32&. Somewhat oddly, both 15 and 16 will request a 2 bytes/pixel mode, but different pixel formats&.
  60. .RE
  61. .SH "RETURN VALUE"
  62. .PP
  63. The framebuffer surface, or fBNULLfR if it fails&. The surface returned is freed by SDL_Quit() and should nt be freed by the caller&.
  64. .SH "SEE ALSO"
  65. .PP
  66. fIfBSDL_LockSurfacefPfR, fIfBSDL_SetColorsfPfR, fIfBSDL_FlipfPfR, fIfBSDL_SurfacefRfR
  67. ..." created by instant / docbook-to-man, Tue 11 Sep 2001, 23:01