SDL_Init
SDL_Init -- SDL inicializálása
Szintaxis
int SDL_Init(Uint32 flags);
Leírás
Inicializálja az SDL könyvtárat. A legtöbb SDL függvény nem fog működni az inicializálásig, tehát normál esetben az ez első, függvény amit meg kell hívni.
A függvény betölti a dinamikusan linkelt SDL könyvtárat, a kijelölt alrendszereket, és beállítja a szignálkezelőket néhány, gyakran figyelmen kívül hagyott szignálra (pl. SIGSEGV), amennyiben az SDL_INIT_NOPARACHUTE nincs megadva.
Paraméterek
flags [be]
- Az SDL mely részeit kell inicializálni. Az összes megjelölt alrendszer inicializálódni fog,
és a függőségeik is. Ezek a következőek lehetnek (több zászlót is meg lehet adni egyszerre, bitenkénti VAGY művelettel kombinálva, pl.: SDL_INIT_AUDIO | SDL_INIT_VIDEO):
SDL_INIT_TIMER |
SDL idő alrendszerének inicializálása. |
SDL_INIT_AUDIO |
SDL hangrendszerének inicializálása. |
SDL_INIT_VIDEO |
SDL videó alrendszerének inicializálása. |
SDL_INIT_CDROM |
SDL CD-ROM alrendszerének inicializálása. |
SDL_INIT_JOYSTICK |
SDL Joystick alrendszerének inicializálása. |
SDL_INIT_EVERYTHING |
Az összes fenti iniciálizálása. |
SDL_INIT_NOPARACHUTE |
Megakadályozza, hogy az SDL elkapja a végzetes szignálokat. |
SDL_INIT_EVENTTHREAD |
Esemény kezelő futtatása külön szálon. |
Visszatérési érték
-1 hiba esetén, 0 ha minden rendben történt. Részletesebb információt a hibáról az SDL_GetError() hívásával lehet megkapni. Sokszor a hiba valamely alrendszer hiánya miatt következik be, mint például az egér támogatás hiánya framebuffer eszközökön. Ilyenkor SDL újrafordítása egér támogatás nélkül, vagy az SDL_NOMOUSE környezeti változó beállítása (export SDL_NOMOUSE=1 Unixokon)
Példa
1 if(SDL_Init(SDL_INIT_VIDEO) < 0) {
2 fprintf(stderr, "SDL inicializalasa sikertelen: %s\n", SDL_GetError());
3 exit(1);
4 }
Lásd még
SDL_Quit, SDL_InitSubSystem, SDL_GetError, Környezeti változók (angol)
Követelmények
Fejállomány |
SDL.h |
Verzió |
1.2.13 |
Megosztott objektum |
libSDL.so |
DLL |
SDL.dll |
