页面模式下使用ESC命令打印图像异常：GS v 0命令无法打印

我在页面模式下使用GS v 0命令无法打印图像，尝试过ESC *命令，但打印出的图像每8位段之间存在空白。以下是我的代码：

private static string ConvertBitmapToCommandsForMode1(Bitmap bitmap, byte[] image = null)
{
    List<byte> commands = new List<byte>();

    var e = new ESCPOS_NET.Emitters.EPSON();

    // 1. 选择页面模式
    commands.Add(0x1B); // ESC 十六进制
    commands.Add(0x4C); // L 十六进制

    // 2. 修改水平和垂直移动单位为标准点单位
    commands.Add(0x1D); // GS 十六进制
    commands.Add(0x50); // P 十六进制
    commands.Add(0xB4); // 十进制180的十六进制
    commands.Add(0xB4); // 十进制180的十六进制
    // 打印机每移动1英寸，水平和垂直方向都会移动180个点

    // 3. 设置打印方向
    commands.Add(0x1B); // ESC
    commands.Add(0x54); // T
    commands.Add(0x00);
    // 打印方向：0x00为从左到右，0x01为从下到上，0x02为从右到左，0x03为从上到下

    // 4. 选择边缘数据的打印区域
    commands.Add(0x1B); // ESC
    commands.Add(0x57); // W
    commands.AddRange(new byte[] {
        0x14, 0x00, // 0 (xL, xH)
        0x64, 0x00, // 0 (yL, yH)
        0x64, 0x00, // 100 (dxL, dxH)
        0x64, 0x00  // 100 (dyL, dyH)
    });
    // 注释说明：
    // 0x90 0x01：这两个字节定义打印区域左上角的X坐标，低字节在前，高字节在后，组合为0x0190即十进制400
    // 0x76 0x00：定义打印区域左上角的Y坐标，组合为0x0076即十进制118
    // 0x68 0x01：打印区域宽度（点数），组合为0x0168即十进制360
    // 0x10 0x02：打印区域高度（点数），组合为0x0210即十进制528

    commands.Add(0x0A); // 换行
    commands.AddRange(Encoding.ASCII.GetBytes("123eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"));
    commands.Add(0x0A); // 换行
    commands.Add(0x0A); // 换行

    // 5. 再次选择边缘数据的打印区域
    commands.Add(0x1B); // ESC
    commands.Add(0x57); // W
    commands.AddRange(new byte[] {
        0x64, 0x00, // 100 (xL, xH)
        0x00, 0x00, // 0 (yL, yH)
        0xF4, 0x01, // 500  (dxL, dxH)
        0xC8, 0x01  // 200  (dyL, dyH)
    });
    
    // 6. 打印图像
    commands.AddRange(e.PrintImage(image, true, true, 300));

    // 7. 打印所有数据并切纸
    // 打印所有内容
    commands.Add(0x1B);
    commands.Add(0x0C);

    // 8. 选择切纸模式并切纸
    commands.Add(0x1D); // GS 十六进制
    commands.Add(0x56); // V 十六进制
    commands.Add(0x42); // 十进制66的十六进制
    commands.Add(0x50); // 十进制80的十六进制

    commands.Add(0x1B); // ESC 十六进制
    commands.Add(0x53); // S 十六进制

    return BitConverter.ToString(commands.ToArray()).Replace("-", "");
}

打印结果仅输出了代码中添加的文本内容，图像未被打印。

问题分析与解决方案 #

1. 核心问题 #

常规的GS v 0/ESC *图像命令是为标准打印模式设计的，页面模式下无法直接调用，必须用页面模式专用的缓冲区写入命令。

2. 具体修复步骤 #

（1）替换图像打印逻辑，改用页面模式位图命令

删掉e.PrintImage调用，使用ESC \命令将图像数据写入页面缓冲区的指定坐标：

// 替换原打印图像代码
if (image != null)
{
    // 设置图像左上角坐标（对应你之前的打印区域起始点：X=100，Y=0）
    byte xL = (byte)(100 & 0xFF);
    byte xH = (byte)((100 >> 8) & 0xFF);
    byte yL = (byte)(0 & 0xFF);
    byte yH = (byte)((0 >> 8) & 0xFF);

    // ESC \ 命令：向页面模式缓冲区写入位图
    commands.Add(0x1B);
    commands.Add(0x5C);
    commands.Add(xL);
    commands.Add(xH);
    commands.Add(yL);
    commands.Add(yH);
    commands.AddRange(image); // 传入预处理后的单色位图数据
}

（2）修正打印区域设置

页面模式只需设置一次全局打印区域，移除第二次ESC W调用，调整为覆盖可打印范围的区域：

// 仅保留一次全局打印区域设置
commands.Add(0x1B);
commands.Add(0x57);
commands.AddRange(new byte[] {
    0x00, 0x00, // X起始0
    0x00, 0x00, // Y起始0
    0x00, 0x02, // 宽度512（根据打印机实际可打印宽度调整）
    0x00, 0x02  // 高度512（按需调整）
});

（3）预处理图像数据

确保图像是按行存储的单色位图：每个字节代表8个像素（1为黑，0为白），彩色图像需先转灰度再二值化，宽度不足8的倍数时补空白字节对齐。

3. 解决ESC *的空白问题 #

ESC *的空白是因为8位字节分割导致的错位，页面模式下需：

• 确保图像宽度是8的倍数，不足补0
• 每行打印前用ESC $命令精确定位起始坐标，避免偏移

内容的提问来源于stack exchange，提问作者Yurii Chernii