/*
 * 模块名称：Simulator Display Port (SDL2 模拟器端口)
 * 模块功能：为 PC 模拟器提供 LVGL SDL2 显示与键盘输入端口
 * 适用平台：Windows / Linux / macOS (SDL2)
 * 说明：替代 MCU 端的 ui_port.c，用于 PC 上 UI 开发与调试
 */
#ifndef SIM_PORT_H
#define SIM_PORT_H

#include <stdint.h>

#ifdef __cplusplus
extern "C" {
#endif

/*
 * 函数功能：初始化 SDL2 显示窗口与键盘输入设备
 * 入口参数：hor_res - 水平分辨率  int32_t
 *           ver_res - 垂直分辨率  int32_t
 * 返回值：0 - 成功，-1 - 失败
 * 限定条件：lv_init() 已调用
 * 函数说明：创建 SDL 窗口、键盘输入设备及默认输入组
 */
int sim_port_init(int32_t hor_res, int32_t ver_res);

/*
 * 函数功能：获取 SDL 显示设备句柄
 * 入口参数：无
 * 返回值：显示设备指针  lv_display_t *  可能为 NULL
 * 限定条件：sim_port_init() 已成功调用
 */
void *sim_port_get_display(void);

/*
 * 函数功能：读取当前屏幕内容并转换为 1bpp 单色位图
 * 入口参数：buf      - 输出缓冲（调用方分配，≥ 宽*高/8 字节）
 *           buf_size - buf 容量（字节）
 * 返回值：0 - 成功，-1 - 失败
 * 限定条件：sim_port_init() 已成功；须在 SDL 所属线程（主循环线程）调用
 * 函数说明：经 SDL_RenderReadPixels 读回屏幕实际呈现的 ARGB8888 像素，
 *           按红通道阈值 128 判白(=1/墨)/黑(=0)，打包为 1bpp MSB-first，
 *           与 MCU 端 ui_port_get_framebuffer 的 1bpp 布局一致
 */
int sim_port_get_screen_mono(uint8_t *buf, uint32_t buf_size);

#ifdef __cplusplus
}
#endif

#endif /* SIM_PORT_H */