NAME

       SDL_ConvertSurface - Converts a surface to the same format as another surface.

SYNOPSIS

       #include "SDL/SDL.h"

       SDL_Surface *SDL_ConvertSurface(SDL_Surface *src, SDL_PixelFormat *fmt, Uint32 flags);

DESCRIPTION

       Creates  a new surface of the specified format, and then copies and maps the given surface
       to it. If this function fails, it returns NULL.

       The flags parameter is passed to SDL_CreateRGBSurface and has those semantics.

       This function is used internally by SDL_DisplayFormat.

       This function can only be called after SDL_Init.

RETURN VALUE

       Returns either a pointer to the new surface, or NULL on error.

SEE ALSO

       SDL_CreateRGBSurface, SDL_DisplayFormat, SDL_PixelFormat, SDL_Surface