16.6 Bitmap laden und anzeigen
 
Eine unkomprimierte Bitmap-Datei anzuzeigen ist in SDL keine Kunst. Hierfür werden lediglich zwei Funktionen benötigt. Zuerst müssen Sie die Funktion SDL_LoadBMP() zum Laden einer unkomprimierten Bitmap (Bilder mit der Extension *.bmp) verwenden.
SDL_Surface *SDL_LoadBMP(const char *file);
Als Parameter geben Sie die Datei (eventuell inklusive mit Pfad) an, die geladen werden soll. Zurück bekommen Sie anschließend einen Zeiger auf ein NEUES Surface, bei einem Fehler wird NULL zurückgegeben.
Anschließend müssen Sie das neu erhaltene Surface in das bereits vorhandene kopieren. Dies realisieren Sie mit der Funktion SDL_BlitSurface().
int SDL_BlitSurface( SDL_Surface *src, SDL_Rect *srcrect,
SDL_Surface *dst, SDL_Rect *dstrect );
Damit kopieren Sie den Bildausschnitt von Surface src in das Surface dst. Wird bei den Parametern srcrect und dstrect nicht NULL übergeben (was bedeutet, dass der komplette Bildausschnitt kopiert wird), können Sie je einen Zeiger auf eine Struktur vom Typ SDL_Rect übergeben. Damit können Sie die Größe des zu kopierenden Bildausschnitts von src nach dst angeben – also Bildausschnitte kopieren oder darstellen. Darauf wird noch eingegangen. Die Funktion wandelt, falls notwendig, außerdem auch andere, verschiedene Bildformate automatisch ineinander um. Es ist allerdings nicht möglich, den Bildausschnitt damit zu strecken oder zu stauchen! Bei Erfolg gibt diese Funktion 0, ansonsten bei Auftreten eines Fehlers –1 zurück.
Natürlich muss, um das Bild überhaupt anzeigen zu können, zuvor wieder die Funktion SDL_UpdateRect() aufgerufen werden – damit die Veränderungen auch auf dem Bildschirm gemacht werden.
Wenn Sie mit dem Surface fertig sind, sollten Sie die Ressourcen wieder freigeben. Dies können Sie mit einem Funktionsaufruf von SDL_FreeSurface() erledigen.
void SDL_FreeSurface(SDL_Surface *surface);
16.6.1 Programmbeispiel – Bitmap laden und anzeigen
 
Das folgende Beispiel stellt eine einfache Form einer Slideshow dar. Alle BMP-Dateien, die Sie in der Kommandozeile angegeben haben, werden für 1000 Millisekunden auf dem Bildschirm angezeigt. Es wurde außerdem bei der Funktion SDL_SetVideoMode() das Flag SDL_RESIZABLE verwendet, womit Sie den Videomodus im laufenden Betrieb verändern können. Das neue (Haupt-)Surface wird dann entsprechend der Bildgröße angepasst. Ansonsten werden alle Funktionen, die Sie bereits kennen gelernt haben, verwendet.
/* sdl3.c */
#include <SDL/SDL.h>
#include <stdio.h>
#include <stdlib.h>
#include <unistd. h.>
static void display_bmp( const char *datei, SDL_Surface *screen,
int x, int y) {
SDL_Surface *bild;
SDL_Rect ziel;
/* lädt die BMP-Datei in ein Surface */
bild = SDL_LoadBMP(datei);
if ( bild == NULL ) {
fprintf(stderr, "'%s' konnte nicht geladen werden: %s\n",
datei, SDL_GetError());
return;
}
/* auf den Bildschirm kopieren */
/* die Surfaces sollten hier nicht gelockt sein. */
/* x,y = linke obere Ecke; w, h = Breite und Höhe */
ziel.x = x;
ziel.y = y;
ziel.w = bild->w;
ziel.h = bild->h;
/* Neue Größe des Surfaces entsprechend der Bildgröße */
screen = SDL_SetVideoMode (bild->w, bild->h,
16, SDL_SWSURFACE | SDL_RESIZABLE);
if (screen == NULL) {
printf ("Videomodus konnte nicht verändert werden: %s\n",
SDL_GetError ());
exit(EXIT_FAILURE);
}
SDL_BlitSurface(bild, NULL, screen, &ziel);
/* den veränderten Bildschirmbereich auffrischen */
SDL_UpdateRect(screen, 0, 0, 0, 0);
SDL_FreeSurface(bild);
}
int main (int argc, char **argv) {
SDL_Surface *screen;
int i;
if( argc == 1 ) {
printf("Bitte mindestens eine BMP-Datei angeben!\n");
return EXIT_FAILURE;
}
/* SDLs Videosystem initialisieren und auf Fehler prüfen */
if (SDL_Init (SDL_INIT_VIDEO) != 0) {
printf ("Konnte SDL nicht initialisieren: %s\n",
SDL_GetError ());
return EXIT_FAILURE;
}
/* Wenn die Anwendung beendet wird, */
/* wird die Funktion SDL_Quit() ausgeführt */
atexit (SDL_Quit);
/* Videomodus mit 640 x 480 Pixel, Hi-Color (16 Bit) */
/* einrichten. Oberfläche (Surface) standardmäßig */
/* in den Hauptspeicher (SDL_SWSURFACE) legen */
screen = SDL_SetVideoMode (640, 480, 16,
SDL_SWSURFACE|SDL_RESIZABLE);
if (screen == NULL) {
printf ("Videomodus konnte nicht eingerichtet werden: "
" %s\n", SDL_GetError ());
return EXIT_FAILURE;
}
/* Slideshow starten ... */
/* Zeigt alle BMP-Bilddateien an, die in der Kommandozeile */
/* mit angegeben wurden */
for( i = 1; argv[i] != NULL; i++) {
display_bmp(argv[i], screen, 0, 0 );
SDL_Delay (4000);
}
printf ("Erfolgreich beendet!\n");
return EXIT_SUCCESS;
}
Das Programm bei der Ausführung:
$ gcc `sdl-config --libs` `sdl-config --cflags` -o sdl3 sdl3.c
$ ./sdl3 john.bmp john2.bmp
|