/*
 * meow_jpeg.h — M23 真缩解后端内部接口（**不对外导出**，不在 meow_ui.h 伞头里）。
 *
 * 后端直接产出「目标显示尺寸」的 RGBA，不做「先整幅解、再重采样」：
 *   - JPEG（meow_jpeg.c）：DCT 域缩解 1/8、1/4、1/2（N=1/2/4 点 IDCT），渐进式只解到
 *     首个精细化扫描（首个 Ah>0）为止——低频带此时已完整，再往后只是为了更细的量化精度。
 *   - PNG（meow_png_stream.c）：libz inflate 逐行 defilter，按步长丢行丢列直写目标尺寸。
 *   - BMP（meow_png_stream.c）：按行 seek + 行内跳列（同一套「只碰需要的行」思路）。
 * 三者峰值都只与「输出尺寸 + 目标图像」相关，不随源图分辨率线性增长——**前提是文件头
 * 声明的尺寸在合理范围内**：畸形/超大声明尺寸（例如 23 字节的 SOF 声明 65535×65535）会被
 * 直接拒绝（返回 0 → 回退 stb，安全失败），不会按声明尺寸分配平面。
 *
 * 不支持的特性一律返回 0，由 meow_ui_img.c 回退 stb（行为与 M23 之前完全一致）：
 * 4 分量 CMYK/YCCK、算术编码/无损/分层 JPEG、Adam7 交错 PNG、1/2/4bpp 与 RLE BMP 等。
 *
 * 许可证：本文件与 meow_jpeg.c / meow_png_stream.c 为 MeowOS 自写代码（MIT，随 SDK 发布）。
 * 不引入第三方解码器源码——理由见 M23 报告「为什么不用 IJG libjpeg」：libjpeg 系列对
 * 渐进式 JPEG 必须整幅驻留系数阵列（≈1 字节/源像素/分量），正是审计里 +23.5MB 的来源，
 * 换成它也无法把渐进式峰值压到 2.5MB 以内。
 */
#ifndef MEOW_JPEG_H
#define MEOW_JPEG_H

#include <stddef.h>
#include <stdio.h>

#ifdef __cplusplus
extern "C" {
#endif

/* 解码 path / 内存里的图，直接产出「长边 ≤ maxdim 且按 meow_img_downscale 同一公式等比缩放」
 * 的 tw×th RGBA（4 通道 straight alpha，malloc 分配，调用方 free）。
 * 返回 1 成功（tw/th/rgba 已填）；0 = 不支持/失败/不需要（调用方回退 stb 或旧入口）。 */
int meow_img_backend_file(const char *path, int maxdim, int *tw, int *th, unsigned char **rgba);
int meow_img_backend_mem(const void *buf, size_t len, int maxdim, int *tw, int *th, unsigned char **rgba);

/* 目标尺寸：与 meow_img_downscale 同一公式（长边 = maxdim，短边按比例截断，下限 1）。 */
void meow_img_target_dims(int w, int h, int maxdim, int *tw, int *th);

/* meow_png_stream.c 提供（PNG 逐行 inflate / BMP 按行跳采样）。f 与 mem 二选一：
 * f != NULL 走文件流（只读需要的行/块），否则从 mem[0..len) 读。 */
int meow_png_decode_stream(FILE *f, const unsigned char *mem, size_t len,
                           int maxdim, int *tw, int *th, unsigned char **rgba);
int meow_bmp_decode_stream(FILE *f, const unsigned char *mem, size_t len,
                           int maxdim, int *tw, int *th, unsigned char **rgba);

#ifdef __cplusplus
}
#endif
#endif /* MEOW_JPEG_H */