Grafika komputerowa: SDL

Użyj tej funkcji, aby przygotować powierzchnię graficzną do bezpośredniego dostępu do jej pikseli.

Składnia

int SDL_LockSurface(SDL_Surface* surface)

Parametry funkcji

surface

powierzchnia SDL_Surface do rezerwacji.

Wartość zwracana

Zwraca 0 przy sukcesie lub ujemny kod błędu przy niepowodzeniu; wywołaj funkcję SDL_GetError(), aby otrzymać więcej informacji na temat błędu.

Przykładowy kod

/* Przygotuj wskaźnik pikseli dla powierzchni */

SDL_LockSurface(surface);

/* Powierzchnia jest zarezerwowana */
/* Tutaj nastąpi bezpośredni dostęp do pikseli */

SDL_UnlockSurface(surface);

/* Teraz powierzchnia jest odblokowana */

Uwagi

Pomiędzy wywołaniami funkcji SDL_LockSurface()/SDL_UnlockSurface() możesz zapisywać i odczytywać z surface->pixels przy użyciu formatu zapisanego w surface->format. Po zakończeniu dostępu do powierzchni powinieneś użyć funkcji SDL_UnlockSurface(), aby ją odblokować.

Nie wszystkie powierzchnie wymagają rezerwacji. Jeśli makro SDL_MUSTLOCK(surface) da wynik 0, to możesz zapisywać i odczytywać z powierzchni w dowolnej chwili, a format pikseli nie będzie się zmieniał.

Wersja

Funkcja dostępna od SDL 2.0.0.

Powiązane funkcje

SDL_MUSTLOCK
SDL_UnlockSurface

Na początek: podrozdziału strony

Materiały tylko do użytku dydaktycznego. Ich kopiowanie i powielanie jest dozwolone
pod warunkiem podania źródła oraz niepobierania za to pieniędzy.

Pytania proszę przesyłać na adres email: i-lo@eduinf.waw.pl

Serwis wykorzystuje pliki cookies. Jeśli nie chcesz ich otrzymywać, zablokuj je w swojej przeglądarce.

Informacje dodatkowe.

Interfejs SDL2: