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} -or- ^{the [[SDL_PixelFormat]] of the pixels stored in the surface} (read-only)
int	w, h	the surface width and height in pixels (read-only)
int	pitch	the length of a surface 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	_{a pointer to user-specified content???} (read-write)
Information needed for surfaces requiring locks
int	locked	read-only
void*	lock_data	read-only
Clipping information
SDL_Rect	clip_rect	the surface clip rectangle 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
unsigned int ^Uint?	format_version	internal
_{Reference count --} used when freeing surface
int	refcount	read-mostly

You can add your code example here

green

An SDL_Surface structure represents an area of graphical memory that can be drawn to.

This structure should be treated as read-only, except for pixels which, if not NULL, contains the raw pixel data for the surface.

green

-  ⇤ ← Revision 11 as of 2010-11-01 04:43:31 → 
  Size: 3553
  Editor: SheenaSmith
  Comment: update content - old wiki
+   ← Revision 12 as of 2010-12-12 18:20:22 → ⇥
  Size: 3732
  Editor: SheenaSmith
  Comment: minor change
-Deletions are marked like this.
+Additions are marked like this.
 Line 12:
-||[[SDL_PixelFormat]]*||'''format'''||the format of the pixels stored in the surface; ,,see [[SDL_PixelFormat]],, (read-only)||
+||[[SDL_PixelFormat]]*||'''format'''||,,the format of the pixels stored in the surface; see [[SDL_PixelFormat]] for details,, ''-or-'' ^the [[SDL_PixelFormat]] of the pixels stored in the surface^ (read-only)||
 Line 41:
+<<Color2(green,Should [[SDL_PixelFormat]] be included here and linked to the data fields?)>>