斑马GC420t打印机EPL GW命令：Bitmap转字节数组打印异常

问题背景 #

开发Android Java应用，使用斑马GC420t打印机USB打印，基础EPL命令正常，但通过GW命令发送Bitmap转换的二进制数据时，图片位置要么空白，要么打印随机乱线。Bitmap本身显示正常，尝试更换编码为windows-1252、Base64转换均无效。

核心问题分析 #

问题出在二进制图像数据被字符串编码破坏。你的代码中将图像二进制数据转成String后拼接，再转成字节发送给打印机，但字符串编码（如windows-1252、ASCII）无法正确表示所有二进制字节（比如0x00、0x80以上的非可打印字符），转码过程中会丢失或篡改数据，导致打印机无法解析图像。

此外还有两个次要问题：

• downloadAndRotateImage中用自旋等待线程结束，效率极低且可能触发ANR；
• 需确认EPL GW命令的位定义：GW命令中，字节位为0时打印黑点，1时不打印，你的二值化逻辑是正确的，但需确保与打印机设置一致。

修复代码 #

1. 修改命令拼接逻辑，用字节流处理二进制数据 #

避免将二进制图像数据转为String，直接用ByteArrayOutputStream拼接所有EPL命令：

private byte[] processEPLCommands(String[] eplCommands) throws IOException {
    ByteArrayOutputStream allCommands = new ByteArrayOutputStream();
    String lineSeparator = "\n"; // EPL命令通常以换行结尾，部分打印机支持\r\n
    for (String command : eplCommands) {
        if (command.startsWith("[IMG]")) {
            String[] parts = command.split(";");
            if (parts.length == 5) {
                int x = Integer.valueOf(parts[1]);
                int y = Integer.valueOf(parts[2]);
                String imageUrl = parts[4];
                int rotation = Integer.parseInt(parts[3]);
                Bitmap bitmap = downloadAndRotateImage(imageUrl, rotation);
                if (bitmap != null) {
                    // 直接写入图像的二进制EPL命令
                    byte[] imageBytes = getImageEplBytes(x, y, bitmap);
                    allCommands.write(imageBytes);
                    allCommands.write(lineSeparator.getBytes("US-ASCII"));
                }
            }
        } else {
            // 普通EPL命令转ASCII字节写入
            allCommands.write(command.getBytes("US-ASCII"));
            allCommands.write(lineSeparator.getBytes("US-ASCII"));
        }
    }
    // 添加打印触发命令（打印1张）
    allCommands.write("P1\n".getBytes("US-ASCII"));
    return allCommands.toByteArray();
}

2. 重构图像转EPL逻辑，返回字节数组 #

不再将图像数据转为String，直接生成二进制EPL命令：

public static byte[] getImageEplBytes(int top, int left, Bitmap bitmap) throws IOException {
    ByteArrayOutputStream baos = new ByteArrayOutputStream();
    int byteWidth = (int) Math.ceil((double) bitmap.getWidth() / 8);
    // GW命令头：GWx,y,字节宽度,高度,
    String header = String.format("GW%d,%d,%d,%d,", top, left, byteWidth, bitmap.getHeight());
    baos.write(header.getBytes("US-ASCII"));

    int paddedWidth = byteWidth * 8;
    for (int y = 0; y < bitmap.getHeight(); y++) {
        for (int x = 0; x < paddedWidth;) {
            byte currentByte = 0;
            for (int bitPos = 0; bitPos < 8; bitPos++, x++) {
                int dot = 1; // 1代表不打印（白色）
                if (x < bitmap.getWidth()) {
                    int color = bitmap.getPixel(x, y);
                    // 计算亮度转二值：亮度>127为亮（不打印），否则为暗（打印）
                    int luminance = (int) ((Color.red(color) * 0.3) + (Color.green(color) * 0.59) + (Color.blue(color) * 0.11));
                    dot = luminance > 127 ? 1 : 0;
                }
                // EPL中字节最高位对应最左侧的点，所以左移(7 - bitPos)位
                currentByte |= (byte) (dot << (7 - bitPos));
            }
            baos.write(currentByte);
        }
    }
    return baos.toByteArray();
}

3. 优化图像下载旋转的等待逻辑 #

用Future替代自旋等待，避免CPU浪费：

private Bitmap downloadAndRotateImage(String imageUrl, int rotation) {
    ExecutorService executor = Executors.newSingleThreadExecutor();
    Future<Bitmap> future = executor.submit(() -> {
        try {
            Bitmap bitmap = BitmapFactory.decodeStream(new URL(imageUrl).openStream());
            if (bitmap == null) return null;
            return rotateBitmap(bitmap, rotation);
        } catch (IOException e) {
            Log.e("printer", "Failed to download or process image", e);
            return null;
        }
    });
    try {
        // 设置10秒超时，避免无限等待
        return future.get(10, TimeUnit.SECONDS);
    } catch (InterruptedException | ExecutionException | TimeoutException e) {
        Log.e("printer", "Image download failed or timed out", e);
        return null;
    } finally {
        executor.shutdown();
    }
}

private Bitmap rotateBitmap(Bitmap bitmap, int rotation) {
    Matrix matrix = new Matrix();
    matrix.postRotate(rotation);
    return Bitmap.createBitmap(bitmap, 0, 0, bitmap.getWidth(), bitmap.getHeight(), matrix, true);
}

注意事项 #

• 发送打印机时，直接将processEPLCommands返回的byte[]通过USB输出流发送，绝对不要转成String；
• GC420t是203DPI，坐标单位为点，计算打印位置时需匹配实际需求；
• 建议将Bitmap转为灰度模式（如Bitmap.Config.ALPHA_8）后再处理，减少计算量；
• 测试时优先使用小尺寸图片，便于快速排查问题。

内容的提问来源于stack exchange，提问作者Luis Beltrão