bool IMG_GetAnimationDecoderFrame(IMG_AnimationDecoder *decoder, SDL_Surface **frame, Uint64 *duration);
| IMG_AnimationDecoder * | decoder | アニメーションデコーダ |
| SDL_Surface ** | frame | アニメーションの次のフレームのSDL_Surfaceの代入先へのポインタ |
| Uint64 | duration | *フレーム間隔. 単位はミリ秒だが, デコーダの生成時にIMG_PROP_ANIMATION_DECODER_CREATE_TIMEBASE_DENOMINATOR_NUMBERプロパティで単位を変えることもできる |
この関数はアニメーションデコーダの次のフレームをデコードし, SDL_Surfaceとして戻す. 戻されたサーフェイスは不要になったときSDL_DestroySurface()で解放する必要がある.
アニメーションデコーダにこれ以上フレームがない, またはフレームのデコードでエラーが発生した場合, この関数は偽を戻す. この場合, SDL_GetError()で詳細を得ること. SDL_GetError()が空の文字列を戻した場合, フレームがないことを表す. SDL_GetError()が有効な文字列を戻した場合, デコードに失敗したことを表す.