|
Size: 1993
Comment: copy & adapt code example from SDL_CreateRGBSurface()
|
Size: 2009
Comment: Fixed log message in example.
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 45: | Line 45: |
| fprintf(stderr, "CreateRGBSurface failed: %s\n", SDL_GetError()); | fprintf(stderr, "SDL_CreateRGBSurfaceWithFormat() failed: %s\n", SDL_GetError()); |
DRAFT |
SDL_CreateRGBSurfaceWithFormat
Use this function to allocate an RGB surface.
Contents
Syntax
SDL_Surface* SDL_CreateRGBSurfaceWithFormat(Uint32 flags,
int width,
int height,
int depth,
Uint32 format)
Function Parameters
flags |
the flags are obsolete and should be set to 0 |
width |
the width in pixels of the surface to create |
height |
the height in pixels of the surface to create |
depth |
the depth in bits of the surface to create |
format |
the pixel format of the surface to create |
Return Value
Returns a new SDL_Surface on success or NULL on failure; call SDL_GetError() for more information.
Code Examples
/* Create a 32-bit surface with the bytes of each pixel in R,G,B,A order,
as expected by OpenGL for textures */
SDL_Surface* surf;
surf = SDL_CreateRGBSurfaceWithFormat(0, width, height, 32, SDL_PIXELFORMAT_RGBA32);
if(surf == NULL) {
fprintf(stderr, "SDL_CreateRGBSurfaceWithFormat() failed: %s\n", SDL_GetError());
exit(1);
}
Remarks
If the function runs out of memory, it will return NULL.
Version
This function is available since SDL 2.0.5.
