使用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标签打印与中文排版的资料请关注脚本之家其它相关文章!

相关文章

  • Python数据分析之pandas函数详解

    Python数据分析之pandas函数详解

    这篇文章主要介绍了Python数据分析之pandas函数详解,文中有非常详细的代码示例,对正在学习python的pandas函数的小伙伴们有很好地帮助,需要的朋友可以参考下
    2021-04-04
  • Python中zipfile压缩包模块的使用

    Python中zipfile压缩包模块的使用

    zipfile 模块提供了创建、读取、写入、添加及列出 ZIP 文件的工具,本文主要介绍了Python中zipfile压缩包模块的使用,感兴趣的可以了解一下
    2021-05-05
  • pytorch中view和reshape的区别

    pytorch中view和reshape的区别

    本文主要介绍了PyTorch中view和reshape在处理张量形状变化时的区别,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2026-04-04
  • NumPy数据类型对象(dtype)的构造方式

    NumPy数据类型对象(dtype)的构造方式

    这段文章详细介绍了NumPy中的`numpy.dtype`类及其应用用,涵盖数据类型对象的创建、属性及用示例,关键点包括:`numpy.dtype`类、数据类型对象、示例
    2026-05-05
  • Scrapy爬虫多线程导致抓取错乱的问题解决

    Scrapy爬虫多线程导致抓取错乱的问题解决

    本文针对Scrapy爬虫多线程导致抓取错乱的问题进行了深入分析,并提出了相应的解决方案,具有一定的参考价值,感兴趣的可以了解一下
    2023-11-11
  • Python实现购物车功能的方法分析

    Python实现购物车功能的方法分析

    这篇文章主要介绍了Python实现购物车功能的方法,结合实例形式分析了Python实现购物车功能的具体步骤、相关操作技巧与注意事项,需要的朋友可以参考下
    2017-11-11
  • TensorFlow使用Graph的基本操作的实现

    TensorFlow使用Graph的基本操作的实现

    这篇文章主要介绍了TensorFlow使用Graph的基本操作的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-04-04
  • Python列表list内建函数用法实例分析【insert、remove、index、pop等】

    Python列表list内建函数用法实例分析【insert、remove、index、pop等】

    这篇文章主要介绍了Python列表list内建函数用法,结合具体实例形式分析了list中insert、remove、index、pop等函数的功能、使用方法与相关注意事项,需要的朋友可以参考下
    2017-07-07
  • 基于python3实现倒叙字符串

    基于python3实现倒叙字符串

    这篇文章主要介绍了基于python3实现倒叙字符串,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-02-02
  • Python3.X 线程中信号量的使用方法示例

    Python3.X 线程中信号量的使用方法示例

    信号量semaphore 是一个变量,控制着对公共资源或者临界区的访问。信号量维护着一个计数器,指定可同时访问资源或者进入临界区的线程数。下面这篇文章主要给大家介绍了关于Python3.X 线程中信号量的使用方法,需要的朋友可以参考借鉴,下面来一起看看吧。
    2017-07-07

最新评论