目次 - API(機能別) - 初期化と終了

初期化と終了

インクルードファイル: SDL.h

概要

この分類の関数はSDLの設定のために使われ, プログラム全体に影響がある.

初期化の概要

SDLを使うためには, 他のほとんどの関数の前にSDL_Init()を呼ぶ必要がある. SDL_Init()の役割は, SDLライブラリを正常に初期化し, 要求に応じて個別のサブシステムを開始することである.

ファイルI/Oスレッドサブシステムはデフォルトで初期化される. 他のサブシステムを使うときは個別に指定して初期化しなければならない. 論理和で複数のサブシステムを指定できる.

例: SDL_Init(SDL_INIT_VIDEO|SDL_INIT_AUDIO);
デフォルトの2つに加え, ビデオオーディオ, そしてイベントサブシステムを初期化する. イベントビデオサブシステムの初期化で暗黙のうちに初期化される.

いくつかのOSでは, SDL_Init()はSDL_main()が定義されていなければ失敗する. あらかじめSDL_SetMainReady()を呼べば, この失敗を回避できる. しかし, 不正な初期化はプログラムをクラッシュさせ, 調査を難しくするため, ユーザがSDL_SetMainReady()を呼ぶときは注意する必要がある.

終了の概要

デフォルトのものを含むサブシステムを安全に終了させるために, SDLアプリケーションが終了する前にSDL_Quit()を呼ぶ必要がある.

SDL_Quit()を使う場合は, 自動的に全てのサブシステムを終了するため, 個別に指定する必要はない.

関数

  1. SDL_Init - SDLライブラリを初期化する
  2. SDL_InitSubSystem - サブシステムを個別に初期化する
  3. SDL_Quit - サブシステムを終了する
  4. SDL_QuitSubSystem - サブシステムを個別に終了する
  5. SDL_SetMainReady - SDL_Main()を使わないときSDL_Init()の失敗を回避する
  6. SDL_WasInit - 初期化された個別のサブシステムのマスクを戻す
  7. SDL_WinRTRunApp - SDL/WinRTアプリケーションを初期化し起動する

SDL Wikiへのリンク

Initialization and Shutdown - SDL Wiki