Brew MP 1.0.2
This function is used to set the number of frames contained in the animation sequence
of an animated bitmap. For example, an animated bitmap that stores all of its frames
in a single 512 x 80 pixel bitmap might indicate that the animation sequence consists
of 8 frames -- meaning that each frame of the animation will be 64 pixels wide (512
pixels divided by 8 frames equals 64 pixels per frame).
int IWidget_SetNFrames(IWidget *pif, int nFrames)
AEE_SUCCESS - If BREW was able to successfully set the number of animation frames
AEE_EFAILED - If the number of frames could not be set.
Changing the number of animation frames will recalculate the frame size. For example,
if a 1024 x 48 bitmap is originally set to contain 16 frames of animation, each frame
would be 64 pixels wide (1024 pixels divided by 16 frames). If IWidget_SetNFrames()
is then called with 'nFrames' set to 32, the width of each frame changes proportionally
from 64 pixels to 32 pixels (1024 pixels divided by 32 frames).