|
Size: 3732
Comment: minor change
|
Size: 3920
Comment: temp
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 12: | Line 12: |
| ||[[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)|| |
||[[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)|| |
| Line 17: | Line 17: |
| ||void*||'''userdata'''||,,a pointer to user-specified content???,, (read-write)|| | ||void*||'''userdata'''||an arbitrary pointer you can set (read-write)|| |
| Line 19: | Line 19: |
| ||int||'''locked'''||read-only|| ||void*||'''lock_data'''||read-only|| |
||<style="color: #808080;">int||<style="color: #808080;">'''locked'''||<style="color: #808080;">read-only|| ||<style="color: #808080;">void*||<style="color: #808080;">'''lock_data'''||<style="color: #808080;">read-only|| |
| Line 22: | Line 22: |
| ||[[SDL_Rect]]||'''clip_rect'''||the surface clip rectangle which can be set by [[SDL_SetClipRect]]() (read-only)|| | ||[[SDL_Rect]]||'''clip_rect'''||an [[SDL_Rect]] structure used to clip blits to the surface which can be set by [[SDL_SetClipRect]]() (read-only)|| |
| Line 26: | Line 26: |
| ||unsigned int ^Uint?^||'''format_version'''||<style="color: #808080;">internal|| | ||<style="color: #808080;">unsigned int ^Uint?^||<style="color: #808080;">'''format_version'''||<style="color: #808080;">internal|| |
| Line 28: | Line 28: |
| ||int||'''refcount'''||read-mostly|| | ||int||'''refcount'''||internal reference count that can be incremented by the application|| |
DRAFT |
SDL_Surface
A structure that contains a collection of pixels used in software blitting.
Data Fields
Uint32 |
flags |
internal |
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 |
||
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
Related Structures
