pintubug

scan-panorama/README.md

@@ -23,7 +23,7 @@ scan-panorama/
 ## 依赖
 
 - Python 3
-- ImageMagick的`identify`和`montage`
+- ImageMagick的`identify`、`convert`和`montage`
 
 当前RK3588设备已经安装这些依赖，可用下面的命令检查：
 
@@ -31,6 +31,7 @@ scan-panorama/
 python3 --version
 identify -version
 montage -version
+convert -version
 ```
 
 ## 最简单的使用方法
@@ -131,6 +132,18 @@ find /userdata/data/scan -mindepth 1 -maxdepth 1 -type d -printf '%f\n' | sort
 
 任一检查失败时不会生成拼图，并会在终端中说明具体问题。
 
+## 大型网格和内存保护
+
+程序不会一次性打开全部4K原图，而是按以下顺序处理：
+
+1. 每次只读取一张原图并生成缩略图；
+2. 每一行的小缩略图合并完成后立即删除该行临时缩略图；
+3. 最后把已经缩小的行图纵向合并为验证大图。
+
+若ImageMagick仍报告`cache resources exhausted`、内存分配失败或临时缓存空间不足，程序会
+自动把单格宽度降到原计划的75%、50%并重新尝试。临时目录无论成功失败都会删除，不需要提高
+ImageMagick的系统缓存上限，也不会影响原始扫描图片。
+
 ## 如何查看结果
 
 桌面环境下可以直接打开：