NAME
GetExtSpriteA -- Attempt to get a sprite for the extended sprite
manager. (V39)
GetExtSprite -- varargs stub for GetExtSpriteA. (V39)
SYNOPSIS
Sprite_Number = GetExtSpriteA( sprite, tags ) (V39)
d0 a2 a1
long getextspritea( struct extsprite *, struct tagitem * );
spritenum=GetExtSprite(sprite,tags,...);
FUNCTION
Attempt to allocate one of the eight sprites for private use
with the extended sprite manager.
INPUTS
sprite - ptr to programmer's extsprite (from allocspritedata()).
tags - a standard tag list:
GSTAG_SPRITE_NUM specifies a specific sprite to get by number.
GSTAG_ATTACHED specifies that you wish to get a sprite pair.
the tag data field points to a extsprite structure
for the second sprite. You must free both sprites.
RESULTS
Sprite_number = a sprite number or -1 for an error.
This call will fail if no sprites could be allocated, or
if you try to allocate a sprite which would require
a mode change when there are other sprites of incompatible
modes in use.
BUGS
GSTAG_ATTACHED does not work in version 39. When running under V39,
you should attach the second sprite with a separate GetExtSprite call.
SEE ALSO
freesprite() changesprite() movesprite() getsprite() graphics/sprite.h