目次 - SDL_image - API(機能別) - 読み込み/保存 - IMG_LoadAnimationTyped_RW

IMG_LoadAnimationTyped_RW

SDLデータソースからアニメーションを読み込む

構文

IMG_Animation * IMG_LoadAnimationTyped_RW(SDL_RWops *src, int freesrc, const char *type)

引数

src読み込むSDL_RWops
freesrc0でないときsrcを自動的に閉じる/解放する. 0のとき開いたままにする
typeデータの種類を表すファイルの拡張子("GIF"など)

戻り値

新しいIMG_Animation, エラーのときNULLを戻す.

詳細

この関数はファイルの種別を指定できるが, 画像データを別の形式として読み込める場合, SDL_imageは別のデコーダを見つけようとする. しかし, 自動検出できない場合は呼び出し側の画像種別文字列を信頼する. typeがNULLのとき, SDL_imageは何も参考にせずに形式を推定する.

freesrcが0以外の場合, 処理が成功してもしなくてもRWopsは閉じる. この関数を呼んだとき, どのような場合でもSDL_imageは必要ならばRWopsを全て読み込む.

アニメーションを戻した場合, アプリケーションはIMG_FreeAnimation()を呼んで破棄しなければならない.

バージョン

SDL_image 2.6.0以降

関連項目(関数)

IMG_LoadAnimation
IMG_LoadAnimation_RW
IMG_FreeAnimation

SDL Wikiへのリンク

SDL2_image/IMG_LoadAnimationTyped_RW