/**
 * sprite_demo.h — Sprite Sheet PoC
 *
 * 从 SPIFFS 加载 RGB565 raw sprite pack 到 PSRAM，
 * 通过 DMA 直接写 LCD GRAM 实现零 CPU 解码的动画播放。
 */
#pragma once

#include "esp_err.h"
#include <stdbool.h>

#ifdef __cplusplus
extern "C" {
#endif

/**
 * 加载并开始播放 sprite pack
 *
 * @param path SPIFFS 路径，例如 "/spiflash/sprite_test.bin"
 * @return ESP_OK 成功
 */
esp_err_t sprite_demo_start(const char *path);

/**
 * 暂停播放（停止帧定时器，但保留 PSRAM 数据）
 */
void sprite_demo_pause(void);

/**
 * 恢复播放
 */
void sprite_demo_resume(void);

/**
 * 停止播放并释放 PSRAM
 */
void sprite_demo_stop(void);

/**
 * 检查是否正在播放
 */
bool sprite_demo_is_playing(void);

#ifdef __cplusplus
}
#endif