NAME ==== vg_sprite_getcurrent() - return current bitmap of sprite without incrementing counter SYNOPSIS ======== bitmap * vg_sprite_getcurrent(const sprite * spt) DESCRIPTION =========== This function operates just like vg_sprite_getnext(), but does not increment the internal counter, which means that the same bitmap as before is returned. This can be useful if you want to show the same sprite spt more times on your window and have lost the pointer to the bitmap. If you would call vg_sprite_getnext() for all outputs of the same sprite, every call would increase the counter and the sprite would run twice or more times as quick. Another way to circumvent this problem is to duplicate the sprite for every instance you want to put out. Then they are different sprites and you can call for every of these vg_sprite_getnext(). RETURN VALUE ============ If it succeeds, a pointer to the actual bitmap of the sprite is returned. If the sprite has ended, NULL is returned, but the sprite is not 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_getnext() vg_sprite_reset() vg_sprite_free()