DRAFT

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