Add 'sdk/' from commit '2e7561d74f75de05dd7fb362f203f600afb451d7'

git-subtree-dir: sdk
git-subtree-mainline: 17a972d46f
git-subtree-split: 2e7561d74f

sdk/include/meow_ui_image.h

@@ -0,0 +1,36 @@
+/*
+ * meow_ui_image.h — SDK 图片层（§4，B1）。
+ *
+ * 原 meow_ui.h 拆分的一部分（image 模块）。内部 stb_image（单头文件，静态编入 meow_ui.a）
+ * 解 PNG/JPEG/BMP，统一转 RGBA。meow_img 为不透明句柄（前向声明见 meow_ui_types.h）。
+ */
+#ifndef MEOW_UI_IMAGE_H
+#define MEOW_UI_IMAGE_H
+
+#include "meow_ui_types.h"
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/* ============================================================ */
+/* §4 图片层 */
+/* ============================================================ */
+typedef struct meow_img meow_img;   /* 句柄，由 meow_img_* 管理，不透明 */
+
+meow_img *meow_img_load_file(const char *path);     /* 内部读文件 + stb 解码 */
+meow_img *meow_img_load_mem(const void *buf, int len);
+void       meow_img_free(meow_img *img);
+
+int meow_img_w(meow_img *img);
+int meow_img_h(meow_img *img);
+
+void meow_ui_img(int x, int y, meow_img *img);                                   /* 原始尺寸 */
+void meow_ui_img_scaled(int x, int y, int w, int h, meow_img *img);              /* 最近邻缩放 */
+void meow_ui_img_alpha(int x, int y, int w, int h, meow_img *img, int alpha);
+void meow_ui_img_cover(int x, int y, int size, meow_img *img);                   /* 居中裁方 → size×size */
+
+#ifdef __cplusplus
+}
+#endif
+#endif /* MEOW_UI_IMAGE_H */