ZPL 中的图形——GRF 图像 (^GF)

照片、徽标和渲染后的文本在 ZPL 中通过 ^GF 命令变成单色位图。zplCloud 会自动完成（图片 → GRF、SVG → GRF、HTML/PDF → GRF）。

^GF 的结构

^GFa,b,c,d,data^FS

参数	含义
a	压缩：A = ASCII hex，B = 二进制，C = 压缩 (RLE)
b	图形总字节数（未压缩）
c	每行字节数（未压缩）
d	实际数据的每行字节数（含压缩）
data	像素数据

示例（4×4 黑色方块，ASCII hex）：

^XA
^FO50,50^GFA,8,8,2,FFFFFFFF^FS
^XZ

将图像转换为 GRF

1. 将图像缩放到标签分辨率：widthPx = mm × DPI / 25.4。

2. 转换为单色（阈值或抖动：zplCloud 对照片使用 Floyd–Steinberg）。

3. 打包行：每像素 1 位、MSB 在前，每行补齐到字节边界。

4. 用 C 变体（压缩）编码，使 ZPL 保持小巧——条码通常 1:4，照片 1:2。

提示

• 保持 GRF 小巧：每个点都耗字节。600 dpi 的彩色照片可能撑爆打印机内存——用 203 dpi 或裁切。
• Zebra 打印机将 GRF 图像保存在闪存中（~DYE:LOGO.GRF）——上传一次后按名称引用，而不必每张标签都重发 ^GF。
• zplCloud 的 Zebra 图像 页管理打印机上保存的 GRF 图像。