/*
 * 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(const meow_img *img);
int meow_img_h(const meow_img *img);
/* 访问器：取 RGBA 像素指针（4 通道 straight alpha；供取色/直读像素）。meow_img 对外 opaque，
 * 本函数为其唯一像素读入口；NULL 返回 NULL。 */
const unsigned char *meow_img_pixels(const meow_img *img);

void meow_ui_img(int x, int y, meow_img *img);                                   /* 原始尺寸 */
/* 内存瘦身：最近邻等比缩放到最长边 ≤maxdim，返回新图；原图已 ≤maxdim 返回 NULL。
 * 调用方负责 free 旧图与返回值（若返回）。封面/背景大图驻留内存瘦身用。 */
meow_img *meow_img_downscale(meow_img *img, int maxdim);
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 */