SDL_Surface

A structure that contains a collection of pixels used in software blitting.

Contents

Data Fields

Uint32	flags	internal
SDL_PixelFormat*	format	the format of the pixels stored in the surface; see SDL_PixelFormat for details (read-only)
int	w, h	the width and height in pixels (read-only)
int	pitch	the length of a scanline in bytes (read-only)
void*	pixels	the pointer to the actual pixel data; the surface should be locked by SDL_LockSurface() before accessing this field (read-write)
Application data associated with the surface
void*	userdata	an arbitrary pointer you can set (read-write)
Information needed for surfaces requiring locks
int	locked	read-only
void*	lock_data	read-only
Clipping information
SDL_Rect	clip_rect	an SDL_Rect structure used to clip blits to the surface which can be set by SDL_SetClipRect() (read-only)
Info for fast blit mapping to other surfaces
SDL_BlitMap*	map	internal
Format version, bumped at every change to invalidate blit maps
int	format_version	internal
Used when freeing surface
int	refcount	internal reference count that can be incremented by the application

You can add your code example here

-  ⇤ ← Revision 13 as of 2010-12-12 19:57:17 → 
  Size: 3920
  Editor: SheenaSmith
  Comment: temp
+   ← Revision 14 as of 2010-12-12 20:08:37 → ⇥
  Size: 3315
  Editor: SheenaSmith
  Comment: update content - w/ Sam
-Deletions are marked like this.
+Additions are marked like this.
 Line 26:
-||<style="color: #808080;">unsigned int ^Uint?^||<style="color: #808080;">'''format_version'''||<style="color: #808080;">internal||
||<:bgcolor="#EDEDED"-3>'',,Reference count --,, used when freeing surface''||
+||<style="color: #808080;">int||<style="color: #808080;">'''format_version'''||<style="color: #808080;">internal||
||<:bgcolor="#EDEDED"-3>''Used when freeing surface''||
 Line 35:
-<<Color2(green,Should any of the User Comments from the old wiki be included here?)>>
-Line 38:
+Line 37:
-An [[SDL_Surface]] structure represents an area of graphical memory that can be drawn to.
+''You can add useful comments here''
-Line 40:
+Line 39:
-This structure should be treated as read-only, except for '''pixels''' which, if not NULL, contains the raw pixel data for the surface.

<<Color2(green,Should [[SDL_PixelFormat]] be included here and linked to the data fields?)>>
-Line 49:
+Line 45:
- .[[SDL_BlendCircle]]
 .[[SDL_BlendEllipse]]
 .[[SDL_BlendFillCircle]]
 .[[SDL_BlendFillEllipse]]
-Line 64:
+Line 56:
- .[[SDL_DrawCircle]]
 .[[SDL_DrawEllipse]]
-Line 72:
+Line 62:
- .[[SDL_FillCircle]]
 .[[SDL_FillEllipse]]