SDL_Surface — Graphical Surface Structure
| typedef | struct SDL_Surface { | |||
| Uint32 |
flags; |
/* Read-only */
|
||
| SDL_PixelFormat | * |
format; |
/* Read-only */
|
|
| int |
w, |
|||
h; |
/* Read-only */
|
|||
| Uint16 |
pitch; |
/* Read-only */
|
||
| void | * |
pixels; |
/* Read-write */
|
|
|
/* clipping information */
|
||||
| SDL_Rect |
clip_rect; |
/* Read-only */
|
||
|
/* Reference count -- used when freeing surface */
|
||||
| int |
refcount; |
/* Read-mostly */
|
||
|
/* This structure also contains private fields not shown here */
|
||||
| } SDL_Surface; | ||||
flagsSurface flags
formatPixel format
Width and height of the surface
pitchLength of a surface scanline in bytes
pixelsPointer to the actual pixel data
clip_rectsurface clip rectangle
SDL_Surface's represent
areas of "graphical" memory, memory that can be drawn to. The
video framebuffer is returned as a SDL_Surface by SDL_SetVideoMode and SDL_GetVideoSurface. Most of the fields
should be pretty obvious. w and h are the width and height of
the surface in pixels. pixels is a pointer to the
actual pixel data, the surface should be locked before accessing this
field. The clip_rect
field is the clipping rectangle as set by SDL_SetClipRect.
The following are supported in the flags field.
SDL_SWSURFACESurface is stored in system memory
SDL_HWSURFACESurface is stored in video memory
SDL_ASYNCBLITSurface uses asynchronous blits if possible
SDL_ANYFORMATAllows any pixel-format (Display surface)
SDL_HWPALETTESurface has exclusive palette
SDL_DOUBLEBUFSurface is double buffered (Display surface)
SDL_FULLSCREENSurface is full screen (Display Surface)
SDL_OPENGLSurface has an OpenGL context (Display Surface)
SDL_OPENGLBLITSurface supports OpenGL blitting (Display Surface)
SDL_RESIZABLESurface is resizable (Display Surface)
SDL_HWACCELSurface blit uses hardware acceleration
SDL_SRCCOLORKEYSurface use colorkey blitting
SDL_RLEACCELColorkey blitting is accelerated with RLE
SDL_SRCALPHASurface blit uses alpha blending
SDL_PREALLOCSurface uses preallocated memory