SDL_SetVideoMode

[funkcja] Tworzy bufor będący powierzchnią ekranu.

Składnia

#include <sdl/SDL.h>

SDL_Surface * SDL_SetVideoMode( int width, int height, int bitsperpixel, Uint32 flags );

Argumenty

Argument Opis

int width Szerokość ekranu wyrażona w pikselach.

int height Wysokość ekranu wyrażona w pikselach.

int bitsperpixel Liczba bitów zajmowana przez jeden piksel. Gdy wartość wynosi 0 to funkcja ustawi liczbę bitów zgodną z aktualnym ustawieniem systemowym.

Uint32 flags

Flagi określające szczegółową konfigurację tworzonego bufora. Funkcja SDL_SetVideoModeprzyjmuje te same flagi co _{» SDL 1.2 ♦}SDL_Surface. Flagi można łączyć za pomocą operatora logicznego lub. Opis znaczenia flag:

Nazwa	Opis
SDL_SWSURFACE	Powierzchnia umieszczona w pamięci systemowej.
SDL_HWSURFACE	Powierzchnia umieszczona w pamięci karty graficznej.
SDL_ASYNCBLIT	Powierzchnia wykorzystuje asynchroniczne przesyłanie danych na ekran gdy jest taka możliwość.
SDL_PREALLOC	Powierzchnia, która wykorzystuje wcześniej zaalokowaną pamięć.
SDL_RLEACCEL	Przyśpieszenie operacji na powierzchni, wykorzystującej klucze kolorów RLE.
SDL_SRCALPHA	Wykorzystanie przeźroczystości kanału alfa.
SDL_SRCCOLORKEY	Aktualizuj powierzchnię za pomocą kluczy kolorów.
SDL_HWACCEL	Aktualizuj powierzchnię przy pomocy sprzętowego akceleratora graficzny karty.
SDL_RESIZABLE	Mozliwość zmiany rozmiaru powierzchni.
SDL_OPENGLBLIT	Wspieraj aktualizacje powierzchni przy pomocy OpenGL.
SDL_OPENGL	Powierzchnia współpracuje z OpenGL.
SDL_FULLSCREEN	Powierzchnia zajmuje cały ekran.
SDL_DOUBLEBUF	Podwójnie buforowanie powierzchni.
SDL_HWPALETTE	Powierzchnia posiada własną paletę kolorów.
SDL_ANYFORMAT	Dowolny format pikseli.

Zwracana wartość

Zwraca wskaźnik na utworzoną powierzchnię w przypadku sukcesu. W przeciwnym wypadku funkcja zwraca NULL.

Powierzchnia, która została zwrócona przez funkcję nie może być zwalniana ręcznie. Powierzchnia zostanie zwolniona automatycznie przez funkcję _{» SDL 1.2 ♦}SDL_Quit.

Opis szczegółowy

Funkcja tworzy bufor będący powierzchnią ekranu.

Dodatkowe informacje

Niniejsza funkcja powinna być wywoływana w głównym wątku aplikacji.
Podczas manipulacji poszczególnymi pikselami powierzchni ekranowej bądź kopiowaniu powierzchni z kanałem przeźroczystości zaleca się użycie flagi SDL_SWSURFACE by uniknąć narzutów spowodowanych kopiowaniem powierzchni między pamięcią karty graficznej a pamięcią RAM.
Flagę SDL_HWSURFACE najlepiej używać wtedy, kiedy kopiowane powierzchnie znajdują się w pamięci karty graficznej.

Nadawanie początkowego położenia okna

Jeżeli chcesz kontrolować położenie tworzonego okna na ekranie to możesz to zrobić za pomocą funkcji _{» SDL 1.2 ♦}SDL_putenv ustawiając odpowiednie zmienne środowiskowe biblioteki SDL. Pamiętaj, że pozycję należy ustawić zanim zostanie wywołana funkcja SDL_SetVideoMode.

Okno wycentrowane

SDL_putenv( "SDL_VIDEO_CENTERED=center" );

Okno na określonej pozycji

SDL_putenv( "SDL_VIDEO_WINDOW_POS=10,20" );

Przykład

#include <iostream>
#include <sdl/SDL.h>

int main( int argc, char * args[] )
{
SDL_Init( SDL_INIT_VIDEO );

SDL_Surface * ekran = SDL_SetVideoMode( 640, 480, 32, SDL_DOUBLEBUF | SDL_FULLSCREEN );

if( ekran == NULL )
{
std::cout << "Inicjalizacja powierzchni ekranowej powiodła się";
} else
{
std::cout << "Inicjalizacja powierzchni ekranowej nie powiodła się: " << SDL_GetError();
}

SDL_Quit();

return 0;
}

Zagadnienia powiązane

SDL_Surface	Przechowuje informacje o powierzchni. (struktura)
SDL_putenv	Modyfikuje wartości zmiennych środowiskowych biblioteki SDL. (funkcja)
SDL_Init	Inicjalizuje bibliotekę SDL. (funkcja)
SDL_Quit	Kończy pracę z biblioteką SDL. (funkcja)

Linki zewnętrzne

https://www.libsdl.org/release/SDL-1.2.15/docs/html/sdlsetvideomode.html

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.