NAME ==== vg_sprite_getnext() - increment counter and return current bitmap of sprite SYNOPSIS ======== bitmap * vg_sprite_getnext(sprite * spt) DESCRIPTION =========== This is the function which makes a sprite spt move. Every time you call it, an internal counter is incremented and if it becomes greater than the loop-value of the current sprite-element, the next sprite-element becomes active. Then a pointer to the bitmap of the active sprite-element is returned. If there is no next sprite-element, the sprite ended. Then the return value is NULL, which indicates the end of the sprite. If you are not interested in this end of the sprite, call vg_sprite_getnext() again and all will start from the beginning. RETURN VALUE ============ If it succeeds, a pointer to the actual bitmap of the sprite is returned. If the sprite ended, NULL is returned, and the sprite is rewinded. SEE ALSO ======== Index Understanding sprites vg_sprite_createnew() vg_sprite_createfromfile() vg_sprite_add() vg_sprite_duplicate() vg_sprite_rotate() vg_sprite_zoom() vg_sprite_mirror() vg_sprite_getcurrent() vg_sprite_reset() vg_sprite_free()