current nightly

Sortix nightly manual

This manual documents Sortix nightly, a development build that has not been officially released. You can instead view this document in the latest official manual.

SDL_ConvertSurface(3)

SDL API Reference

SDL_ConvertSurface(3)

NAME

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

#include "SDL/SDL.h"

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

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.

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