目次 - 3.関数 - 3.1一般 - IMG_Init

IMG_Init

int IMG_Init(int flags)

flags
扱う画像形式(動的ライブラリを読み込む). 以下の論理和で複数指定できる:
IMG_INIT_JPG
IMG_INIT_PNG
IMG_INIT_TIF

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

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

メモ: IMG_isJPG, IMG_isPNG, IMG_isTIF関数は初期化しなくても使える.

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

戻り値: 初期化された全ての画像ローダーのビットマスク

サンプルコード

// JPGとPNG形式の画像を読み込めるようにする
int flags=IMG_INIT_JPG|IMG_INIT_PNG;
int initted=IMG_Init(flags);
if(initted&flags != flags) {
    printf("IMG_Init: JPGとPNGの読み込みの初期化に失敗した!\n");
    printf("IMG_Init: %s\n", IMG_GetError());
    // ここでエラー処理を行う
}

参照

IMG_Quit

原文へのリンク

3.1.2 IMG_Init