【Python_Zebra斑马打印机编程学习笔记（四）】ZPL的一些简单指令_programminglanguage.zpl

ZPL的一些简单指令

前言

本文介绍 ZPL 的一些简单指令，有需要的读者可以点赞收藏，也欢迎在评论区进行讨论。

一、ZPL 介绍

ZPL (Zebra Programming Language) 是斑马 (Zebra) 条码打印机工业型号用的编程语言，兼容市面上的大部分条码打印机，可用于绘制文本、形状、条形码和图像等元素，编辑好指令，发送给条码打印机，条码打印机就会把 ZPL 所绘制的标签打印出来。

二、ZPL 语法解析

1、标签开始、标签结束

标签开始： ^XA
标签结束： ^XZ

在一张标签中，ZPL 代码总是以 ^XA 开始，以 ^XZ 结尾，形式大概就是 ^XA+标签内容+^XZ；
ZPL 允许在一段代码中绘制多张标签，一堆代码中有几段 ^XA+标签内容+^XZ，就有几张标签；

2、标签原点位置设置

标签原点位置设置： ^LH x, y ，参数为横纵坐标，起始位置为左上角（0,0）位置；

3、标签长度设置

标签长度设置： ^LL length ，参数为需要设置的标签长度；

4、标签文本打印深度设置

标签文本打印深度设置：^MD darknessModifier，参数为标签打印的颜色深度，值越大，颜色越深。范围：0~30；实际使用中根据字体不同，这个指令可能不会生效；

5、标签打印宽度设置

标签打印宽度设置：^PW width，参数为标签打印的宽度；

6、标签方向设置

标签方向设置：^PO orientation，默认参数为N，可选 N 或者 I ，N 默认其实位置为左上角，I 的起始位置为右下角；

7、标签元素定位

标签元素定位：^FO x, y, alignment，参数代表这个元素左上角在标签里的坐标；^FO可以理解为标识这是一个元素（线条、文本、图片等）；

8、标签绘制矩形

标签绘制矩形：^GB width, height, thickness, color, rounding，参数为矩形的长和高、矩形边的宽度，线条的颜色(B或W，默认为黑色B)，圆角；
示例代码：

^XA
^FO50,80^GB70,100,6,B,5^FS
^XZ
1
2
3

标签预览：

9、标签输入字段

字段开始：^FD data
字段结束：^FS，也称之为字段分隔符
要输入一段字段，基本格式：^FD标贴Label^FS，如果不通过 ^FO 定位元素为值，字段的起点会在标签的左上角位置出现；

10、标签设置字段字体、大小

标签设置字段字体、大小：^A font, height, width，参数为字段字体、字段高度、字段宽度；

上图为 ZPL 默认的字体；

11、标签字段设置编码

标签字段设置编码：^CI charset, src1, dest1, src2, dest2, ...，参数为字符集编码，打印中文一般使用 28
示例代码：

^XA
^CI28
^CFJ,30,30
^FO50,50^FD标贴Label^FS
^XZ
1
2
3
4
5

标签预览：

12、标签字段设置字体标识符

标签字段设置字体标识符：^CW fontName, path，fontName 为自定义的字体标识符名称，可以在后续使用；path 为字体文件路径；

关于 ZPL 指令无法显示中文可以参考此篇文章：【Python_Zebra斑马打印机编程学习笔记（三）】解决ZPL指令无法显示中文的问题

13、标签绘制条形码

标签绘制条形码：^BC orientation, height, line, lineAbove, checkDigit, mode

代码示例：

^XA
^FO50,190^BC,80^FD123456^FS
^XZ
1
2
3

标签预览：

14、标签绘制二维码

标签绘制二维码：^BQ orientation, model, magnification, errorCorrection, mask

二维码信息输入采用 ^FD 指令

代码示例：

^XA
^FO50,300^BQN,2,3^FDLA,{"date": "2024.2.26"}^FS
^XZ
1
2
3

标签预览：