home | help
SDL_ConvertSurface(3)		SDL API Reference	   SDL_ConvertSurface(3)

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

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 seman-
     tics.

     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

SDL			     Tue 11 Sep 2001, 23:01	   SDL_ConvertSurface(3)

home | help