Function sdl2_sys::SDL_CreateRGBSurfaceWithFormatFrom

pub unsafe extern "C" fn SDL_CreateRGBSurfaceWithFormatFrom(
    pixels: *mut c_void,
    width: c_int,
    height: c_int,
    depth: c_int,
    pitch: c_int,
    format: Uint32,
) -> *mut SDL_Surface

Allocate a new RGB surface with with a specific pixel format and existing pixel data.

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

No copy is made of the pixel data. Pixel data is not managed automatically; you must free the surface before you free the pixel data.

\param pixels a pointer to existing pixel data \param width the width of the surface \param height the height of the surface \param depth the depth of the surface in bits \param pitch the pitch of the surface in bytes \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_CreateRGBSurfaceFrom \sa SDL_CreateRGBSurfaceWithFormat \sa SDL_FreeSurface