Grafika komputerowa: SDL_CreateRGBSurfaceWithFormat

Użyj tej funkcji do przydzielania powierzchni RGB.

Składnia

SDL_Surface* SDL_CreateRGBSurfaceWithFormat(Uint32 flags,
                                            int    width,
                                            int    height,
                                            int    depth,
                                            Uint32 format)

Parametry funkcji

flags	znaczniki są przestarzałe i powinny być ustawione na 0.
width	szerokość w pikselach powierzchni do utworzenia.
height	wysokość w pikselach powierzchni do utworzenia.
depth	głębokość koloru w bitach powierzchni do utworzenia.
format	format pikseli powierzchni do utworzenia.

Wartość zwracana

Zwraca nową strukturę SDL_Surface, która jest tworzona, lub NULL przy błędzie; wywołaj funkcję SDL_GetError(), aby otrzymać więcej informacji na temat błędu.

Przykładowy kod

    /* Utwórz 32-bitową powierzchnię z bajtami dla każdego piksela w kolejności R,G,B,A,
       czego oczekuje OpenGL w teksturach */

    SDL_Surface* surf;
    surf = SDL_CreateRGBSurfaceWithFormat(0, width, height, 32, SDL_PIXELFORMAT_RGBA32);
    if (surf == NULL)
    {
        SDL_Log("SDL_CreateRGBSurfaceWithFormat() failed: %s", SDL_GetError());
        exit(1);
    }

Uwagi

Jeśli funkcji skończy się pamięć, zwróci NULL.

Wersja

Funkcja dostępna od SDL 2.0.5.

Powiązane funkcje

SDL_CreateRGBSurface
SDL_CreateRGBSurfaceWithFormatFrom
SDL_FreeSurface

do podrozdziału do 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: