#ifndef RAW_IMAGE_VIEWER_H
#define RAW_IMAGE_VIEWER_H

// 防止C/C++混合调用时的名称修饰问题
#ifdef __cplusplus
extern "C" {
#endif

// 引入必要的标准类型声明（保证参数类型可识别）
#include <cstdint>

/**
 * @brief 启动RAW图像可视化线程（初始化+启动后台刷新）
 * @return bool 启动成功返回true，失败返回false
 */
	bool raw_image_viewer_start();

	/**
	 * @brief 停止RAW图像可视化线程（安全退出+资源清理）
	 */
	void raw_image_viewer_stop();

	/**
	 * @brief 更新RAW图像数据（线程安全，与后台可视化线程解耦）
	 * @param data 16位RAW图像数据指针（不可修改）
	 * @param width 图像宽度（必须>0）
	 * @param height 图像高度（必须>0）
	 * @param block_id 当前图像块ID（用于窗口标题显示）
	 */
	void raw_image_viewer_update(const uint16_t* data, int width, int height, uint32_t block_id);

	/**
	 * @brief 清理RAW图像可视化相关资源（兼容原接口，可选调用）
	 * @details 内部会先调用raw_image_viewer_stop()，再释放图像缓存内存
	 */
	void raw_image_viewer_cleanup();

#ifdef __cplusplus
}
#endif

#endif // RAW_IMAGE_VIEWER_H