Multi-frame Files
 
 
 

Certain file types (and most devices) are multi-frame. AVI, IFL, FLI, and FLC are all formats that support multiple frames. The Bitmap class has methods for dealing with these multi-frame bitmaps. For example, you can set the current frame to load or save. Also, the BitmapInfo class has methods that will let you work with only a subset of frames of a multi-frame image, for example, BitmapInfo::SetStartFrame(), BitmapInfo::SetEndFrame(), and BitmapInfo::SetCustomStep() let you specify a different start, end and frame increment to be used.

When loading files, BitmapInfo defaults to frame 0. For multi-frame files you should specify the frame number you want to load. This is done by using BitmapInfo::SetCurrentFrame() before calling BitmapInfo::Load().