SDL_DisplayFormat

SDL_DisplayFormat kopiert die übergebene surface welche Beispielsweise durch SDL_LoadBMP aus einer Bitmap Datei geladen werden kann, in eine neue SDL_Surface Struktur und konvertiert sie dabei in das Format des Videobuffers. Dadurch wird das blitten mit zum Beispiel SDL_BlitSurface auf den Bildschirm beschleunigt, da dabei keine rechenaufwendige Konvertierung mehr durchgeführt werden muss.

Signatur

#include <SDL.h>
 
SDL_Surface* SDL_DisplayFormat(SDL_Surface *surface);

Parameter

surface

Zeiger auf die zu optimierende SDL_Surface Struktur.

Rückgabewert

  • Eine neue SDL_Surface Struktur gefüllt mit dem konvertierten Bild.
  • NULL: Konvertierung fehlgeschlagen oder zu wenig Speicher vorhanden.

Beispiel