176 lines
11 KiB
Python
176 lines
11 KiB
Python
# -*- coding: utf-8 -*-
|
|
"""document-photo-to-pdf 的全部可调参数。
|
|
|
|
改这里之前先读这段:
|
|
- 这些值大多沿用旧流程(人工读网格图)的经验值,**没有用真实样张重新标定**。
|
|
没有样张时只改行为开关,不要凭感觉调阈值。
|
|
- 像素类的值默认指“检测处理图”坐标(检测会先缩到 detect.max_side),不是原图像素;
|
|
带 _frac / _pct / _div 的是比例。少数原图/画布坐标的值会在字段名里写明 _px。
|
|
- 纸张尺寸用毫米,画布像素由 render.dpi 换算,避免 1240/1754 这类数字散落各处。
|
|
"""
|
|
P = {
|
|
"schema": "document-photo-to-pdf/2",
|
|
|
|
# ---------------------------------------------------------------- 检测
|
|
"detect": {
|
|
"max_side": 1600, # 检测降采样长边;越大越准越慢
|
|
"min_edge_points": 40, # 单边拟合所需最少点数,低于则回退掩膜线
|
|
"side_support_frac": 0.25, # 单边支撑度:点数至少要达边长的这个比例,
|
|
# 不足则这条边退回矩形边(防止角点被甩飞)
|
|
"group_tol_px": 22.0, # 边线点归属容差(处理图像素)
|
|
"robust_px": 2.0, # 稳健拟合的残差基准(处理图像素)
|
|
"mask_erode_kernel": 3, # 掩膜内收核;3 = 半径 1 像素
|
|
"paper_otsu_floor": 0.50, # 纸面阈值下限,防止亮桌面被并入
|
|
"paper_v_min": 0.50, # 纸面亮度硬下限
|
|
"paper_s_max": 0.45, # 纸面饱和度上限
|
|
"paper_mask_factor_div": 400, # 掩膜降采样倍数 = min(H,W)//该值
|
|
"paper_close_div": 60, # 第一次闭运算核 = min(H,W)//该值
|
|
"paper_close_min": 5, # 形态学核最小值
|
|
"paper_close2_div": 80, # 第二次闭运算核 = min(H,W)//该值
|
|
"paper_open_div": 90, # 开运算核 = min(H,W)//该值(去布面高光碎点/细桥)
|
|
"paper_open_min": 5,
|
|
"band_div": 45, # 搜索环带宽度 = H//该值
|
|
"band_min": 15, # 环带宽度下限
|
|
"edge_local_gain": 1.55, # 边缘图局部阈值增益
|
|
"edge_low": 0.035, # 边缘图绝对下限
|
|
"edge_sigma_div": 800, # 高斯模糊 sigma = H//该值
|
|
"edge_box_div": 50, # 局部均值窗口 = H//该值
|
|
"step_r_small": 10, # 阶跃检测小窗半径
|
|
"step_r_big": 24, # 阶跃检测大窗半径
|
|
"step_th": 0.055, # 跨纸边亮度阶跃阈值
|
|
"cand_close_div": 160, # 候选边线闭运算 = H//该值
|
|
"cand_close_min": 5,
|
|
"cand_open_div": 500, # 候选边线开运算 = H//该值
|
|
"cand_open_min": 3,
|
|
"coverage_tol_div": 110, # 覆盖率检测容差 = H//该值
|
|
"coverage_tol_min": 10,
|
|
"corner_oob_frac": 0.15, # 角点越界允许幅度(相对画面长边)
|
|
"boundary_side_margin": 0.10, # 拟合单边时排除两端各 10%,避开角点
|
|
|
|
# ---- 四边形候选择优
|
|
# 不再用“与矩形的夹角/位移上限”当门槛:真实拍摄的纸张是梯形,
|
|
# 左右两边本来就该一边内收一边外放,用矩形先验会把透视判成错误。
|
|
# 改为在 [矩形 / 掩膜边界拟合 / 边缘点拟合] 里按与纸面掩膜的 IoU 选优。
|
|
"iou_step": 2, # IoU 粗网格采样步长(处理图像素)
|
|
|
|
# ---- 贴边吸附(snap):沿每条边的法向在 ±band 内找梯度极值重拟合
|
|
"snap_enable": False, # 默认关闭:实测布面/塑料袋场景会跳到干扰结构上
|
|
"snap_band": 42, # 搜索半宽(处理图像素)
|
|
"snap_grad_min": 0.05, # 可接受的最小梯度
|
|
"snap_samples": 96, # 单边采样数
|
|
"snap_max_shift_frac": 0.10, # 吸附造成的最大角点位移(相对画面短边)
|
|
|
|
# ---- 收缝:把每条边推进到掩膜边界,去掉遗留的背景毛边
|
|
"shrink_enable": True,
|
|
"shrink_search": 80, # 向内搜索上限(处理图像素)
|
|
"shrink_max_frac": 0.05, # 单边内推上限(相对画面短边)
|
|
"shrink_keep_px": 1.5, # 留一点余量,不把自己压到纸上
|
|
|
|
# ---- 自适应纸面掩膜(替代原先固定的 v/s/floor 三件套)
|
|
# 旧实现用一组硬阈值,遇到“亮背景 + 低饱和纸张”(蓝布、塑料袋、亮桌面)
|
|
# 时背景会和纸并进同一连通域,掩膜一路贴到画面边缘,后续拟合出的
|
|
# “纸边”其实是照片边框。改为在下面这组候选里挑一个最像“一张纸”的:
|
|
# v = 亮度下限(V)、s = 饱和度上限(S)、o = Otsu 阈值的缩放系数
|
|
"mask_ladder": [
|
|
{"v": 0.50, "s": 0.45, "o": 1.00}, # 旧行为,作为兜底候选
|
|
{"v": 0.52, "s": 0.16, "o": 0.90},
|
|
{"v": 0.58, "s": 0.20, "o": 0.88},
|
|
{"v": 0.62, "s": 0.14, "o": 0.86},
|
|
{"v": 0.68, "s": 0.14, "o": 0.84},
|
|
{"v": 0.76, "s": 0.16, "o": 0.82},
|
|
],
|
|
"mask_min_bright_frac": 0.02, # 候选的原始合格像素占比下限
|
|
"mask_max_bright_frac": 0.96, # 上限:几乎全图都合格说明没分出纸
|
|
"mask_area_min": 0.02, # 掩膜面积占比合理区间
|
|
"mask_area_max": 0.90,
|
|
"mask_score": { # 候选打分权重(越大越像一张纸)
|
|
"solidity": 1.0, # 面积 / 凸包面积
|
|
"rect_fill": 1.4, # 面积 / 最小外接矩形面积
|
|
"border_touch": 3.2, # 掩膜贴画面边缘的惩罚
|
|
"aspect": 0.6, # 宽高比越接近 [0.2, 5] 越好
|
|
"contrast": 0.5, # 掩膜内外的亮暗差
|
|
},
|
|
"mask_aspect_min": 0.18, # 纸面宽高比合理区间(含横竖)
|
|
"mask_aspect_max": 5.5,
|
|
"mask_quality_max_pts": 1500, # 打分时凸包/矩形的最大采样点数(性能开关)
|
|
},
|
|
|
|
# ---------------------------------------------------------------- 几何门槛
|
|
"gate": {
|
|
"oob_max_pct": 15.0, # 越界超过此值判失败
|
|
"inner_paper_min": 0.60, # 框内纸面占比下限
|
|
"inner_edge_min": 0.62, # 每边内侧纸面占比下限
|
|
# (旧值 0.75 对“矩形比掩膜略大”的正常情形误报;
|
|
# 旧的错位案例实测只有 0.14~0.47,0.62 仍能拦住)
|
|
"outer_dark_min": 0.35, # 外侧暗像素占比低于此值只告警
|
|
"repair": True, # 校验不过时先尝试“重拟合”而不是直接扔兜底框
|
|
"repair_fallback": "rect", # rect = 用掩膜的最小外接矩形;off = 直接兜底框
|
|
"coverage_warn": 0.40, # 四边覆盖率低于此值告警(未标定)
|
|
"aspect_deadband": 0.10, # 0.9~1.1 视为接近正方形,不参与方向投票
|
|
"paper_mismatch_pct": 20.0, # 与批次中位宽高比偏差超过此值告警
|
|
"sample_n": 60, # 校验采样网格边长
|
|
"sample_shrink": 0.88, # 框内采样内收比例
|
|
"fallback_inset": 0.03, # 检测为空时的兜底矩形:画面短边向内缩的比例
|
|
},
|
|
|
|
# ---------------------------------------------------------------- 调色档
|
|
# 全局四档,对应审核页的“图像处理”。都是“整体等比映射 + 可选灰度”:
|
|
# 不做二值化——二值化会吃拮抗锯齿,笔画变胖变瘦,等于重绘文字。
|
|
"enhance": {
|
|
"original": None, # 原样:不提亮
|
|
"normal": {"target": 245, "pct": 97}, # 标准
|
|
"strong": {"target": 252, "pct": 90}, # 加强:背景白得更彻底
|
|
"bw": {"target": 252, "pct": 60, "gray": True}, # 黑白(保留灰阶)
|
|
},
|
|
|
|
# ---------------------------------------------------------------- 出页
|
|
"render": {
|
|
"dpi": 150, # PDF 输出 dpi
|
|
"margin_px": 40, # PDF 页面四周留白(150dpi 下的像素)
|
|
"brighten_target": 245, # 提亮目标:97 分位映射到该亮度
|
|
"brighten_pct": 97,
|
|
"warp_chunk_rows": 256, # 透视变换分块行数,控制峰值内存
|
|
"default_paper": "auto", # auto=按批次中位比例统一版式,A4 画布内留白
|
|
"default_enhance": "normal", # 调色档默认值,可选 key 见 P["enhance"]
|
|
"enhance": "normal", # 本次生效的调色档(run.py 按参数覆写副本)
|
|
"dpi_options": {"standard": 150, "high": 300}, # 清晰度档名 -> dpi
|
|
"papers_mm": {
|
|
"a4": (210.0, 297.0),
|
|
"letter": (215.9, 279.4),
|
|
"16k": (185.0, 260.0),
|
|
"b5": (176.0, 250.0),
|
|
},
|
|
},
|
|
|
|
# ---------------------------------------------------------------- PDF 检验
|
|
"check": {
|
|
"dpi": 100, # 检验渲染 dpi
|
|
"min_short": 800, # 纸面短边下限(按 150dpi 基准,随 dpi 换算)
|
|
"ratio_tol": 0.08, # 纸面比例偏差提示阈值(仅提示)
|
|
"border_ratio": 0.80, # 边带亮度 / 纸面亮度 下限
|
|
"edge_warnings": False, # 边缘背景残留/内容贴边是否升为 warning
|
|
# (启发式、未标定,误报多;默认只留在 checks)
|
|
"edge_dark_ratio": 0.60, # 边带“暗像素”亮度 / 纸面亮度
|
|
"edge_dark_frac": 0.35, # 边带暗像素占比上限
|
|
"cut_frac": 0.05, # 最外带内文字级暗像素占比上限
|
|
"cut_mean_ratio": 0.70, # 贴边带均值低于纸面该比例才算成片暗
|
|
"edge_inset_frac": 0.002, # 纸面框内缩比例,避开透视采样毛边
|
|
"border_band_frac": 0.012, # 边带宽度 = 纸面短边 * 该值
|
|
"cut_band_frac": 0.003, # 贴边检测带宽度 = 纸面短边 * 该值
|
|
"paper_pct": 80, # 纸面亮度分位
|
|
"back_pct": 2, # 背景亮度分位
|
|
"ink_ratio": 0.80, # 墨色阈值上限 = 纸面亮度 * 该值
|
|
"flat_pct": 99.5, # 页面纯白分位
|
|
"nonwhite_delta": 8.0, # 低于纯白该值视为非白(用于找纸面框)
|
|
"paper_row_frac": 0.05, # 行列非白占比阈值
|
|
"tmp_dir": ".tmp/pdfcheck", # 检验渲染临时目录(相对输出目录,检验完即删)
|
|
},
|
|
|
|
# ---------------------------------------------------------------- 输出
|
|
"output": {
|
|
"default_name": "文档照片_校正.pdf",
|
|
"state_suffix": ".state.json",
|
|
"max_logs": 20,
|
|
},
|
|
}
|