SDL BlitSurface

SDL_BlitSurface

Name

SDL_BlitSurface - Führt einen schnellen Kopiervorgang zwischen Surfaces durch. Ab Version 1.

Delphi-Spezifikation

function SDL_BlitSurface(src : PSDL_Surface; srcrect : PSDL_Rect; 
                         dst : PSDL_Surface; dstrect : PSDL_Rect) : integer

Parameter

src	Quellsurface, von der kopiert wird
srcrect	siehe unten
dst	Zielsurface, auf die kopiert wird
dstrect	siehe unten

Beschreibung

SDL_BlitSurface führt einen schnellen Kopiervorgang von der Quellsurface auf die Zielsurface. Dabei wird w und h von srcrect für die Höhe und Breite und x und y von dstrect für die obere rechte Ecke des Kopierbereichs verwendet.

Wenn srcrect gleich nil ist, dann wird die komplette Quellsurface kopiert. Wenn dstrect gleich nil ist, dann sind die Koordinaten (0,0), also die obere linke Ecke der Zielsurface.

Der endgültige Kopierbereich wird, nachdem jegliches Clipping durchgeführt wurde, in dstrect gespeichert. (srcrect wird nicht verändert)

Das Ergebnis der Blit-Funktion variiert nach der SDL_SRCALPHA Option (Siehe SDL_SetAlpha für eine Erklärung der Beeinflussung)

Hinweise

Bitte beachten, dass diese Funktion keine Streckung oder Stauchung durchführen kann. Außerdem sollte sie (wie die meisten SDL-Surfacefunktionen) nicht zusammen mit OpenGL verwendet werden!

SDL_BlitSurface sollte nicht mit einem gelocktem Surface durchgeführt werden.

Rückgabewert

Die Funktion gibt 0 zurück, wenn kein Fehler aufgetreten ist, ansonsten -1.

Wenn die Surface im Videospeicher liegt und die Funktion -2 zurückgibt, dann ist der Zugriff auf den Videospeicher verloren gegangen.

Siehe auch

SDL_FillRect, SDL_Rect, SDL_SetAlpha, SDL_SetColorKey, SDL_Surface