アプリケーションのエントリーポイント

概要

必要な場合main()は再定義されSDLから呼ばれる.

全ての環境で一貫性を保つため, アプリケーションのmain()は次の様にすること:

#include <SDL3/SDL.h>
#include <SDL3/SDL_main.h>

int main(int argc, char *argv[])
{
}

SDLはmain()の呼び出しに関する環境固有の処理を行う.

アプリケーションがメインコールバックを使用するかをSDL_MAIN_USE_CALLBACKSマクロで設定することもできる.

SDL_main.hは「シングルヘッダライブラリ」で, このヘッダをインクルードするとアプリケーションにコードが挿入され, ほとんどの場合は1度だけインクルードする必要がある. このヘッダはSDL.hで自動的にインクルードされない.

詳細は以下を参照すること: https://wiki.libsdl.org/SDL3/README-main-functions

関数

1. SDL_AppEvent - メインコールバックを使用する場合, アプリケーションが実装するイベント処理エントリーポイント
2. SDL_AppInit - メインコールバックを使用する場合, アプリケーションが実装する初期化処理エントリーポイント
3. SDL_AppIterate - メインコールバックを使用する場合, アプリケーションが実装する反復処理エントリーポイント
4. SDL_AppQuit - メインコールバックを使用する場合, アプリケーションが実装する終了処理エントリーポイント
5. SDL_EnterAppMainCallbacks - メインコールバックを使用する場合のエントリーポイント
6. SDL_GDKSuspendComplete - 一時停止から実行を再開させるためのアプリケーションからのコールバック
7. SDL_main - アプリケーションのプログラムエントリー関数
8. SDL_RegisterApp - SDLが使用するためにwin32ウィンドウクラスを登録する
9. SDL_RunApp - SDLアプリケーションの初期化と起動を行う
10. SDL_SetMainReady - SDL_Main()を使わないときSDL_Init()の失敗を回避する
11. SDL_UnregisterApp - SDL_RegisterAppで登録したwin32ウィンドウクラスを解除する

型

1. SDL_main_func - アプリケーションのmain()関数のプロトタイプ型

マクロ

1. SDL_MAIN_HANDLED - SDLの代わりにアプリケーションがエントリーポイントを提供することをSDLに知らせるマクロ
2. SDL_MAIN_USE_CALLBACKS - mainの代わりにメインコールバックを使用することをSDLに知らせるマクロ

SDL Wikiへのリンク