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