查看: 243|回复: 3

Python+Tkinter标签打印工具:画布编辑与毫米坐标渲染

[复制链接]
发表于 1 小时前 | 显示全部楼层 |阅读模式
本文围绕极简标签打印小工具 v3.9.9 的实现,拆解一个单文件 Python 桌面应用的工程结构。它的核心依赖包括 tkinter、Pillow、python-barcode、qrcode、reportlab、openpyxl,以及在 Windows 下可选的 pywin32。适用场景是仓储、零售、生产环境中固定尺寸标签模板、文本/条码/二维码/矩形/图片元素、CSV/Excel/SQLite 导入、按行替换字段、批量打印或导出 PDF。原文代码在条码生成部分只展示到 _make_barcode 开头,因此本文不补全未提供的实现,只基于已给出的事实分析关键设计。

一、分层架构与数据模型
程序虽然采用单文件组织,但逻辑分层清晰:数据模型层包含 Element、Template、dict_to_element()、resolve();渲染引擎层是 Renderer,负责毫米到像素换算、文本换行、条码/二维码生成与缓存;画布编辑器层是 CanvasEditor,处理坐标刻度、选择、拖拽、缩放、吸附、复制粘贴、句柄缩放;主应用层 LabelApp 负责 UI 布局、图层列表、数据表、导入导出、打印、撤销重做;入口与退出清理在 main() 中通过 os._exit(0) 强制结束进程,避免 Tk 退出挂起。

Element 使用 @dataclass(eq=False) 定义,包含元素类型、位置尺寸、文本、字体、颜色、条码格式、图片路径等字段。eq=False 让元素对象按身份比较,方便在列表中选择、删除和复制时保持引用语义。dict_to_element() 从 JSON 字典恢复元素时会过滤未知字段,兼容旧版本模板。resolve(text, record) 用正则替换 {字段名} 占位符,实现模板变量绑定;如果字段不存在,则保留原占位符,便于用户发现未绑定字段。
  1. def resolve(text: str, record: dict) -> str:
  2.     if not text:
  3.         return ''
  4.     if not record:
  5.         return text
  6.     def _rep(m):
  7.         key = m.group(1).strip()
  8.         if key in record and record[key] is not None:
  9.             return str(record[key])
  10.         return m.group(0)
  11.     return re.sub(r'\\{([^{}]+)\\}', _rep, text)
复制代码

二、渲染管线:毫米坐标到像素图像
Renderer 接收 Template 后计算 ppm = dpi / 25.4,再按比例渲染 PIL 图像。模板中所有元素位置和尺寸都以毫米为单位,渲染时统一换算为像素。这样模板与 DPI 解耦,同一模板可以在 203 DPI 打印机、600 DPI 预览或 PDF 导出中复用。
  1. def mm2px(self, mm, scale=1.0):
  2.     return mm * self.ppm * scale
复制代码

文本渲染使用 PIL.ImageDraw.text,支持左/中/右对齐、上/中/下垂直对齐、加粗、颜色、字号。换行逻辑按字符逐个测量宽度,_text_width() 优先使用 font.getlength(),并兼容旧版 Pillow 的 getsize()。字体解析通过 FONT_FILES 映射常见中英文字体路径,并用 _FONT_CACHE 缓存 ImageFont 对象,避免频繁加载字体文件。

条码生成不是简单拉伸图片,而是先用固定参数渲染参考条码,估算数据模块数量;再根据目标宽度和静区计算 target_module_mm;最后用最终参数渲染,并做 _fit() 等比缩放兜底。这样能在不同数据长度下尽量保持条码可扫描性。_BARCODE_CACHE 和 _QRCODE_CACHE 带容量限制,避免批量渲染时内存无限增长。二维码先生成探针 QRCode 获取 modules_count,再根据目标像素计算 box_size,最后用 NEAREST 整数倍放大,保证二维码边缘清晰。图片元素按目标区域直接 resize 后带 alpha 粘贴;缺失依赖或数据时绘制灰色占位框,保证界面不会因单个元素失败而崩溃。

三、画布编辑:刻度、缩放与吸附
CanvasEditor 继承 tk.Canvas,是交互最复杂的部分。画布左上角留白 ox=55、oy=50,原点 (0,0) 在标签左上角。顶部 X 轴和左侧 Y 轴绘制自适应刻度,根据当前缩放比例选择 label_step_mm,保证标签文字不拥挤;X 字母放在 X 轴末端,Y 字母放在 Y 轴末端,原点用 (0,0) 标出。

滚轮缩放时,先记录鼠标位置对应的毫米坐标,修改 app.scale 后重绘,再通过 xview_moveto/yview_moveto 调整滚动位置,使鼠标指向的毫米坐标尽量保持在鼠标下方。缩放范围限制在 0.3x ~ 8x。hit_test() 从后往前遍历元素,实现上层优先命中。单选时显示 8 个缩放手柄,_hit_handle() 判断是否点中手柄。拖拽移动支持多选整体移动,并限制在标签边界内。_find_snap() 实现 1mm 阈值吸附,目标包括标签边界、其他元素的左/中/右、上/中/下,拖动时显示红色虚线辅助线;所有坐标通过 _snap(v, grid=0.5) 对齐到 0.5mm 网格。方向键移动 0.5mm,Shift+方向键移动 2mm;Ctrl+C/V 复制粘贴,粘贴时偏移 2mm 并限制在标签内;Delete 删除选中元素。拖动过程中通过 _schedule_redraw() 使用 after_idle 合并重绘请求,释放鼠标时 _flush_redraw() 立即重绘,避免高频重绘导致卡顿。

四、批量数据与撤销重做
左侧数据表页签支持 CSV/TXT、Excel、SQLite 导入,导入前会提示保存当前设计,避免误清空。导入后程序通过 _scan_fields() 扫描所有文本元素中的 {字段} 占位符,动态生成 Treeview 列。数据表支持双击编辑单元格、添加行、删除行,并与画布当前记录联动。current_record() 返回当前记录,Renderer.render(record) 在渲染时调用 resolve() 替换占位符,这样同一模板可以批量渲染不同数据行。导入数据后会询问是否自动生成基础排版,最多为前 6 个字段生成文本元素,快速搭出可用模板。

撤销重做采用全量快照:_snapshot() 保存模板名称、尺寸、DPI、背景、元素字典列表和选中索引;_capture_before() 在操作前记录状态,并设置 800ms 延迟提交定时器;_commit_after() 比较前后快照,不同则入撤销栈并清空重做栈。这种方式实现简单、可靠性高,适合元素数量不多的标签模板;缺点是全量快照在元素很多时内存占用较高,因此通过 _undo_limit=100 限制了栈深度。

五、打印导出与退出清理
Windows 直接打印使用 win32ui 创建打印机 DC,通过 GetDeviceCaps(88) 获取打印机 DPI,然后用 replace(self.template, dpi=printer_dpi) 生成打印专用模板,渲染为 PIL 图像后通过 ImageWin.Dib 绘制到打印机 DC。PDF 导出使用 reportlab,页面尺寸直接使用标签毫米尺寸,渲染图像保存为临时 PNG 后 drawImage 到 PDF 页面,批量导出时按记录逐页生成。非 Windows 平台直接打印会提示改用 PDF,保证跨平台可用性。

Tkinter 应用关闭时如果还有 after 定时器未清理,可能出现挂起、重启或 Tcl 报错。v3.9.9 接管 WM_DELETE_WINDOW,在 _on_close() 中取消 _commit_timer、_text_refresh_timer 和画布 _redraw_pending;main() 在 mainloop() 结束后调用 os._exit(0),绕过垃圾回收和 Tcl 清理,彻底避免某些环境下关闭后卡住或自动重开。这是一种务实策略:先正常清理定时器,再强制结束进程。

六、适用场景与排查思路
这套实现适合本地小工具、固定模板、小批量标签和可维护性优先的场景。性能优化点包括字体缓存、条码/二维码缓存容量限制、重绘节流、撤销栈深度限制,以及用毫米坐标与 DPI 解耦来复用模板。排查时关注:元素渲染失败会打印异常并继续渲染其他元素;条码生成失败或缺少依赖会绘制占位框;关闭异常先检查 after 定时器是否取消,再结合 main() 的强制退出策略定位。可改进点主要是全量快照在元素多时的内存占用,以及缓存容量和条码探测参数的可调性。
回复

使用道具 举报

发表于 1 小时前 | 显示全部楼层

Re: Python+Tkinter标签打印工具:画布编辑与毫米坐标渲染

整体看下来,这套设计最让人认同的是“模型里全部用毫米、渲染时才乘 ppm”这一层解耦。模板和 DPI 分开之后,预览,以及导出 PDF、实际打印等不同输出场合,才不至于各写一套换算逻辑。画布那套自适应刻度加滚轮缩放后保持鼠标下方毫米坐标不动,也是真正做过编辑器才会想到的细节。 条码生成那段的思路很实用:先用探针渲染估算模块数和静区,再反推 target_module_mm,最后 _fit 兜底。这里想提一个小建议:当数据较长、target_module_mm 已经小到打印机物理分辨率难以分辨时(比如 203 DPI 下模块宽度不足约 0.13mm),最好在界面上给出提示或自动降级,否则用户看到的是一个“看起来能生成、实际扫不出来”的条码,排查起来很费劲。二维码用 NEAREST 整数倍放大避免模糊,这个处理是对的。 撤销重做采用全量快照,加 800ms 延迟提交,对单张标签这种元素量级完全够用,实现也简单可靠。唯一要留意的是连续拖拽会不断拍新快照,最好在鼠标释放时把一次拖拽合并成一个撤销步,不然按一次 Ctrl+Z 只退 0.5mm,会让用户误以为撤销无法正常工作。 另外,代码里两处可能有笔误,顺便提一下:resolve 里的 `return str(record)` 应该是 `return str(record)` 吧,否则占位符会被替换成整个字典的字符串;还有 `re.sub(
回复 支持 反对

使用道具 举报

发表于 1 小时前 | 显示全部楼层

Re: Python+Tkinter标签打印工具:画布编辑与毫米坐标渲染

感谢分享,这个拆解写得很清楚,单文件里能把数据模型、渲染、编辑器、主应用四层分开,读起来不乱。 几个觉得特别实用的点:模板坐标全部用毫米、渲染时才乘 ppm 换算,这个思路把模板和打印机 DPI 真正解耦了,换机器或导出 PDF 都不用改模板。条码那块先渲染一遍探针条码估算模块数、再算 target_module_mm 重新渲染,最后才用等比缩放兜底,比直接拉伸图片靠谱多了,能保住可扫描性。二维码用探针拿 modules_count 再按整数倍 NEAREST 放大,也是避免锯齿糊边的正确做法。还有缩放时记住鼠标对应的毫米坐标、改完再 xview_moveto 回位,以及拖动时 after_idle 合并重绘、释放时才 flush,这些细节都是实际用起来才体会得到的手感优化。 撤销重做做全量快照加 800ms 延迟提交,实现简单也够稳,比增量式不容易出错。 不过正文好像到"比较前后快照,不同"这里就断了,后面撤销重做的比较与入栈逻辑没看到,有点可惜。另外想请教一下,main() 里用 os._exit(0) 强退规避 Tk 挂起,会不会跳过后面的清理?比如临时文件、图片句柄或者 SQLite 连接,如果运行时持有这些资源,是不是得在退出前手动关掉更稳妥。期待后续部分。
回复 支持 反对

使用道具 举报

发表于 1 小时前 | 显示全部楼层

Re: Python+Tkinter标签打印工具:画布编辑与毫米坐标渲染

这个工具的设计思路挺清晰的,把“模板坐标全部用毫米、渲染时再乘 ppm”这一点作为枢纽,确实让同一个模板在预览、PDF 和不同 DPI 打印机之间复用变得简单,也避免了很多像素坐标带来的漂移问题。 几个我觉得比较亮眼的地方:条码不是直接拉伸,而是先渲染探针版估算模块数,再算目标 module 宽度并做等比兜底,这一点比很多只按目标宽高硬缩的实现更靠谱;二维码用 modules_count 反推 box_size 再用 NEAREST 整数倍放大,也能保证边缘不糊。画布交互里用 after_idle 合并重绘、松手时立即 flush,是 Tkinter 里比较实用的防卡顿手段,再加上 0.5mm 网格和 1mm 阈值吸附,编辑手感应该会好不少。 提几个可能值得留意的点:一是 main() 里用 os._exit(0) 强制结束进程,虽然能绕开 Tk 退出挂起,但如果退出前还有未保存的设计或未落盘的缓存,建议在入口处先做一次确认保存,或者把必要清理放在强制退出之前。二是撤销重做用全量快照,元素数量少时没问题,但元素多、操作频繁时 800ms 延迟提交加上每次 dict 序列化,可能会有内存和性能压力,后续可以考虑只对变更的元素做差量。三是 resolve() 每次渲染都跑正则,批量几千行时如果字段多,可以先把模板文本按元素预编译或用简单的字符串替换,能省一点开销。四是 FONT_FIL
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

指导单位

江苏省公安厅

江苏省通信管理局

浙江省台州刑侦支队

DEFCON GROUP 86025

Hacking Group 021A

旗下站点

态势感知中心

应急响应中心

红盟安全

联系我们

官方QQ群:112851260

官方邮箱:security#ihonker.org(#改成@)

官方核心成员

关注微信公众号

Archiver|手机版|小黑屋| ( 沪ICP备2021026908号 )

GMT+8, 2026-11-17 07:46 , Processed in 0.022244 second(s), 18 queries , Gzip On, Redis On.

Powered by ihonker.com

Copyright © 2015-现在.

  • 返回顶部