SDL LockSurface

SDL_LockSurface

Name

SDL_LockSurface - Schliesst eine Surface für direkten Zugriff

Delphi-Spezifikation

function SDL_LockSurface(surface: PSDL_Surface): Integer

Parameter

surface	Die gewünsche Surface

Beschreibung

SDL_LockSurface erlaubt direkten Lese- und Schreibzugriff auf die einzelnen Pixel. Nachdem man mit dem Zugriff fertig ist, muss man SDL_UnlockSurface benutzen um sie zu entsperren.

Hinweise

Nicht alle Surfaces müssen gesperrt werden. Wenn SDL_MustLock(surface) gleich 0 ist, dann kann auf die Surface zugegriffen werden, ohne dass sie gesperrt werden muss.

Seit SDL 1.1.8 sind die Sperren rekursiv. Dies bedeutet, dass man bei 2-maligen Sperren auch 2-mal Entsperren muss.

Rückgabewert

SDL_LockSurface gibt 0 bei Erfolg und -1 bei einem Fehler zurück.

Siehe auch

SDL_UnlockSurface