如何为 ZPL 标签添加徽标或图片（^GF）

ZPLCraft · 更新于 2026年9月30日

热敏打印机只能打印黑点，因此徽标或图片必须先变成黑白位图，才能放到标签上。在 ZPL 中，这个位图以图形字段的形式包含在标签里：即 ^GF 指令，后面跟着图像数据。

本指南解释 ^GF 的工作原理、如何在 ZPLCraft 设计器中添加徽标、为什么阈值和抖动会产生截然不同的效果，以及如何把整个 PDF 或图像转换为 ZPL。

ZPL 如何存储图像：^GF

^GF 在数据之前有四个参数：压缩类型（A 表示 ASCII 十六进制，B 表示二进制，C 表示压缩二进制）、数据字节数、图形的总字节数，以及每行的字节数。每个字节存放八个点，因此 200 点宽的徽标每行需要 25 个字节。

^GFa,b,c,d,data

^XA
^FO40,40^GFA,24,24,3,FFFFFF8000018FFFF18FFFF18FFFF18FFFF1800001FFFFFF^FS
^XZ

由于每个点都要存储，图像会让 ZPL 文件比文字和条码大得多。压缩数据（包括某些系统生成的 Z64 格式）可以让文件更小。如果同一个徽标要打印成千上万次，可以用 ~DG 把它一次性存入打印机内存，并在每张标签中用 ^XG 调用，这样每张标签只需传输一条很短的指令。

~DGR:LOGO.GRF,6000,25,<data>
^XA
^FO40,40^XGR:LOGO.GRF,1,1^FS
^XZ

在设计器中添加徽标

在“添加元素”面板中选择“图片”，然后选择 PNG、JPEG 或 WebP 图像。设计器会把它转换成打印机位图并放到画布上，您可以像处理其他元素一样移动和调整大小。导出时它会成为已编码好的 ^GF 字段。

“编辑图像”会打开转换设置：裁剪、旋转、对比度、黑白阈值、反转颜色、移除近白色背景、以像素为单位的输出尺寸和重采样方式。只有在应用后，更改才会作用到标签上，因此可以放心尝试。

阈值还是抖动？

把彩色的深浅转换成黑白点有两种方式，选错方式是徽标打印效果不佳的最常见原因。

• 阈值处理会把比某个分界值更暗的像素全部变成黑色，其余全部变成白色。它能让扁平徽标、文字和线稿的边缘清晰，但渐变和照片会塌成大片实心区域，如下方蓝色渐变圆形的示例所示。
• 抖动会把黑点按图案散布，使灰色调呈现为较浅或较深的区域。它适合照片和渐变，但会让边缘变得粗糙，因此切勿用于条码或小字。

为获得最佳效果，请从已经是黑白的徽标开始，或调整对比度和阈值级别，直到重要的形状得以保留。

设置正确的尺寸

图像像素与打印机点是一一对应的，因此实际物理尺寸取决于打印机分辨率。一个 25 mm 宽的徽标，在 203 dpi 下需要约 200 点，在 300 dpi 下需要约 300 点。请从至少这么大的图像开始：放大小图像会让边缘出现马赛克，而缩小大图像则没有问题。

把整个 PDF 或图像转换为 ZPL

有时整张标签就是一份图稿，例如以 PDF 形式提供的承运商标签。“PDF 和图像转 ZPL”转换器会把每个选中的页面或图像转换成标签大小的 ^GF 图形。设置标签尺寸和打印机分辨率，选择“适应标签大小”或“实际大小，居中”，条码和文字选阈值，照片选抖动。

转换后的标签是图像，因此其中的文字和条码无法再编辑。如果需要可编辑的字段，请在设计器中重新制作标签，只把徽标作为图片添加。

打开“PDF 和图像转 ZPL”转换器

ZPL 图像常见问题