This bug report was migrated from our old Bugzilla tracker.

These attachments are available in the static archive:

• [add SDL_CreateRGBSurfaceWithFormatFrom (sdl2_CreateRGBSurfaceWithFormat.diff, text/plain, 2015-03-26 03:57:58 +0000, 5993 bytes)](https://bugzilla.libsdl.org/attachment.cgi?id=2089)

Reported in version: HG 2.0
Reported for operating system, platform: All, All

Comments on the original bug report:

On 2015-03-26 03:57:58 +0000, Daniel Gibson wrote:

Created attachment 2089
add SDL_CreateRGBSurfaceWithFormatFrom

Currently, SDL_CreateRGBSurface() and SDL_CreateRGBSurfaceFrom() take Uint32 masks for RGBA to "describe" the Pixelformat of the surface.
Internally those value are only used to map to one of the SDL_PIXELFORMAT_* enum values that are used for further processing.

I think it would be both handy and more efficient to be able to specify SDL_PIXELFORMAT_* yourself without using SDL_PixelFormatEnumToMasks() to create masks first, so I implemented functions that do that:
SDL_CreateRGBSurfaceWithFormat() and SDL_CreateRGBSurfaceWithFormatFrom() which are like the versions without "WithFormat" but instead of taking 4 Uint32s for R/G/B/A masks, they take one for a SDL_PIXELFORMAT_* enum value.

Together with https://bugzilla.libsdl.org/show_bug.cgi?id=2923 creating a SDL_Surface* from RGBA data (e.g. from stb_image) is as easy as
surf = SDL_SDL_CreateRGBSurfaceWithFormat(0, w, h, bppToUse*8, SDL_PIXELFORMAT_RGBA32);

On 2015-03-26 04:00:21 +0000, Daniel Gibson wrote:

Oh by the way, some discussion about this: https://forums.libsdl.org/viewtopic.php?t=11123

On 2016-10-08 00:05:25 +0000, Sam Lantinga wrote:

API added, thanks!
https://hg.libsdl.org/SDL/rev/f99f58ef8363

On 2016-10-08 00:27:02 +0000, Daniel Gibson wrote:

Thank you! :-)