DrawAnimCel

Draws a cel in an animation and give it a hotspot

Synopsis

void DrawAnimCel (ANIM *pAnim, Item bitmapItem, long xPos, long yPos, frac16 frameIncrement, long hotSpot)

Description

Determines the next cel to draw in the animation specified by pAnim and draws it. Lets you draw a hotspot on that frame.

Arguments

pAnim
Pointer to an ANIM structure (defined in animutils.h) returned by LoadAnim().
bitmapItem
Item describing the bitmap into which the cel will be drawn.
xPos
X (horizontal) position for a hotspot in the cel.
YPos
Y (vertical) position for a hotspot in the cel.
frameIncrement
Frac16, 16.16 fixed point number to add to the current frame count. This is rounded to an integer to determine the next frame in the animation. If frameIncrement increments the current frame past the end of the animation, cur_Frame is reset to the beginning. Note that this works backwards as well.
hotSpot
Integer (enum) equal to one of the following (defined in utils3do.h).
The cel is positioned with the hotspot at xPos, YPos.

Associated Files

lib3do.lib, animutils.h

See Also

GetAnimCel, LoadAnim