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

初期化と終了

概要

全てのプログラムはSDLを使用する前にライブラリを初期化する必要がある.

ほとんどの場合は, スタートアップの近くで使用するサブシステムを示すフラグを指定してSDL_Init()を呼べばよい. フラグは, 使用するつもりのない機能はSDLにオペレーティングシステムの低レベルの部分をアクセスさせないためにある. 例えば, SDLのビデオと入力は使用するが, オーディオは外部のライブラリを使用する場合は, 外部のライブラリがオーディオを完全に制御できるようにSDL_INIT_AUDIOを外せばよい.

大半のアプリケーションは終了するときSDL_Quit()を呼ぶ必要がある. これは, SDLが確保した資源を(ほぼ)全て解放し, さらに重要なこととして, ディスプレイの解像度をアプリケーションが変更していた場合はユーザが設定していたものに戻す.

SDL3アプリケーションではスタートアップでSDL_SetAppMetadata()を呼んでプログラムの詳細を設定することを強く推奨する. これは完全に任意だが, わずかなことで様々な助けになる(macOSメニューのAboutダイアログボックスや, システムのオーディオミキサーのアプリケーション名などを提供できる). もっと多くの情報を提供したいならば, SDL_SetAppMetadataProperty()の詳細を見ること.

関数

  1. SDL_GetAppMetadataProperty
  2. SDL_Init
  3. SDL_InitSubSystem
  4. SDL_IsMainThread
  5. SDL_Quit
  6. SDL_QuitSubSystem
  7. SDL_RunOnMainThread
  8. SDL_SetAppMetadata
  9. SDL_SetAppMetadataProperty
  10. SDL_WasInit

列挙体

  1. SDL_AppResult

SDL Wikiへのリンク

SDL3/CategoryInit - SDL Wiki