Developer

API Reference

IWidget_SetNFrames()

Brew Release
Brew MP 1.0.2
See Also
IWidget IWidget_SetImageParm()
Description
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).
Parameters
  • pif
    []:
    [in] Pointer to the IWidget object.
  • nFrames
    []:
    [in] Specifies the number of frames contained in the animation sequence.
Interface
Prototype
   int IWidget_SetNFrames(IWidget *pif, int nFrames)
Return
   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.
Side Effect
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).
Comment
None
  • Follow