7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
10 TITLE="SDL Library Documentation"
11 HREF="index.html"><LINK
14 HREF="video.html"><LINK
16 TITLE="SDL_PixelFormat"
17 HREF="sdlpixelformat.html"><LINK
20 HREF="sdlvideoinfo.html"></HEAD
31 SUMMARY="Header navigation table"
40 >SDL Library Documentation</TH
48 HREF="sdlpixelformat.html"
62 HREF="sdlvideoinfo.html"
83 >SDL_Surface -- Graphical Surface Structure</DIV
90 >Structure Definition</H2
92 CLASS="PROGRAMLISTING"
93 >typedef struct SDL_Surface {
94 Uint32 flags; /* Read-only */
95 SDL_PixelFormat *format; /* Read-only */
96 int w, h; /* Read-only */
97 Uint16 pitch; /* Read-only */
98 void *pixels; /* Read-write */
100 /* clipping information */
101 SDL_Rect clip_rect; /* Read-only */
103 /* Reference count -- used when freeing surface */
104 int refcount; /* Read-mostly */
106 /* This structure also contains private fields not shown here */
117 CLASS="INFORMALTABLE"
156 HREF="sdlpixelformat.html"
173 >Width and height of the surface</TD
188 >Length of a surface scanline in bytes</TD
203 >Pointer to the actual pixel data</TD
240 >'s represent areas of "graphical"
241 memory, memory that can be drawn to. The video framebuffer is returned
247 HREF="sdlsetvideomode.html"
250 >SDL_SetVideoMode</TT
254 HREF="sdlgetvideosurface.html"
257 >SDL_GetVideoSurface</TT
260 Most of the fields should be pretty obvious.
272 width and height of the surface in pixels.
278 > is a pointer to the actual pixel data,
279 the surface should be <A
280 HREF="sdllocksurface.html"
283 before accessing this field. The <TT
289 is the clipping rectangle as set by
291 HREF="sdlsetcliprect.html"
298 >The following are supported in the
306 CLASS="INFORMALTABLE"
327 >Surface is stored in system memory</TD
340 >Surface is stored in video memory</TD
353 >Surface uses asynchronous blits if possible</TD
366 >Allows any pixel-format (Display surface)</TD
379 >Surface has exclusive palette</TD
392 >Surface is double buffered (Display surface)</TD
405 >Surface is full screen (Display Surface)</TD
418 >Surface has an OpenGL context (Display Surface)</TD
431 >Surface supports OpenGL blitting (Display Surface)</TD
444 >Surface is resizable (Display Surface)</TD
457 >Surface blit uses hardware acceleration</TD
470 >Surface use colorkey blitting</TD
483 >Colorkey blitting is accelerated with RLE</TD
496 >Surface blit uses alpha blending</TD
509 >Surface uses preallocated memory</TD
526 HREF="sdlpixelformat.html"
529 >SDL_PixelFormat</SPAN
538 SUMMARY="Footer navigation table"
549 HREF="sdlpixelformat.html"
567 HREF="sdlvideoinfo.html"