#!/usr/bin/env python3 """生成 QFT 分辨率楔形标定图。 python scripts/wedge_gen.py --width 1920 --height 1080 --out out/wedge 产出三个文件: .png 标定图本体(必须 1:1 显示,任何缩放都会让测量失效) .json 规格,wedge_analyze.py 用它反解几何与期望比特 .html 全屏 1:1 查看器,自带缩放校验 显示方法(二选一): A. 用浏览器打开 .html,按 F11 全屏。页面会显示「缩放 1.000 ✅」才算有效。 B. 任何能保证 100% 原始像素显示的看图工具,且系统 DPI 缩放为 100%。 拍摄方法: - 手机大致正立(旋转 < 45°),让四个黑色角标都在画面内且尽量填满画面; - 关闭闪光灯,对焦到屏幕上; - 建议在 2~4 个不同距离各拍一张,这样能把 px/模块 曲线的采样点连起来。 """ import argparse import os import sys sys.path.insert(0, os.path.dirname(os.path.abspath(__file__))) from wedge_common import build_spec, render, DEFAULT_PITCHES, DEFAULT_SEED # noqa: E402 VIEWER_HTML = """ QFT 标定图 1:1 查看器
测量中…(按 H 隐藏此框,F11 全屏)
""" def main() -> int: parser = argparse.ArgumentParser(description="生成 QFT 分辨率楔形标定图") parser.add_argument("--width", type=int, default=1920, help="画布宽(显示设备像素)") parser.add_argument("--height", type=int, default=1080, help="画布高(显示设备像素)") parser.add_argument("--pitches", type=str, default=",".join(str(p) for p in DEFAULT_PITCHES), help="各条带的模块尺寸,单位显示像素,逗号分隔(必须为整数)") parser.add_argument("--seed", type=int, default=DEFAULT_SEED) parser.add_argument("--out", type=str, default="out/wedge", help="输出前缀,不带扩展名") args = parser.parse_args() try: pitches = [int(p) for p in args.pitches.split(",") if p.strip()] except ValueError: print("--pitches 必须是逗号分隔的整数", file=sys.stderr) return 2 try: spec = build_spec(args.width, args.height, pitches, args.seed) except ValueError as exc: print("规格无效:%s" % exc, file=sys.stderr) return 2 from PIL import Image canvas = render(spec) out_dir = os.path.dirname(os.path.abspath(args.out)) if out_dir: os.makedirs(out_dir, exist_ok=True) png_path = args.out + ".png" json_path = args.out + ".json" html_path = args.out + ".html" Image.fromarray(canvas).save(png_path, optimize=True) with open(json_path, "w", encoding="utf-8") as fh: fh.write(spec.to_json()) with open(html_path, "w", encoding="utf-8") as fh: fh.write(VIEWER_HTML.replace("__PNG__", os.path.basename(png_path))) print("已生成:") print(" %s %d×%d" % (png_path, spec.canvas_w, spec.canvas_h)) print(" %s" % json_path) print(" %s ← 用浏览器打开并按 F11 全屏" % html_path) print() print("条带(模块尺寸以显示像素计):") total = 0 for band in spec.bands: total += band.modules print(" #%d pitch=%2d px %4d×%-3d = %6d 模块" % (band.index, band.pitch_px, band.cols, band.rows, band.modules)) print(" 合计 %d 模块" % total) print() print("拍摄后运行:python scripts/wedge_analyze.py --spec %s --photo <照片>" % json_path) return 0 if __name__ == "__main__": raise SystemExit(main())