rgbx_api.h

Go to the documentation of this file.

 
#ifndef RGBX_API_H_
#define RGBX_API_H_
 
#include <stddef.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define RGBX_ABI_VERSION 1u
 
#define RGBX_MAX_PARAMS 16u
 
#define RGBX_MAX_STRING_PARAMS 4u
 
#define RGBX_PARAM_STRING_MAX 32u
 
#define RGBX_AUDIO_NUM_BANDS 4u
 
#define RGBX_AUDIO_NUM_DISPLAY_BUCKETS 20u
 
enum rgbx_param_type {
    RGBX_PARAM_UINT32 = 0, 
    RGBX_PARAM_COLOR = 1,  
    RGBX_PARAM_BOOL = 2,   
    RGBX_PARAM_STRING = 3, 
    RGBX_PARAM_FLOAT = 4,  
};
 
union rgbx_param_default {
    uint32_t u32;     
    uint32_t color;   
    uint32_t boolean; 
    float f32;        
    const char *str;  
};
 
struct rgbx_param_desc {
    const char *name;           
    enum rgbx_param_type type;  
    union rgbx_param_default default_value; 
};
 
struct rgbx_manifest {
    uint32_t abi_version; 
    const char *name;     
    uint32_t width;       
    uint32_t height;      
    uint32_t param_count; 
    const struct rgbx_param_desc *params; 
};
 
struct rgbx_inputs {
    uint32_t dt_ms; 
    uint32_t params[RGBX_MAX_PARAMS]; 
    char param_strings[RGBX_MAX_STRING_PARAMS][RGBX_PARAM_STRING_MAX];
    float accel[3]; 
    float gyro[3];  
    float audio_band_energy[RGBX_AUDIO_NUM_BANDS];
    uint8_t audio_beat[RGBX_AUDIO_NUM_BANDS];
    float audio_display_bucket[RGBX_AUDIO_NUM_DISPLAY_BUCKETS];
    uint32_t buttons_pressed;
};
 
#define RGBX_PARAM(name_, type_, default_u32_) \
    {(name_), (type_), {.u32 = (default_u32_)}}
 
#define RGBX_PARAM_STR(name_, default_str_) \
    {(name_), RGBX_PARAM_STRING, {.str = (default_str_)}}
 
#define RGBX_PARAM_F32(name_, default_f32_) \
    {(name_), RGBX_PARAM_FLOAT, {.f32 = (default_f32_)}}
 
#define RGBX_PIXEL_INDEX(w, x, y) ((((size_t)(y) * (size_t)(w)) + (size_t)(x)) * 3u)
 
extern const struct rgbx_manifest rgbx_manifest;
 
extern struct rgbx_inputs rgbx_inputs;
 
extern uint8_t rgbx_framebuffer[];
 
void rgbx_init(void);
 
void rgbx_tick(void);
 
/* The symbol names the host passes to llext_find_sym(), kept next to the
 * declarations above so the two can't drift apart. */
 
#define RGBX_SYM_MANIFEST "rgbx_manifest"
#define RGBX_SYM_INPUTS "rgbx_inputs"
#define RGBX_SYM_FRAMEBUFFER "rgbx_framebuffer"
#define RGBX_SYM_INIT "rgbx_init"
#define RGBX_SYM_TICK "rgbx_tick"
 
extern uint8_t rgbx_good_moment;
 
#define RGBX_SYM_GOOD_MOMENT "rgbx_good_moment"
 
#ifdef __cplusplus
} /* extern "C" */
#endif
 
#endif /* RGBX_API_H_ */