Docs » Autodocs » graphics.library » GetExtSpriteA
GetExtSpriteA -- Attempt to get a sprite for the extended sprite
manager. (V39)
GetExtSprite -- varargs stub for GetExtSpriteA. (V39)
Sprite_Number = GetExtSpriteA( sprite, tags ) (V39)
d0 a2 a1
LONG GetExtSpriteA( struct ExtSprite *, struct TagItem * );
spritenum=GetExtSprite(sprite,tags,...);
Attempt to allocate one of the eight sprites for private use
with the extended sprite manager.
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.
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.
GSTAG_ATTACHED does not work in version 39. When running under V39,
you should attach the second sprite with a separate GetExtSprite call.
FreeSprite(), ChangeSprite(), MoveSprite(), GetSprite(), <graphics/sprite.h>
|
