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

流媒体/Mpeg4/MP4

开发平台:

Visual C++

  1. .TH "SDL_Surface" "3" "Tue 11 Sep 2001, 23:01" "SDL" "SDL API Reference" 
  2. .SH "NAME"
  3. SDL_Surface- Graphical Surface Structure
  4. .SH "STRUCTURE DEFINITION"
  5. .PP
  6. .nf
  7. f(CWtypedef struct SDL_Surface {
  8.         Uint32 flags;                           /* Read-only */
  9.         SDL_PixelFormat *format;                /* Read-only */
  10.         int w, h;                               /* Read-only */
  11.         Uint16 pitch;                           /* Read-only */
  12.         void *pixels;                           /* Read-write */
  13.         /* clipping information */
  14.         SDL_Rect clip_rect;                     /* Read-only */
  15.         /* Reference count -- used when freeing surface */
  16.         int refcount;                           /* Read-mostly */
  17. /* This structure also contains private fields not shown here */
  18. } SDL_Surface;fR
  19. .fi
  20. .PP
  21. .SH "STRUCTURE DATA"
  22. .TP 20
  23. fBflagsfR
  24. Surface flags
  25. .TP 20
  26. fBformatfR
  27. Pixel fIformatfR
  28. .TP 20
  29. fBw, hfR
  30. Width and height of the surface
  31. .TP 20
  32. fBpitchfR
  33. Length of a surface scanline in bytes
  34. .TP 20
  35. fBpixelsfR
  36. Pointer to the actual pixel data
  37. .TP 20
  38. fBclip_rectfR
  39. surface clip fIrectanglefR
  40. .SH "DESCRIPTION"
  41. .PP
  42. fBSDL_SurfacefR&'s represent areas of "graphical" memory, memory that can be drawn to&. The video framebuffer is returned as a fBSDL_SurfacefR by fIfBSDL_SetVideoModefPfR and fIfBSDL_GetVideoSurfacefPfR&. Most of the fields should be pretty obvious&. fBwfR and fBhfR are the width and height of the surface in pixels&. fBpixelsfR is a pointer to the actual pixel data, the surface should be fIlockedfR before accessing this field&. The fBclip_rectfR field is the clipping rectangle as set by fIfBSDL_SetClipRectfPfR&.
  43. .PP
  44. The following are supported in the fBflagsfR field&.
  45. .TP 20
  46. fBSDL_SWSURFACEfP
  47. Surface is stored in system memory
  48. .TP 20
  49. fBSDL_HWSURFACEfP
  50. Surface is stored in video memory
  51. .TP 20
  52. fBSDL_ASYNCBLITfP
  53. Surface uses asynchronous blits if possible
  54. .TP 20
  55. fBSDL_ANYFORMATfP
  56. Allows any pixel-format (Display surface)
  57. .TP 20
  58. fBSDL_HWPALETTEfP
  59. Surface has exclusive palette
  60. .TP 20
  61. fBSDL_DOUBLEBUFfP
  62. Surface is double buffered (Display surface)
  63. .TP 20
  64. fBSDL_FULLSCREENfP
  65. Surface is full screen (Display Surface)
  66. .TP 20
  67. fBSDL_OPENGLfP
  68. Surface has an OpenGL context (Display Surface)
  69. .TP 20
  70. fBSDL_OPENGLBLITfP
  71. Surface supports OpenGL blitting (Display Surface)
  72. .TP 20
  73. fBSDL_RESIZABLEfP
  74. Surface is resizable (Display Surface)
  75. .TP 20
  76. fBSDL_HWACCELfP
  77. Surface blit uses hardware acceleration
  78. .TP 20
  79. fBSDL_SRCCOLORKEYfP
  80. Surface use colorkey blitting
  81. .TP 20
  82. fBSDL_RLEACCELfP
  83. Colorkey blitting is accelerated with RLE
  84. .TP 20
  85. fBSDL_SRCALPHAfP
  86. Surface blit uses alpha blending
  87. .TP 20
  88. fBSDL_PREALLOCfP
  89. Surface uses preallocated memory
  90. .SH "SEE ALSO"
  91. .PP
  92. fIfBSDL_PixelFormatfRfR
  93. ..." created by instant / docbook-to-man, Tue 11 Sep 2001, 23:01