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(3), SDL_DisplayFormat(3), SDL_PixelFormat(3), SDL_Surface(3)

COPYRIGHT

This manual page is taken from the SDL library, licensed under GNU LGPL.