Sprite Functions

Sprite Functions

load_sprites

void load_sprites(int vaddr, int *spr_data, int nb_spr);
Load sprite graphics data in video memory, at address      'vaddr'. This function load sprites by chunk of 8 sprites      of 16x16 pixels. 'nb_spr' is the number of chunk to load.      If you need to load less 16x16 sprites than the eight      contained in a chunk, use load_vram() function instead.

init_satb

void init_satb(void);
Initialize the internal sprite attribute table      (SATB) used by the library to handle sprites.      This function must be called before any other      sprite function is called.

reset_satb

void reset_satb(void);
Reset the internal SATB, this has the effect      to disable and reset all the sprites.

satb_update

void satb_update(void);
void satb_update(char nb);
Copy the internal sprite attribute table      to the video ram. This will refresh sprites      on the screen. Use this function regularly      to update the sprite display. The best place      to call satb_update() is after every vsync()      call, but no need to call satb_update if you      didn't change any sprite attribute.      'nb' specifys the number of sprite to refresh;      starting from sprite 0. By default the library      refreshes only the sprites you use, but if you      need to implicitely refresh a certain number      of sprites then you can use 'nb'.

spr_set

void spr_set(char num);
Select sprite 'num' (0-63) as the current sprite.

spr_x

void spr_x(int value);
Set the x coordinate of the current sprite.      Negative values will make the sprite disappear      under the left border, while values higher than      the screen width will make it disappear under      the right border.

spr_y

void spr_y(int value);
Set the y coordinate of the current sprite.

spr_pattern

void spr_pattern(int vaddr);
Set the pattern address in video memory of      the current sprite.

spr_ctrl

void spr_ctrl(char mask, char value);
Set different attributes of the current sprite.      With this function you can change the sprite      size (16x16, 32x32, ...) and the sprite      orientation (horizontal/vertical flipping).

spr_pal

void spr_pal(char pal);
Set the palette-block index (0-15) of the current sprite.

spr_pri

void spr_pri(char pri);
Set the priority of the current sprite. '0' will make      it appear behind the background (through color 0),      '1' will make it appear in front of the background.

spr_get_x

??? spr_get_x(void);
Return the x coordinate of the current sprite.

spr_get_y

??? spr_get_y(void);
Return the y coordinate of the current sprite.

spr_get_pal

char spr_get_pal(void);
Return the palette-block index (0-15) of the current      sprite.

spr_get_pattern

??? spr_get_pattern(void);
Return the pattern address in video memory of      the current sprite.

spr_hide

void spr_hide(void);
void spr_hide(char num);
Without parameters this function will hide the current      sprite. Use 'num' to hide a different sprite than      the current one.

spr_show

void spr_show(void);
void spr_show(char num);
Show a sprite that has been hidden using the spr_hide()      function.