[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
       ChangeSprite -- Change the sprite image pointer.

   SYNOPSIS
       ChangeSprite( vp, s, newdata)
                     a0  a1   a2

        void ChangeSprite(struct viewport *, struct simplesprite *, void * )

   FUNCTION 
        The sprite image is changed to use the data starting at newdata

   INPUTS
       vp - pointer to viewport structure that this sprite is
                  relative to,  or 0 if relative only top of view
        s - pointer to simplesprite structure
        newdata - pointer to data structure of the following form.
                struct spriteimage
                {
                    uword    posctl[2];    /* used by simple sprite machine*/
                    uword    data[height][2];   /* actual sprite image */
                    uword    reserved[2];  /* initialized to */
                                                     /*  0x0,0x0 */
                };
        The programmer must initialize reserved[2].  Spriteimage must be
        in CHIP memory. The height subfield of the simplesprite structure
        must be set to reflect the height of the new spriteimage BEFORE
        calling ChangeSprite(). The programmer may allocate two sprites to
        handle a single attached sprite.  After getsprite(), changesprite(),
        the programmer can set the SPRITE_ATTACHED bit in posctl[1] of the
        odd numbered sprite.
        If you need more than 8 sprites, look up VSprites in the
        graphics documentation.

   RESULTS 

   BUGS 

   SEE ALSO
        freesprite() changesprite() movesprite() addvsprite() graphics/sprite.h