BasicC/Okno

SDLOpen(flags)

Komenda inicjuje SDL i otwiera okno graficzne, wykonuje następujące czynności:

• Inicjuje SDL i wszystkie jego komponenty komendą SDL_Init, w razie niepowodzenia przerywa program z błędem 1.
• Komendą SDL_CreateWindowAndRenderer otwiera okno i tworzy tzw. renderer, zwany dalej projektorem. Okno ma wymiary zdefiniowane stałymi WINDOWW i WINDOWH, domyślnie 640x400 pikseli. Parametr flags zawiera właściwości okna opisane poniżej. Wskaźnik na obiekt okna zawiera zmienna SDLWindow. Wskaźnik na obiekt projektora zawiera zmienna SDLRenderer. Projektor jest obiektem związanym z oknem, na którym wyświetlana jest akcelerowana sprzętowo grafika. Domyślnie włączona jest synchronizacja projektora z odświeżaniem monitora.
• Czyści projektor, czyli wypełnia go domyślnym kolorem - czarnym, komendą SDL_RenderClear.
• Zatrzymuje tryb wprowadzania tekstu.
• W zmiennej strukturalnej Display zapisuje parametry wyświetlacza.
• Inicjuje dostępne joysticki komendą SDL_JoystickOpen. Maksymalna ich ilość zapisana jest w stałej MAXJOYS, domyślnie 4.
• Zmiennej SDLTouchID przypisuje wskaźnik pierwszego urządzenia dotykowego.
• Inicjuje wybrany system dźwiękowy, jeśli załączona jest odpowiednia biblioteka - BasicSND lub SDL_MIXER.
• Komendą SDL_LoadBMP ładowany jest obraz BASFont.bmp zawierający czcionki bitmapowe i ustawiana jest jego przeźroczystość. Obraz ten jest konwertowany na tzw. teksturę i przypisany do zmiennej BASFont.
• Inicjuje obsługę czcionek TTF, jeśli załączona jest biblioteka SDL_TTF.

Parametr flags może być jedną z wartości połączonych alternatywą bitową (|):

SDL_WINDOW_FULLSCREEN okno pełnoekranowe.
SDL_WINDOW_FULLSCREEN_DESKTOP okno pełnoekranowe w bieżącej rozdzielczości pulpitu.
SDL_WINDOW_OPENGL okno do użytku z kontekstem OpenGL.
SDL_WINDOW_HIDDEN okno ukryte.
SDL_WINDOW_BORDERLESS okno bez dodatków.
SDL_WINDOW_RESIZABLE możliwa zmiana wielkości okna.
SDL_WINDOW_MINIMIZED okno zminimalizowane.
SDL_WINDOW_MAXIMIZED okno zmaksymalizowanie.
SDL_WINDOW_INPUT_GRABBED okno z przechwyconym skupieniem wejścia.
SDL_WINDOW_ALLOW_HIGHDPI okno powinno być utworzone w trybie high-DPI, jeśli jest wspierany.

BasicC obsługuje tylko 1 okno. Więcej okien można obsługiwać standardowymi komendami SDL.
W systemach nie obsługujących typowych okien, np. Android, okno ma wymiary całego pulpitu bez względu na wartości WINDOWW i WINDOWH.
Przed wyjściem z programu należy usunąć stworzone obiekty SDL, takie jak obrazy (tekstury), i zakończyć SDL komendą SDLQuit.
Po wykonaniu SDLOpen zmienna SDLSurface wskazuje na obraz typu SDL_Surface zawierający czcionki. Można to wykorzystać do stworzenia czcionki odwróconej komendą InvertImgSurface(SDLSurface,OC), gdzie OC jest zmienną typu SDL_Texture, która będzie wskazywała na obraz odwróconej czcionki, należy ją wcześniej zadeklarować. Jest to zalecana metoda, gdyż tryb mieszania SDL_BLENDMODE_REV nie zawsze jest dostępny.

GetDisplayMode

Wywołuje komendę SDL_GetCurrentDisplayMode(0,&Display);
W zmiennej Display zapisane zostają parametry wyświetlacza (monitora):
Display.w - rozdzielczość pozioma
Display.h - rozdzielczość pionowa
Display.refresh_rate - częstotliwość odświeżania
Display.driverdata - dane sterownika grafiki

CenterWindow

Ustawia okno na środku ekranu komendą SDL_SetWindowPosition(SDLWindow, SDL_WINDOWPOS_CENTERED, SDL_WINDOWPOS_CENTERED);

CloseWindow

Usuwa okno komendą SDL_DestroyWindow(SDL_Window);

FullscreenWindow

Powiększa okno bez ramek do rozmiarów pulpitu komendą SDL_SetWindowFullscreen(SDLWindow, SDL_WINDOW_FULLSCREEN_DESKTOP);

GetWindowSize(w,h)

Zapisuje w zmiennych w i h wymiary okna głównego komendą SDL_GetWindowSize(SDLWindow,&w,&h);

MaximizeWindow

Powiększa okno do rozmiarów pulpitu (z ramkami) komendą SDL_MaximizeWindow(SDLWindow);

MinimizeWindow

Minimalizuje okno komendą SDL_MinimizeWindow(SDLWindow);

RestoreWindow

Przywraca poprzednią wielkość okna komendą SDL_RestoreWindow(SDLWindow);

WindowPos(x,y)

Ustawia okno w pozycji x,y komendą SDL_SetWindowPosition(SDLWindow,x,y);

WindowSize(w,h)

Ustawia szerokość w i wysokość h okna komendą SDL_SetWindowSize(SDLWindow,w,h);

WindowTitle(t)

Ustawia tytuł t okna.

WindowVirtualSize(w,h)

Ustawia wirtualną szerokość w i wysokość h okna komendą SDL_RenderSetLogicalSize(SDLRenderer,w,h);
Okno dowolnej wielkości traktowane jest tak, jak by miało rozmiar w, h. Powoduje odpowiednie skalowanie współrzędnych graficznych.

Przykład:

#include "BasicSDL.h"

MAIN
  SDLOpen(0)
  GetDisplayMode
  WindowSize(Display.w/2,Display.h/2)
  CenterWindow
  GPrintAt(300,300,"BasicC")
  ShowPage
  WaitInKey
  SDLQuit
ENDMAIN