ZPL 指南

ZPL 命令

139 篇指南属于此类别。

^A · 可缩放/位图字体为当前文本字段选择字体。字体 0 是可缩放的默认字体 CG Triumvirate Bold Condensed，A–H 和 GS 是内置位图字体；其他名称可通过 ^CW 映射到已下载的字体文件。
^A@ · 按文件名加载字体按文件名加载打印机中的字体（如 TrueType）。
^A0 · 标准内置字体（字体 0）打印机内置的可缩放默认字体（CG Triumvirate Bold Condensed，所有 Zebra ZPL 打印机均内置）。是简单文本的可靠默认选择。
^B0 · Aztec 码生成 Aztec 码（2D 矩阵码）。纠错级别和符号尺寸共同由参数 d 控制。
^B1 · Code 11 条码生成 Code 11 条码（数字 0–9 和连字符，主要用于电信）。
^B2 · Interleaved 2 of 5 条码生成 Interleaved 2 of 5 码（成对数字；只允许偶数位数字）。
^B3 · Code 39 条码生成 Code 39 条码（字母数字；起始/结束星号自动添加）。
^B4 · Code 49 条码生成 Code 49 条码（多层堆叠码）。
^B5 · PLANET 码生成 PLANET 码（美国邮政编码；长/短条）。
^B7 · PDF417 条码生成 PDF417 码（用于大数据量的多层堆叠 2D 码）。
^B8 · EAN-8 条码生成 EAN-8 条码（8 位数字；适合小商品的经济型 EAN 变体）。
^B9 · UPC-E 条码生成 UPC-E 条码（紧凑的消零 UPC 变体；打印机计算校验位）。
^BA · Code 93 条码生成 Code 93 条码（字母数字，比 Code 39 更密集）。
^BB · Codablock 码生成 Codablock 码（堆叠码；模式 A 使用 Code 39 字符集，E 和 F 使用 Code 128 字符集）。
^BC · Code 128 条码生成 Code 128 条码，支持子集 A（数字/大写）、B（完整 ASCII）和 C（数字对，双倍密度）。
^BD · UPS MaxiCode 生成 UPS MaxiCode（用于 UPS 包裹标签的六边形 2D 码）。
^BE · EAN-13 条码生成 EAN-13 条码（13 位数字；消费品标准）。
^BF · MicroPDF417 码生成 MicroPDF417 码（用于有限数据量的 PDF417 紧凑变体）。
^BI · Industrial 2 of 5 条码生成 Industrial 2 of 5 码（仅数字；经典的仓储/物流格式）。
^BJ · Standard 2 of 5 条码生成 Standard 2 of 5 码（仅数字；较旧且少见的格式）。
^BK · ANSI Codabar 生成 Codabar 码（数字加起始/结束符 A–D；主要用于图书馆、血库、货运）。
^BL · LOGMARS 码生成 LOGMARS 码（用于美国国防/物流的 Code 39 变体；始终添加 Mod-43 校验位）。
^BM · MSI 码生成 MSI 码（也称 MSI Plessey；仅数字，主要用于库存管理）。
^BO · Aztec 码参数 Aztec 命令的替代变体，参数与 ^B0 相同。
^BP · Plessey 码生成 Plessey 码（仅数字；历史悠久的英国格式）。
^BQ · QR 码生成 QR 码。纠错级别和输入模式还需作为前缀写在 ^FD 中（如 MA, ）。
^BR · GS1-DataBar 生成 GS1-DataBar 码（原 RSS；紧凑的 GS1 符号体系，如用于散装商品）。
^BS · EAN/UPC 附加码 (AddOn) 为 EAN/UPC 码生成 2 位或 5 位附加码（AddOn）（如用于杂志），作为主条码旁边的独立字段。
^BT · TLC39 码生成 TLC39 码（TCIF Linked Code 39），用于电信行业：由包含 ECI 编号的 Code 39 组成，可选择链接一个用于序列号和附加数据的 MicroPDF417。
^BU · UPC-A 条码生成 UPC-A 条码（12 位数字；北美商业格式）。
^BX · Data Matrix 码生成 Data Matrix 码（2D 矩阵码，非常稳健且节省空间）。新应用请使用质量级别 200 ECC 200 。
^BY · 条码默认值（模块宽度）为后续条码设置默认值：模块宽度、宽窄比和条码高度。
^BZ · POSTNET 邮政编码生成 POSTNET 邮政编码 USPS；用于邮编的长/短条。
^CC · 更改脱字符号更改在格式中引入命令的脱字符号（默认 ^ ）。
^CD · 更改分隔符更改命令各参数之间的分隔符（默认逗号）。
^CF · 更改标准字体为所有后续未指定自己 ^A 的文本字段设置标准字体。
^CI · 选择字符集/编码为后续文本选择国际字符集（代码页）；还可以选择对单个字符代码进行重映射。
^CN · 立即裁切 (Cut Now) 在带切刀的自助终端 kiosk 打印机上立即触发裁切。要在带切刀的标签打印机上每个标签后都裁切，请使用打印模式 ^MMC。
^CO · 启用缓存为可缩放字体启用字符缓存：已渲染过的字符会被缓存，下次打印更快。
^CP · 移除标签控制带出纸器 presenter 的自助终端打印机如何处理已呈现的单据。
^CT · 更改波浪号更改控制命令的前缀（默认 ~ ，如 ~JA 或 ~HS 中的前缀）。
~CT · 更改波浪号（主机端）主机端更改波浪号的变体（格式内用 ^CT）。
^CW · 分配字体标识符为标识符（A–Z, 0–9）分配一个字体文件，之后用 ^A 调用。使用已被占用的字母会替换对应的内置字体。
~DB · 下载位图字体将位图字体加载到打印机。包含字体度量信息的头部之后是字符数据。
^DF · 保存格式将当前格式保存到打印机内存，之后可用 ^XF 调用。
~DG · 下载图形将图形（徽标/图像）加载到打印机内存；之后用 ^XG 调用。
~DU · 下载无界 TrueType 字体将字符数超过 256 个的 TrueType 字体（无界字体，如亚洲字体）以 Zebra 下载格式加载到打印机。
~DY · 下载对象将图形（PNG、GRF）、TrueType/OpenType 字体或位图等文件加载到打印机内存。
^EF · 删除所有已保存的格式从打印机内存中删除所有已保存的格式。
^EG · 删除所有已下载的图形从打印机内存中删除所有已下载的图形（与 ~EG 相同）。
^FB · 文本块（换行）定义固定宽度、行数和对齐方式的文本块：文本自动换行。
^FC · 在字段中插入时间/日期设置指示字符，用于将实时时钟的日期和时间插入后续 ^FD（如 %d 表示日）。
^FD · 字段数据定义字段的数据（文本、条码内容或图形数据）。以 ^FS 结束。
^FE · 字段拼接将多个 ^FD 内容拼接成一个字段（如组合单个序列号）。
^FH · 十六进制字段数据标记后续 ^FD 中的十六进制值以“十六进制指示符 + 两位十六进制数”编码，默认写作 _HH （如 _5F = 下划线），用于特殊字符。指示符可通过参数 a 更改。
^FL · 字体链接将基础字体与扩展字体链接：基础字体中缺失的字符从链接的字体打印。
^FM · 多个字段位置为 PDF417 ^B7 或 MicroPDF417 ^BF 条码的各个符号设置多个位置，这类条码的数据通过 Structured Append 拆分到多个符号中。
^FN · 字段编号为用 ^DF 存储的格式中的可变字段编号。用 ^XF 调用格式时，通过相同编号为该字段填充数据。
^FO · 字段原点（位置）为后续字段设置位置 X/Y，dots 。无 ^FO 时字段位于 0,0。
^FP · 字段参数为当前文本字段设置书写方向和额外字符间距，例如用于竖向堆叠的字母或加宽字距的文本。
^FR · 字段反转打印使字段相对于背景反转：在黑色区域上打印为白色，在白色区域上打印为黑色。
^FS · 字段结束结束当前字段（文本、条码、图形）。每个字段都需要一个 ^FS。
^FT · 按基线定位字段通过基线而非左上角定位字段；适合精确文本对齐。
^FV · 字段变量与 ^FD 类似，但将数据标记为可变：配合 ^MCN 时，标签图像的其余部分会保留用于下一个标签，而 ^FV 字段在每次打印后清除。
^FW · 字段默认方向为之后所有带方向参数的字段命令设置默认旋转方向（固件 x.14 起还可设置默认对齐方式）。字段中显式指定的值（如 ^A0N ）优先。
^FX · 注释在 ZPL 代码中插入不会被打印的注释；用于可维护性和调试。
^GB · 矩形/边框绘制带定义线宽的矩形（填充或边框）。
^GC · 圆形绘制具有定义直径和线宽的圆。
^GD · 斜线在给定的宽度/高度内绘制对角线。
^GE · 椭圆绘制具有定义宽、高和线宽的椭圆。
^GF · 图形数据（位图）直接根据字段数据打印位图（徽标、图像）。这是 zplCloud 为徽标生成的 ^GFA 图形的基础。
^GF 配合 :Z64 · 压缩图形数据采用 Z64 编码的 ^GF：位图经 zlib deflate 压缩、Base64 编码后连同校验和一起发送。ZPL 中不存在 ^GZ 命令。
~HB · 电池状态请求电池状态（仅限带电池的打印机，如 ZQ 系列）。
~HD · 打印头诊断将诊断数据发送给主机，如打印头温度和环境温度、浓度设置和速度。
~HI · 主机识别请求打印机标识：型号、固件版本、分辨率（每 mm 点数）、内存大小和检测到的选件。
~HM · 内存状态请求打印机的 RAM 状态：总内存、最大可用内存和当前空闲内存（KB）。
~HQ · 主机查询向打印机查询特定信息并将其发送回主机。
~HS · 打印机状态请求当前打印机状态（包括缺纸、暂停、打印头打开、色带、缓冲区使用情况）。
^ID · 删除对象从打印机内存中删除图形、格式或字体等对象。
^IL · 加载图像将用 ^IS 保存的标签图像 .GRF 作为背景从位置 0,0 加载到当前格式中；其他字段叠加在其上。
^IM · 移动图像在 ^FO 设定的位置打印已保存的图像（.GRF 或 .PNG）：类似 ^XG，但不能放大。
^IS · 保存图像将目前已构建的标签作为图形 .GRF 保存到打印机内存，而不是保存为 ZPL 格式。通常放在格式末尾。
~JA · 取消所有作业取消所有等待中的打印作业。
~JB · 重置附加内存初始化可选内存（如驱动器 B: 上的存储卡）；其上保存的所有对象都会被删除。
~JC · 传感器校准根据装入的材料自动校准介质/标签传感器。
~JG · 传感器值图形以图形方式输出传感器校准结果，用于直观检查介质变化。
~JL · 设置标签长度重新测量标签长度：打印机为此会送出一张或多张标签。
^JM · 每毫米点数需要时将格式的分辨率（每毫米点数）减半，使所有以 dots 计的尺寸按两倍大小打印。
~JP · 暂停并取消作业暂停打印机并取消当前格式。
~JR · 重启（上电复位）重启打印机（如同关机再开机）。
~JS · 回退顺序设置标签被送到撕纸边后何时拉回（回退 backfeed ）。
^JU · 保存/加载配置永久保存当前设置，或加载已保存的设置或出厂设置。
^JW · 色带张力设置热转印中色带 ribbon 的张力（PAX 系列打印引擎）。
^JZ · 出错后重印设置因错误（如介质或色带用尽、打印头打开）而未完整打印的标签在错误排除后是否重新打印。
^KD · 日期/时间格式选择控制面板和配置标签上日期和时间的显示格式（实时时钟）。
^KL · 显示语言选择打印机控制面板（显示屏）显示菜单和消息所用的语言。它不会切换命令语言（ZPL、EPL、CPCL）。
^LH · 标签原点（基准位置）为所有后续字段设置原点 0,0 ；便于整体移动布局。
^LL · 标签长度以 dots 定义标签的长度（高度）。
^LR · 反转标签对格式中所有后续字段应用反色打印（同 ^FR）：它们在黑色区域上打印为白色，在白色区域上打印为黑色。
^LS · 标签偏移水平移动所有字段的位置（以 dots 计）：正值向左。
^LT · 标签顶部边缘将整个标签格式相对于上边缘垂直移动（以点行计）。
^MC · 清除标签图像 (Map Clear) 设置打印后是清除标签图像，还是将其保留给下一张标签。
^MD · 打印浓度 (heat) 相对于打印机上设置的浓度调整打印浓度：用于更深/更浅的打印。
^MM · 打印模式决定打印机在打印后如何处理标签：撕纸、剥离、回卷、裁切或交给贴标机。
^MN · 介质跟踪选择介质检测方式：连续介质、间隙/凹口或黑标。
^MT · 介质类型选择介质类型：热转印或热敏直印。
^MU · 度量单位为格式中之后的所有数值设置度量单位（dots、英寸或毫米），并可将为某一分辨率设计的格式换算到另一分辨率。
^PA · 扩展文本属性为 TrueType/OpenType 字体启用高级文本功能：默认字形、双向排版（如阿拉伯语、希伯来语）、字符整形和 OpenType 支持。
^PF · 空转送纸 (slew) 在标签底部将介质按指定点行数快速空转送纸，不进行打印。
~PL · 附加呈现长度定义在呈现模式下标签向前推送的附加长度。
^PM · 镜像将整张标签镜像打印（左右翻转），例如用于从背面阅读的薄膜。
^PN · 呈现标签将打印好的标签向前推出，便于取走。
^PO · 打印方向以正常方向或旋转 180° 打印整个标签。
^PP · 可编程暂停在当前格式（包括所有副本）打印完毕后使打印机进入暂停模式（~PP 则在正在打印的标签之后立即暂停）。
^PQ · 打印数量指定要打印的标签数量，以及可选的暂停/切纸和序列化标签的重复份数。
^PR · 打印速度以英寸/秒 ips 设置打印速度、空转送纸速度和回退速度。
~PR · 应用重印重新打印最后一张标签：用于用户和自动化应用。
~PS · 恢复打印 (Print Start) 使处于暂停状态的打印机继续工作：如同按下 PAUSE 键。
^PW · 打印宽度以 dots 定义标签的打印宽度。默认是整个打印头宽度。
^RF · RFID 格式（读/写）读取或写入 RFID 标签上的数据。
^RQ · 快速写入 EPC + 密码将 EPC 数据和/或访问密码写入 RFID 标签（无需先 ^RF）。
~SD · 设置浓度设置打印机的绝对打印浓度；^MD 随后在此值基础上进行相对调整。
^SF · 序列化字段将 ^FD 字段变为计数器：从 ^PQ 作业的第二张标签起，内容按掩码和增量递增。
^SN · 序列化数据代替 ^FD 生成序列号，在 ^PQ 作业的每张标签上按增量递增或递减。
^SP · 开始打印让打印机在其余字段仍在格式化时，先开始打印标签上半部分（直到指定的点行）。这可以提高非常复杂标签的吞吐量。
~TA · 撕纸位置设置打印后标签定位到撕纸边的位置。
^TB · 文本块创建固定宽度和高度的文本块：文本自动换行，溢出时被裁切。
^TO · 传输对象将已保存的对象（图形、格式、字体）从一个存储区复制到另一个存储区，如从 RAM 复制到闪存。
~WC · 配置标签打印一张包含打印机所有当前设置的配置标签。
^WF · 编码 AFI/DSFID 字节写入 RFID 标签时编码 AFI 或 DSFID 字节。
~WQ · 查询打印机信息 (Write Query) 向打印机请求信息并返回给主机，例如里程计读数、维护提醒、错误状态、序列号或 MAC 地址。
^WT · 写标签在当前格式中写入 RFID 标签（根据参数读写）。
^XA · 开始格式开始一个 ZPL 格式。每个标签以 ^XA 开始并以 ^XZ 结束。
^XB · 抑制回退不将标签送到撕纸或切纸位置，因此在下一张标签之前无需回退。
^XF · 调用已保存格式从内存中调用已保存格式，并用数据填充编号字段 ^FN 。
^XG · 调用已保存图形调用已保存图形并按 X/Y 系数缩放。
^XZ · 结束格式结束 ZPL 格式并打印标签。
^ZZ · 打印机休眠模式在空闲一段时间后关闭打印机或使其进入休眠（主要用于使用电池的移动打印机）。

所有类别