使用Python+ZPL实现标签打印与中文排版

 更新时间:2026年02月03日 08:51:38   作者:GAMC  
这篇文章主要介绍了如何使用Python和ZPL(斑马打印机脚本语言)来解决标签打印问题,通过将内容先在Python中渲染成图片,然后转换成ZPL指令,实现了所见即所得、支持任意字体和无需配置打印机等优势,需要的朋友可以参考下

分享一下在本项目中,我们是如何利用 Python 优雅地解决 ZPL 打印。

1. 什么是 ZPL?

ZPL 是斑马公司为标签打印机开发的一套脚本语言。你可以把它想象成打印机界的“HTML”。通过发送一串类似 ^XA^FO50,50^A0N,50,50^FDHello World^FS^XZ 的指令,打印机就能在指定位置打印出文字。

2. 我们的秘密武器:降维打击

为了绕过 ZPL 繁琐的字体配置,我们采用了一种“降维打击”的策略:将所有内容(文字、条码、二维码)先在 Python 中渲染成一张图片,然后将图片转换成 ZPL 指令发给打印机。

这种方案的专业术语叫 “文本转位图”

核心优势:

  • 所见即所得:你在屏幕上看到的字体、间距,打印出来完全一致。
  • 支持任意字体:只要你电脑里有的字体(微软雅黑、阿里巴巴普惠体等),统统都能打印。
  • 无需配置打印机:不需要去折腾打印机的内存和字体文件,插上就能打。

3. 技术实现拆解

第一步:使用 Pillow 绘制“标签照”

我们利用 Python 的 Pillow 库,根据业务数据创建一个空白画布,然后在上面画图。

from PIL import Image, ImageDraw, ImageFont

# 创建一个 203 DPI 的小画布 (约 40mm x 30mm)
width, height = 320, 240
img = Image.new('1', (width, height), 1) # '1' 表示二值图(黑白)
draw = ImageDraw.Draw(img)

# 加载心仪的字体
font = ImageFont.truetype("msyh.ttc", 24) # 微软雅黑
draw.text((20, 20), "智能标签助手", font=font, fill=0)

第二步:将图片转换为 ZPL 十六进制数据

ZPL 提供了一个 ^GFA 指令,允许我们发送原始的图像字节数据。我们将 Pillow 处理好的黑白像素点,转换成打印机能听懂的十六进制字符串。

在本项目中,src/zpl_utils.py 负责这项繁琐的转换工作,确保每一行像素都能精准对应。

第三步:发送 RAW 数据到打印机

Windows 的普通打印驱动通常会经过图形层处理,速度较慢。为了追求极致响应,我们通过 pywin32 库直接向打印机发送 RAW(原始) 数据。

import win32print

def send_to_printer(printer_name, zpl_data):
    hPrinter = win32print.OpenPrinter(printer_name)
    try:
        # 开启打印作业,指定类型为 "RAW"
        hJob = win32print.StartDocPrinter(hPrinter, 1, ("Label Job", None, "RAW"))
        win32print.StartPagePrinter(hPrinter)
        win32print.WritePrinter(hPrinter, zpl_data.encode('utf-8'))
        win32print.EndPagePrinter(hPrinter)
        win32print.EndDocPrinter(hPrinter)
    finally:
        win32print.ClosePrinter(hPrinter)

4. 必备 ZPL 指令速查

在本项目中,我们虽然主要依赖图像传输,但仍需一些基础指令来定义标签。以下是核心指令说明:

指令说明作用
^XA标签开始告诉打印机:这是一张新标签的起点。
^XZ标签结束告诉打印机:指令发送完毕,可以开始打印/出纸了。
^PW打印宽度设置标签的宽度(以点 dots 为单位),防止内容被截断。
^LL标签长度设置标签的高度,决定了打印机走纸的距离。
^LH标签原点设置打印的起始坐标 (0,0) 的物理位置。
^MD打印浓度设置打印深度(0-30),觉得颜色不够黑?调它。
^FO字段坐标Field Origin,定义元素在标签上的 X,Y 轴位置。
^FS字段分隔符Field Separator,每个元素指令后的“句号”,必不可少。
^GFA图形 ASCII本方案的核心。它负责将我们转换好的十六进制图像数据“画”到标签上。

5. 总结

通过 Python + Pillow + ZPL (^GFA) 的组合,我们成功地将复杂的硬件编程转变成了熟悉的图形处理编程。

开发建议:

  1. DPI 匹配:打印机通常有 203 DPI 或 300 DPI 两种,绘图时要根据打印机型号计算好像素尺寸,否则打出来的标签会偏大或偏小。
  2. 二值化处理:在发送给打印机前,务必对图片进行阈值处理,确保只有纯黑和纯白,避免打印出“麻点”。
  3. 性能优化:对于固定格式的标签,可以缓存已经生成的 ZPL 模板,只替换变化的变量数据。

以上就是使用Python+ZPL实现标签打印与中文排版的详细内容,更多关于Python ZPL标签打印与中文排版的资料请关注脚本之家其它相关文章!

相关文章

最新评论