anim.h

Go to the documentation of this file.

 
#ifndef OPENSNES_ANIM_H
#define OPENSNES_ANIM_H
 
#include <snes/types.h>

#define ANIM_LOOP  0
#define ANIM_ONCE  1

#define ANIM_F_FINISHED  0x01

#define ANIM_NONE  0xFFFF

typedef struct {
    const u16 *frames;   
    const u8 *durations; 
    u8 len;              
    u8 speed;            
    u8 mode;             
    u8 reserved;         
} AnimClip;

typedef struct {
    const AnimClip *clip; 
    u8 frame;             
    u8 ticks;             
    u8 flags;             
    u8 reserved;          
} AnimPlayer;

#define ANIM_PLAYER_INIT  {0, 0, 0, 0, 0}

void animPlay(AnimPlayer *p, const AnimClip *clip);

void animRestart(AnimPlayer *p);

u16 animTick(AnimPlayer *p);

#define animFrame(_p)  ((_p)->clip ? (_p)->clip->frames[(_p)->frame] : ANIM_NONE)

#define animDone(_p)   ((_p)->flags & ANIM_F_FINISHED)

#define animStop(_p)   do { (_p)->clip = 0; (_p)->flags = 0; } while (0)

#define animTickOam(_p, _id) do { \
    u16 _af = animTick(_p); \
    if (_af != ANIM_NONE && oambuffer[_id].oamframeid != _af) { \
        oambuffer[_id].oamframeid = _af; \
        oambuffer[_id].oamrefresh = 1; \
    } \
} while (0)

#define animTickMeta(_p, _tbl)  ((_tbl)[animTick(_p)])

#define DECLARE_ANIM_CLIP(name, mode_, speed_, ...) \
    static const u16 name##_frames[] = { __VA_ARGS__ }; \
    _Static_assert(sizeof(name##_frames) / sizeof(u16) <= 255, \
                   "DECLARE_ANIM_CLIP: a clip holds at most 255 frames"); \
    static const AnimClip name = { \
        name##_frames, \
        0, \
        (u8)(sizeof(name##_frames) / sizeof(u16)), \
        (speed_), \
        (mode_), \
        0, \
    }
 
#endif /* OPENSNES_ANIM_H */