sprite_animator.h

Go to the documentation of this file.

/*
** Jo Sega Saturn Engine
** Copyright (c) 2012-2026, Johannes Fetz (johannesfetz@gmail.com)
** All rights reserved.
**
** Redistribution and use in source and binary forms, with or without
** modification, are permitted provided that the following conditions are met:
**     * Redistributions of source code must retain the above copyright
**       notice, this list of conditions and the following disclaimer.
**     * Redistributions in binary form must reproduce the above copyright
**       notice, this list of conditions and the following disclaimer in the
**       documentation and/or other materials provided with the distribution.
**     * Neither the name of the Johannes Fetz nor the
**       names of its contributors may be used to endorse or promote products
**       derived from this software without specific prior written permission.
**
** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
** ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
** WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
** DISCLAIMED. IN NO EVENT SHALL Johannes Fetz BE LIABLE FOR ANY
** DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
** (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
** LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
** ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
** SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
 
#ifndef __JO_SPRITE_ANIMATOR_H__
# define __JO_SPRITE_ANIMATOR_H__

typedef enum
{
    JO_SPRITE_ANIM_START,
    JO_SPRITE_ANIM_START_REVERSE,
    JO_SPRITE_ANIM_STOP,
    JO_SPRITE_ANIM_STOP_AT_LAST_FRAME,
}                   jo_sprite_anim_action;

typedef struct
{
    unsigned short                  frame0_sprite_id;
    unsigned short                  frame_count;
    unsigned short                  cur_frame;
    unsigned char                   frame_rate;
    unsigned char                   frame_skip;
    jo_sprite_anim_action           action;
}                                   jo_sprite_anim;

extern jo_sprite_anim       __jo_sprite_anim_tab[JO_MAX_SPRITE_ANIM];

static  __jo_force_inline unsigned char jo_get_sprite_anim_frame_rate(const int anim_id)
{
    return __jo_sprite_anim_tab[anim_id].frame_rate;
}

static  __jo_force_inline unsigned short    jo_get_sprite_anim_frame_count(const int anim_id)
{
    return __jo_sprite_anim_tab[anim_id].frame_count;
}

static  __jo_force_inline unsigned short    jo_get_sprite_anim_frame(const int anim_id)
{
    return __jo_sprite_anim_tab[anim_id].cur_frame;
}

static __jo_force_inline void   jo_set_sprite_anim_frame(const int anim_id, const unsigned char frame)
{
    __jo_sprite_anim_tab[anim_id].cur_frame = frame;
}

static  __jo_force_inline void  jo_start_sprite_anim_loop(const int anim_id)
{
    __jo_sprite_anim_tab[anim_id].action = JO_SPRITE_ANIM_START;
}

static  __jo_force_inline bool  jo_is_sprite_anim_stopped(const int anim_id)
{
    return __jo_sprite_anim_tab[anim_id].action == JO_SPRITE_ANIM_STOP;
}

static  __jo_force_inline void  jo_stop_sprite_anim(const int anim_id)
{
    __jo_sprite_anim_tab[anim_id].action = JO_SPRITE_ANIM_STOP;
}

static  __jo_force_inline void  jo_start_sprite_anim(const int anim_id)
{
    __jo_sprite_anim_tab[anim_id].action = JO_SPRITE_ANIM_STOP_AT_LAST_FRAME;
}

static  __jo_force_inline void  jo_reset_sprite_anim(const int anim_id)
{
    jo_stop_sprite_anim(anim_id);
    JO_ZERO(__jo_sprite_anim_tab[anim_id].frame_skip);
    JO_ZERO(__jo_sprite_anim_tab[anim_id].cur_frame);
}

static  __jo_force_inline void  jo_restart_sprite_anim(const int anim_id)
{
    jo_reset_sprite_anim(anim_id);
    jo_start_sprite_anim(anim_id);
}

static  __jo_force_inline int   jo_get_anim_sprite(const int anim_id)
{
    return __jo_sprite_anim_tab[anim_id].frame0_sprite_id + __jo_sprite_anim_tab[anim_id].cur_frame;
}

static  __jo_force_inline int   jo_get_anim_sprite_reverse(const int anim_id)
{
    return __jo_sprite_anim_tab[anim_id].frame0_sprite_id + __jo_sprite_anim_tab[anim_id].frame_count - __jo_sprite_anim_tab[anim_id].cur_frame - 1;
}

static  __jo_force_inline int   jo_set_sprite_anim_frame_rate(const int anim_id, const unsigned char framerate)
{
    return __jo_sprite_anim_tab[anim_id].frame_rate = framerate;
}

int         jo_replace_sprite_anim(const int at, const unsigned short sprite_id, const unsigned short frame_count, const unsigned char frame_rate);

int         jo_create_sprite_anim(const unsigned short sprite_id, const unsigned short frame_count, const unsigned char frame_rate);

void        jo_remove_sprite_anim(const int anim_id);

void        jo_clear_all_sprite_anim(void);
 
#endif /* !__JO_SPRITE_ANIMATOR_H__ */
 
/*
** END OF FILE
*/