Inicjalizacja i obs�uga b��d�w Pierwsze co musisz zrobi�, by skorzysta� z biblioteki SDL, to oczywi�cie do��czy� jej plik nag��wkowy, by zapozna� kompilator z zawarto�ci� tej biblioteki: #include Program u�ywaj�cy SDL zaczyna si� w normalnej, standardowej funkcji main ;-) Jest tak nawet gdy tworzysz projekt dla systemu Windows, bo wtedy SDL realizuje windowsow� funkcj� WinMain gdzie� w swoim wn�trzu. Takie rozwi�zanie jest konieczne, by mo�na by�o przenosi� kod pomi�dzy r�nymi platformami systemowymi bez �adnych zmian [inne systemy ni� Windows nie u�ywaj� przecie� tej niestandardowej funkcji WinMain :-P]. #include //Tu zaczyna si� nasz program u�ywaj�cy SDL int main() { //Tu b�dzie jego tre��... } Podsystemy biblioteki SDL Biblioteka SDL sk�ada si� z 8 podsystem�w, z kt�rych ka�dy odpowiada za co� innego. Przypomina tym troch� bibliotek� DirectX, jednak jak pewnie wiesz, s� mi�dzy nimi pewne r�nice ;-J Poni�ej masz list� tych podsystem�w wraz z opisem, czym si� zajmuje ka�dy z nich: VIDEO Podsystem odpowiedzialny za wy�wietlanie grafiki 2D AUDIO Podsystem odpowiedzialny za podstawow� obs�ug� d�wi�ku EVENTS Podsystem odpowiedzialny za obs�ug� zdarze� CDROM Podsystem odpowiedzialny za odtwarzanie muzyki CD-Audio i obs�ug� CD-ROMu JOYSTICK Podsystem obs�ugi joysticka TIMER Podsystem odmierzania czasu THREADS Podsystem odpowiedzialny za obs�ug� w�tk�w FILES Podsystem wej�cia/wyj�cia plikowego Prygotowanie do pracy Aby rozpocz�� zabaw� z SDL, trzeba j� najpierw zainicjalizowa� [przygotowa� do pracy]. Zanim wywo�asz jak�kolwiek funkcj� z biblioteki SDL, musisz wi�c najpierw wywo�a� funkcj� SDL_Init, kt�rej nag��wek prezentuje si� tak: int SDL_Init(Uint32 flags); Pozwala Ci ona wybra� podsystemy, z kt�rych masz zamiar korzysta� i przygotowuje je do pracy. Automatycznie przygotowuje trzy podsystemy: EVENTS, THREADS i FILES. Mo�esz wybra� dodatkowe podsystemy, podaj�c jej odpowiednie parametry, kt�re poznasz lada moment. Jak widzisz, funkcja SDL_Init pobiera tylko jeden parametr, jednak jego typ mo�e wydawa� ci si� dziwny :-P Biblioteka SDL wprowadza kilka nowych, w�asnych typ�w danych, by zapewni� jednakowy rozmiar danych w pami�ci na r�nych platformach. Typ Uint32 mo�esz rozumie� jako typ unsigned int z gwarancj�, �e zajmie 32 bity w pami�ci. Parametr ten s�u�y g��wnie do wybierania, kt�re podsystemy maj� by� dodatkowo zainicjalizowane, jednak ma te� kilka innych mo�liwo�ci. Mo�esz w nim przekaza� jedn� z poni�szych sta�ych: SDL_INIT_VIDEO Podsystem graficzny SDL_INIT_AUDIO Podsystem d�wi�ku SDL_INIT_TIMER Podsystem odmierzania czasu SDL_INIT_CDROM Podsystem obs�ugi CD-ROMu SDL_INIT_JOYSTICK Podsystem obs�ugi joysticka SDL_INIT_EVERYTHING Inicjalizuje wszystkie podsystemy SDL_INIT_NOPARACHUTE SDL nie b�dzie za ciebie obs�ugiwa� wyj�tk�w SDL_INIT_EVENTTHREAD Do odbierania zdarze� zostanie utworzony osobny w�tek Powy�sze sta�e s� flagami bitowymi, wi�c mo�esz je ��czy� operatorem |. Przyk�adowo inicjalizacja podsystem�w VIDEO i TIMER mog�aby wygl�da� tak: SDL_Init(SDL_INIT_VIDEO | SDL_INIT_TIMER); Funkcja zwraca 0 gdy inicjalizacja si� powiod�a. W przeciwnym razie zwraca -1. W��czanie/wy��czanie podsystem�w Czasami nie da si� zainicjalizowa� od razu wszystkiego. Przyk�adowo chcesz najpierw wy�wietli� menu gry, z kt�rego u�ytkownik wybierze czy chce skorzysta� z joysticka. Dopiero wtedy mo�na zainicjalizowa� podsystem joysticka. Co zrobi� w takiej sytuacji? Jak uruchomi� podsystem JOYSTICK, skoro funkcja SDL_Init by�a ju� wywo�ana?! :-/ Tw�rcy biblioteki przygotowali j� na takie sytuacje ;-) Mo�esz w��czy� dodatkowe podsystemy w p�niejszym czasie. S�u�y do tego funkcja SDL_InitSubSystem i pobiera ona dok�adnie te same parametry, co SDL_Init. Tak wygl�da jej nag��wek: int SDL_InitSubSystem(Uint32 flags); Gdy wszystko posz�o dobrze, zwraca 0. W przypadku b��du zwraca -1. Gdy dany podsystem przestaje ci by� potrzebny, mo�esz wy��czy� tylko ten jeden podsystem, pozostawiaj�c reszt�. Robi si� to funkcj� SDL_QuitSubSystem. Pobiera ona te same parametry, co poprzednie funkcje. Nie zwraca jednak �adnej warto�ci. To zreszt� logiczne, bo je�li chcesz wy��czy� jaki� podsystem i mia�oby si� to nie uda�, narazi�oby ci� na kolejne b��dy :-P Musi si� uda� zawsze. void SDL_QuitSubSystem(Uint32 flags); Ostateczne zako�czenie ca�ego SDL wymaga funkcji SDL_Quit. Nie pobiera ona �adnych parametr�w i nic nie zwraca. Zamyka ona wszystkie podsystemy [w��cznie z tymi trzema domy�lnymi] i zwalnia zasoby przydzielone dla SDL. Jej nag��wek to: void SDL_Quit(void); T� funkcj� b�dziesz wywo�ywa�, gdy zechcesz zako�czy� prac� z SDL. Je�li obawiasz si�, �e zapomnisz po sobie posprz�ta�, mo�esz na przyk�ad ustawi� t� funkcj� jako handler w wywo�aniu atexit gdy tylko inicjalizacja SDL zako�czy si� sukcesem, np. tak: if ( SDL_Init(SDL_INIT_VIDEO|SDL_INIT_AUDIO) < 0 ) { //Co� posz�o nie tak. Wy�wietl komunikat o b��dzie i zako�cz z kodem b��du cout << "B��d inicjalizacji SDL!" << endl; return -1; } //Inicjalizacja si� powiod�a, wi�c ustawiamy handler atexit() atexit(SDL_Quit); Przy okazji warto zauwa�y�, �e w systemie Windows bibliotka SDL przekierowuje standardowe kana�y wyj�ciowe do plik�w maj�ych nazwy stdout.txt i stderr.txt. Gdyby tak nie robi�a, g�upawy Windows tworzy�by ci dodatkowe okno konsoli gdy tylko co� wypiszesz na stdout [ach te Windowsy.. ;-P]. Najdziwniejsz� funkcj� inicjalizacji SDL jest SDL_WasInit. Sprawdza ona, kt�re podsystemy zosta�y zainicjalizowane, a kt�re nie. Oto jej nag��wek: Uint32 SDL_WasInit(Uint32 flags); Co ciekawe, mo�esz zapyta� j� o konkretny zestaw podsystem�w, podaj�c odpowiednie flagi SDL_INIT_* w parametrze. Funkcja we�mie te twoje flagi i sprawdzi tylko te podsystemy, o kt�re pytasz. Jako wynik zwr�ci warto��, kt�ra jest po��czeniem flag bitowych tylko uruchomionych podsystem�w, i tylko spo�r�d tych, o kt�re pytasz. Najprostszy spos�b u�ycia tej funkcji to pytanie o to, czy jeden konkretny podsystem ju� dzia�a. Wykorzystujemy wtedy fakt, �e je�li �aden z podanych przez ciebie podsystem�w nie pracuje, wynikiem funkcji b�dzie 0: if ( SDL_WasInit(SDL_INIT_AUDIO) ) //Podsystem AUDIO dzia�a... else //Podsystem AUDIO nie dzia�a... Obs�uga b��d�w Wiele funkcji SDL w przypadku b��du zwraca po prostu -1. Ta warto�� niewiele jednak m�wi o przyczynie b��du. W tym celu istnieje funkcja SDL_GetError. bla bla bla #include #include using namespace std; int main() { cout << "Startujemy SDL..." << endl; // Przygotuj podsystemy: domy�lne, VIDEO i AUDIO. if ( SDL_Init(SDL_INIT_VIDEO|SDL_INIT_AUDIO) < 0 ) { cout << "B��d inicjalizacji SDL: " << SDL_GetError() << endl; return -1; } cout << "SDL gotowy do pracy!" << endl; // Tu b�dzie normalne dzia�anie programu... cout << "Ko�czymy prac� SDL..." << endl; // Wy��czamy wszystkie podsystemy SDL. SDL_Quit(); cout << "Program zako�czony" << endl; }