Wiki Page Content

Revision 11 as of 2010-11-01 04:43:31

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]] (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

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.


CategoryStruct, CategorySurface

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