求助：如何将PDF转换为ZPL以适配Zebra打印机打印？

核心思路 #

Zebra打印机仅识别ZPL指令，无法直接解析PDF格式，因此必须先将PDF转换为图像，再把图像转换成匹配打印机DPI的ZPL指令，最后通过Socket发送给打印机。

具体步骤及代码示例 #

1. 安装依赖工具

先安装处理PDF转图片、图像转ZPL的必备库：

pip install pdf2image pillow zplgrf

注：pdf2image依赖poppler工具，Windows用户需下载poppler二进制包并配置环境变量；Linux/macOS可通过包管理器安装（如apt install poppler-utils）

2. 将PDF转成适配的图片

把PDF每页转成与打印机DPI匹配的黑白二值图（Zebra打印机常见DPI为203或300）：

from pdf2image import convert_from_path

# 转换PDF到图片列表，dpi参数需与打印机一致
pdf_pages = convert_from_path("your_input.pdf", dpi=203)
# 保存每页为黑白图片
for idx, page in enumerate(pdf_pages):
    bw_page = page.convert("1")  # 转黑白二值图，减少数据量
    bw_page.save(f"pdf_page_{idx}.png", "PNG")

3. 图片转ZPL指令

两种实现方式可选：

方式一：用PIL手动生成ZPL

from PIL import Image

def img_to_zpl(img_path, dpi=203):
    img = Image.open(img_path)
    width, height = img.size
    # 计算ZPL图像数据的字节宽度（每字节对应8个像素）
    byte_width = (width + 7) // 8
    # 构建ZPL指令框架
    zpl_content = f"^XA\n^FO20,20^GFA,{height*byte_width},{height*byte_width},{byte_width},"
    # 将图像像素转为十六进制字符串
    pixel_bytes = img.tobytes()
    zpl_content += pixel_bytes.hex().upper()
    zpl_content += "\n^XZ"
    return zpl_content

# 生成单页ZPL代码
single_page_zpl = img_to_zpl("pdf_page_0.png")

方式二：用zplgrf库简化转换

from zplgrf import ImageConverter

# 直接传入图片路径和打印机DPI生成ZPL
converter = ImageConverter(image_path="pdf_page_0.png", dpi=203)
single_page_zpl = converter.to_zpl()

4. 通过Socket发送ZPL到打印机

import socket

# 替换为你的打印机IP和端口（Zebra默认端口为9100）
PRINTER_IP = "192.168.1.10"
PRINTER_PORT = 9100

with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
    s.connect((PRINTER_IP, PRINTER_PORT))
    # 发送ZPL指令，编码为UTF-8
    s.sendall(single_page_zpl.encode("utf-8"))

关键注意事项 #

• DPI匹配：转图片时的DPI必须与打印机实际DPI一致，否则打印尺寸会出现偏差。
• 多页处理：若PDF有多页，循环处理每一页生成ZPL，依次发送即可。
• 图像优化：优先使用黑白二值图，减少ZPL数据量，提升打印速度和成功率。

内容的提问来源于stack exchange，提问作者ErPeppe99