SDL_Surface

[struktura] Przechowuje informacje o powierzchni.

Składnia

#include <sdl/SDL.h>

typedef struct SDL_Surface
{
Uint32 flags;
SDL_PixelFormat * format;
int w, h;
Uint16 pitch;
void * pixels;

int offset;
struct private_hwdata * hwdata;

SDL_Rect clip_rect;

Uint32 unused1;
Uint32 locked;
struct SDL_BlitMap * map;
unsigned int format_version;

int refcount;
} SDL_Surface;

Opis szczegółowy

Struktura przechowująca informacje o obrazie. W bibliotece SDL obraz określony został terminem powierzchnia (ang. surface).

Pola struktury

Pole	Opis
Uint32 flags	Parametry powierzchni graficznej ustawiane za pomocą zdefiniowanych stałych. Stałe są flagami bitowymi.
SDL_PixelFormat* format	Adres struktury _{» SDL 1.2 ♦}SDL_PixelFormat.
int w,h	Szerokość i wysokość powierzchni mierzona w pikselach.
Uint16 pitch	Pole określa liczbę bajtów na jedną linię ekranową, pomaga w obliczaniu początkowego adresu dowolnego wiersza obrazu.
void* pixels	Wskaźnik na obszar pamięci przechowywujący bufor obrazu. Dostęp do powieszchni powinien być blokowany za pomocą funkcji _{» SDL 1.2 ♦}SDL_LockSurface przed uzyskaniem dostępu do tego pola.
int offset	Pole prywatne.
struct private_hwdata *hwdata	Pole prywatne.
SDL_Rect clip_rect	Obiekt struktury `SDL_Rect` za pomocą której możemy obciąć obszar tekstury. Więcej szczegółów na ten temat w funkcji _{» SDL 1.2 ♦}SDL_SetClipRect.
Uint32 unused1	Pole prywatne.
Uint32 locked	Pole prywatne.
struct SDL_BlitMap *map	Pole prywatne.
unsigned int format_version	Pole prywatne.
int refcount	Licznik odwołań do struktury SDL_Surface. Wykorzystywany przy zwalnianiu pamięci.

Flagi dla pola struktury `flags`

Opis poszczególnych stałych zdefiniowanych jako flagi:

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.

Przykład

SDL_Surface * pPowierzchnia = null;
//(...)
pPowierzchnia = SDL_LoadBMP( "grafika.bmp" );
//(...)
SDL_FreeSurface( pPowierzchnia );

Zagadnienia powiązane

SDL_Rect	Definiuje obszar w kształcie prostokąta. (struktura)
SDL_PixelFormat	Opisuje format zapisu pikseli. (struktura)
SDL_LoadBMP	Wczytuje powierzchnię z pliku w formacie BMP. (funkcja)
SDL_FreeSurface	Zwalnia pamięć zajmowaną przez powierzchnię. (funkcja)

Linki zewnętrzne

https://www.libsdl.org/release/SDL-1.2.15/docs/html/sdlsurface.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.