Wiki Page Content

Revision 13 as of 2010-12-12 19:57:17

Clear message

DRAFT

SDL_Surface

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

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

unsigned int Uint?

format_version

internal

Reference count -- used when freeing surface

int

refcount

internal reference count that can be incremented by the application

Code Examples

You can add your code example here

green

Remarks

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


CategoryStruct, CategorySurface

(Page Info.)
Feedback
Please include your contact information if you'd like to receive a reply.
Submit