AskaEth
ee5796747d
主仓 SDK 的图片层原本是 220 行 stb 直通（整幅解码后重采样）。公开仓 MeowOS-SDK 的同一子系统已被真实 App（tuku 阅读器）驱动并做过峰值实测与像素比对，故以公开仓 为权威方向并入主仓 meow_ui.a，两个方向的新功能都保留（逐文件 diff 确认公开仓是 严格超集：无一处「双方互有增减」）。 - 新增 meow_jpeg.c / meow_jpeg.h：DCT 域缩解 1/8、1/4、1/2（N=1/2/4 点 IDCT）， 渐进式只解到首个精细化扫描；不支持项（CMYK/YCCK、算术编码、过订阅 DHT、16bit 量化表）返回 0 由调用方回退 stb - 新增 meow_png_stream.c：libz 逐行 inflate + 反滤波，按步长丢行丢列直写目标尺寸； BMP 按目标行 seek + 行内跳列（8/16/24/32bpp） - meow_ui_img.c + include/meow_ui_image.h：新增 meow_img_pick_scale / load_file_step / load_file_step_ex / resample 四个公开入口；_dim 与 _mem_dim 先进后端，失败/不支持才回退 stb（对外语义不变） - include/meow_ui_draw.h + meow_ui_gfx.c：M32 RGB565 页图 5 函数 （meow_gfx_rgb565 / rgba_to_rgb565 / blit_rgb565 / _scaled）。gfx 保留主仓的 `#include "../meow_launcherd/meow_font.h"` 与 <time.h>（公开仓自 vendored meow_font.h 且无 <time.h>，机械覆盖会丢这两行） - meow_jpeg.h 保持内部：不进 meow_ui.h 伞头，include/ 下无任何头暴露 meow_jpeg_* - build_sdk.sh：OBJS 插入 meow_jpeg / meow_png_stream（32→34）；成员数 76→78（+meow_font.o +43 freetype），--verify 全为 ELF32 MIPS32 rel2/o32 - 测试：新增 test_meow_img_stream.c（S1-S16），test_meow_img_budget.c 同步公开仓 版（B9 断言收紧为 p_new <= p_old）；22 个既有宿主测试的编译注释行补 meow_jpeg.c / meow_png_stream.c / -lz（meow_ui_img.c 现引用后端符号，不加即 undefined reference） 宿主实测：S1-S16 全绿（S7 与 stb 网格像素一致：JPEG mad 4.35-13.69、PNG/BMP mad 0.00；S9 回退矩阵 CMYK/1bpp BMP/Adam7 均拒绝且 stb 仍成功），B1-B9 全绿 （B9 PNG 峰值 25.65→0.61 MiB、BMP 14.65→0.59 MiB）。回归 test_meow_ui_widgets / scroll / ime_fix / test_umbrella 全过。zlib 在应用链接期解析：meow_ui.a 只留 inflate* 未定义符号，四个 App 构建脚本原本就带 $SYSROOT/lib/libz.a，静态 linkcheck（meow_ui.a + libz.a -lpthread）通过。 注：主仓 patch_v2/reader_app 仍自带 vendored stb、不用 meow_img_*，本单不改变 阅读器的内存占用；RGB565 页图接入 reader_app 是另一个任务。
51 lines
3.0 KiB
C
51 lines
3.0 KiB
C
/*
|
||
* 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 */
|