THIS PAGE IS A WORK IN PROGRESS ... Please make edits to this page to improve it!
Allocate a new RGB surface with a specific pixel format.
SDL_Surface* SDL_CreateRGBSurfaceWithFormatint width, int height, int depth, Uint32 format); (Uint32 flags,
flags |
the flags are unused and should be set to 0 |
width |
the width of the surface |
height |
the height of the surface |
depth |
the depth of the surface in bits |
format |
the SDL_PixelFormatEnum for the new surface's pixel format. |
Returns the new SDL_Surface structure that is created or NULL if it fails; call SDL_GetError() for more information.
This function operates mostly like SDL_CreateRGBSurface(), except instead of providing pixel color masks, you provide it with a predefined format from SDL_PixelFormatEnum.
This function is available since SDL 2.0.5.
/* 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;0, width, height, 32, SDL_PIXELFORMAT_RGBA32);
surf = SDL_CreateRGBSurfaceWithFormat(if (surf == NULL) {
"SDL_CreateRGBSurfaceWithFormat() failed: %s", SDL_GetError());
SDL_Log(1);
exit( }
CategoryAPI, CategorySurface, CategoryDraft