48 lines
1.3 KiB
C
48 lines
1.3 KiB
C
#pragma once
|
|
|
|
#include <stdbool.h>
|
|
#include <stddef.h>
|
|
#include <stdint.h>
|
|
|
|
#include "esp_err.h"
|
|
#include "lvgl.h"
|
|
|
|
typedef struct {
|
|
const char *asset_dir;
|
|
const uint8_t *frame_order;
|
|
size_t frame_order_count;
|
|
uint16_t repeat_count;
|
|
uint32_t frame_ms;
|
|
bool return_to_idle;
|
|
} lcd_face_asset_sequence_t;
|
|
|
|
/**
|
|
* @brief Create the default cat-face idle screen on the active LVGL screen.
|
|
*/
|
|
esp_err_t lcd_face_create_idle_screen(lv_obj_t *screen);
|
|
|
|
/**
|
|
* @brief Restore the default cat-face idle screen.
|
|
*/
|
|
esp_err_t lcd_face_show_idle(lv_obj_t *screen);
|
|
|
|
/**
|
|
* @brief Play a frame sequence from an animation asset directory.
|
|
*/
|
|
esp_err_t lcd_face_play_asset_sequence(lv_obj_t *screen, const lcd_face_asset_sequence_t *sequence);
|
|
|
|
/**
|
|
* @brief Preload a frame sequence into the animation cache.
|
|
*
|
|
* `decode_budget` limits how many compressed frames are decoded during this
|
|
* call. Pass `SIZE_MAX` to finish synchronously.
|
|
*/
|
|
esp_err_t lcd_face_preheat_asset_sequence(const lcd_face_asset_sequence_t *sequence,
|
|
size_t decode_budget,
|
|
bool *out_complete);
|
|
|
|
/**
|
|
* @brief Consume a completed finite asset-sequence signal.
|
|
*/
|
|
bool lcd_face_take_completed(bool *out_return_to_idle);
|