C# Zebra打印机十六进制压缩算法对应解压实现咨询

ZPL十六进制专用压缩方案解压实现 #

实现思路 #

该压缩是ZPL协议为~DG、~DB命令设计的十六进制游程编码变种，解压核心是将压缩控制字符映射为重复次数，还原原始十六进制串，具体步骤如下：

• 首先明确字符映射规则：
  • 重复1次：直接保留原始十六进制字符（0-9、A-F）
  • 重复2-19次：用大写字符G-Y对应，G代表重复2次，每向后一个字符次数+1，Y对应重复19次
  • 重复20-639次：用小写字符g-z对应基础偏移，g对应基础值20，每向后一个字符偏移+1，z对应基础值39；偏移后紧跟1位十六进制字符（0-F对应0-15），总重复次数=基础偏移*16 + 后位十六进制字符对应的十进制值
• 遍历解压逻辑：
  1. 逐个读取压缩串字符，如果是十六进制字符，直接追加到结果串，记录该字符为当前基准字符
  2. 如果是大写G-Y区间的字符，计算对应重复次数，向结果串追加对应次数减1的基准字符（之前已经追加过1次）
  3. 如果是小写g-z区间的字符，先计算基础偏移，再读取后一位十六进制字符算出总重复次数，追加对应次数减1的基准字符，跳过已经读取的后一位字符
• 校验：解压完成后得到的十六进制串总长度，应该等于~DG/~DB命令中声明的总字节数*2，可用于校验解压正确性

C# 代码实现（对应原压缩方案的反向逻辑） #

using System;
using System.Text;

public static class ZplHexCompression
{
    public static string Decompress(string compressedHex)
    {
        if (string.IsNullOrEmpty(compressedHex))
            return string.Empty;

        StringBuilder decompressed = new StringBuilder();
        int index = 0;
        char currentBaseHex = '\0';

        while (index < compressedHex.Length)
        {
            char c = compressedHex[index];

            // 匹配十六进制字符，对应1次重复
            if (char.IsAsciiHexDigitUpper(c))
            {
                currentBaseHex = c;
                decompressed.Append(c);
                index++;
            }
            // 匹配大写G-Y，对应2-19次重复
            else if (c is >= 'G' and <= 'Y')
            {
                int repeat = (c - 'G') + 2;
                decompressed.Append(currentBaseHex, repeat - 1);
                index++;
            }
            // 匹配小写g-z，对应20+次重复
            else if (c is >= 'g' and <= 'z')
            {
                if (index + 1 >= compressedHex.Length)
                    throw new ArgumentException("压缩串格式异常，缺少次数位", nameof(compressedHex));

                int baseOffset = (c - 'g') + 20;
                char countHexChar = compressedHex[index + 1];
                int countMulti = int.Parse(countHexChar.ToString(), System.Globalization.NumberStyles.HexNumber);
                int totalRepeat = baseOffset * 16 + countMulti;

                decompressed.Append(currentBaseHex, totalRepeat - 1);
                index += 2;
            }
            else
            {
                throw new NotSupportedException($"不支持的压缩字符: {c}");
            }
        }

        return decompressed.ToString();
    }
}

提示：如果是从完整ZPL指令中提取压缩数据，需要先过滤掉指令前缀、文件名、字节数参数等无关内容，仅保留纯压缩字符段传入解压方法。

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