libakgl/include/akgl/sprite.h

#ifndef _AKGL_SPRITE_H_
#define _AKGL_SPRITE_H_

#include <SDL3/SDL_properties.h>
#include <SDL3/SDL.h>
#include <akerror.h>


#define AKGL_SPRITE_MAX_FRAMES                 16
#define AKGL_SPRITE_MAX_NAME_LENGTH            128
#define AKGL_SPRITE_MAX_REGISTRY_SIZE          1024
#define AKGL_SPRITE_SHEET_MAX_FILENAME_LENGTH  512

#define AKGL_MAX_HEAP_SPRITE                   (AKGL_MAX_HEAP_ACTOR * 16)
#define AKGL_MAX_HEAP_SPRITESHEET              AKGL_MAX_HEAP_SPRITE

typedef struct {
    uint8_t refcount;
    SDL_Texture *texture;
    char name[AKGL_SPRITE_SHEET_MAX_FILENAME_LENGTH];
    uint16_t sprite_w;
    uint16_t sprite_h;
} akgl_SpriteSheet;

typedef struct {
    uint8_t refcount;
    uint8_t frameids[AKGL_SPRITE_MAX_FRAMES]; // which IDs on the spritesheet belong to our frames
    uint32_t frames; // how many frames are in this animation
    uint32_t width;
    uint32_t height;
    uint32_t speed; // how many milliseconds a given sprite frame should be visible before cycling
    bool loop; // when this sprite is done playing, it should immediately start again
    bool loopReverse; // when this sprite is done playing, it should go in reverse order through its frames
    char name[AKGL_SPRITE_MAX_NAME_LENGTH];
    akgl_SpriteSheet *sheet;
} akgl_Sprite;

// initializes a new sprite to use the given sheet and otherwise sets to zero
akerr_ErrorContext AKERR_NOIGNORE *akgl_sprite_initialize(akgl_Sprite *spr, char *name, akgl_SpriteSheet *sheet);
// loads a given image file into a new spritesheet
akerr_ErrorContext AKERR_NOIGNORE *akgl_spritesheet_initialize(akgl_SpriteSheet *sheet, int sprite_w, int sprite_h, char *filename);
akerr_ErrorContext AKERR_NOIGNORE *akgl_sprite_load_json(char *filename);

akerr_ErrorContext *akgl_sprite_sheet_coords_for_frame(akgl_Sprite *self, SDL_FRect *srccoords, uint8_t frameid);

#endif //_AKGL_SPRITE_H_