目次 - 4.関数 - 4.1一般 - Mix_Init

Mix_Init

int Mix_Init(int flags)

flags
扱うサンプリング音声/音楽形式(動的ライブラリを読み込む). 以下の論理和で複数指定できる:
MIX_INIT_FLAC
MIX_INIT_MOD
MIX_INIT_MP3
MIX_INIT_OGG

flagsで指定したライブラリを読み込んで初期化する. 少なくとも読み込めれば(既に読み込まれていれば)この関数は成功する. この関数は何度でも呼べるが, その場合でもMix_Quit関数を一度呼べば終了できる. 既にライブラリを読み込んだ場合でも, 読み込んでいない場合でも, 解放するために(使わないために)引数として0を渡すことができる.

メモ: ライブラリを読み込むとき一時的に停止するのを防ぐために, そして実際に読み込む前に本当にその形式に対応しているかチェックするために, あなたのプログラムが本格的に実行される前にMix_Init関数に使用するMIX_INIT_*フラグの論理和を渡して初期化したほうがよい.

メモ: この関数はエラー文字列を設定しない. よってMix_GetErrorが意味のあるメッセージを戻すことを期待してはならない.

戻り値: 初期化された全てのサンプリング音声/音楽ローダーのビットマスク

サンプルコード

// OGGとMOD形式のサンプリング音声/音楽ローダーを初期化する
int flags=MIX_INIT_OGG|MIX_INIT_MOD;
int initted=Mix_Init(flags);
if(initted&flags != flags) {
    printf("Mix_Init: 要求したOGGとMOD形式のローダーの初期化に失敗した!\n");
    printf("Mix_Init: %s\n", Mix_GetError());
    // ここでエラーを処理する
}

参照

Mix_Quit

原文へのリンク

4.1.2 IMG_Init