Function SDL_CreateRGBSurfaceWithFormat

pub unsafe extern "C" fn SDL_CreateRGBSurfaceWithFormat(
    flags: u32,
    width: i32,
    height: i32,
    depth: i32,
    format: u32,
) -> *mut SDL_Surface
Available on crate feature dep_sdl2 only.
Expand description

Allocate a new RGB surface with a specific pixel format.

This function operates mostly like SDL_CreateRGBSurface(), except instead of providing pixel color masks, you provide it with a predefined format from SDL_PixelFormatEnum.

\param flags the flags are unused and should be set to 0 \param width the width of the surface \param height the height of the surface \param depth the depth of the surface in bits \param 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.

\since This function is available since SDL 2.0.5.

\sa SDL_CreateRGBSurface \sa SDL_CreateRGBSurfaceFrom \sa SDL_FreeSurface