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

目录

• 1. 什么是 ZPL？
• 2. 我们的秘密武器：降维打击
• 核心优势：
• 3. 技术实现拆解
• 第一步：使用 Pillow 绘制“标签照”
• 第二步：将图片转换为 ZPL 十六进制数据
• 第三步：发送 RAW 数据到打印机
• 4. 必备 ZPL 指令速查
• 5. 总结
• 开发建议：

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

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

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

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

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

我们利用 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 提供了一个 ^GFA 指令，允许我们发送原始的图像字节数据。我们将 Pillow 处理好的黑白像素点，转换成打印机能听懂的十六进制字符串。

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

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)

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

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

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

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

以上就是使用Python+ZPL实现标签打印与中文排版的详细内容，更多关于Python ZPL标签打印与中文排版的资料请关注风君子博客其它相关文章！

您可能感兴趣的文章:

• Python 实现自动完成A4标签排版打印功能
• python解析HTML并提取span标签中的文本
• Python中所有子图标签Legend显示问题记录
• 利用Python定位Span标签中文字的实战指南
• 使用python和yolo方法实现yolo标签自动标注