Swift中使用ESC/POS打印光栅图像：替换过时的GS V 0为ESC *命令

核心差异说明 #

GS V 0是一次性发送整幅图像的位图数据，而ESC *是按块发送图像数据（通常按24行像素为一个块，适配多数热敏打印机的打印逻辑），需要把图像切割成符合命令要求的数据块后逐块发送。

实现步骤（基于原Swift代码修改） #

1. 保留图像预处理逻辑：原代码中缩放图像、转单色位图的部分可以直接复用，确保输出黑白位图（每个像素用1位表示，0=白，1=黑）。
2. 重构数据打包逻辑：替换原GS V 0的命令组装代码，改为按ESC *的格式生成命令：
   • ESC *命令格式：\x1B*<m><nL><nH><data>
     • m：取32（对应24点高度的打印模式，适配绝大多数热敏打印机）
     • nL + nH*256：每行图像数据的字节数（图像宽度向上取整到8的倍数，比如宽度100px，计算为13字节）
     • data：每个24行像素块的位图数据，按3行字节组排列（每3字节对应一列的24个像素）

修改后的Swift代码示例 #

extension UIImage {
    func escStarPrintData() -> Data {
        let targetWidth = 384 // 多数热敏打印机的最大打印宽度，可根据实际调整
        guard let resizedImage = resize(to: targetWidth),
              let cgImage = resizedImage.cgImage else { return Data() }
        
        let width = cgImage.width
        let height = cgImage.height
        let bytesPerRow = (width + 7) / 8 // 向上取整到8的倍数，每行字节数
        let totalBlocks = (height + 23) / 24 // 计算24行块的数量
        
        var printData = Data()
        
        for blockIndex in 0..<totalBlocks {
            let startY = blockIndex * 24
            let endY = min(startY + 24, height)
            
            // 准备当前块的图像数据
            var blockData = Data()
            
            for yOffset in 0..<3 { // 24点对应3个8位层
                for x in 0..<width {
                    var byte: UInt8 = 0
                    for bit in 0..<8 {
                        let y = startY + yOffset * 8 + bit
                        guard y < endY else { continue }
                        
                        let pixel = getPixel(x: x, y: y, cgImage: cgImage)
                        if pixel == .black {
                            byte |= 1 << (7 - bit)
                        }
                    }
                    blockData.append(byte)
                }
            }
            
            // 构造ESC *命令
            let m: UInt8 = 32 // 24点打印模式
            let nL = UInt8(bytesPerRow & 0xFF)
            let nH = UInt8((bytesPerRow >> 8) & 0xFF)
            
            printData.append(contentsOf: [0x1B, 0x2A, m, nL, nH])
            printData.append(blockData)
            
            // 块之间添加换行（可选，根据打印机型号调整）
            printData.append(contentsOf: [0x0A])
        }
        
        return printData
    }
    
    // 复用原代码的缩放方法
    private func resize(to width: Int) -> UIImage? {
        let scale = CGFloat(width) / size.width
        let newHeight = size.height * scale
        let newSize = CGSize(width: width, height: newHeight)
        UIGraphicsBeginImageContextWithOptions(newSize, false, 0.0)
        draw(in: CGRect(origin: .zero, size: newSize))
        let resized = UIGraphicsGetImageFromCurrentImageContext()
        UIGraphicsEndImageContext()
        return resized
    }
    
    // 复用原代码的取像素方法
    private func getPixel(x: Int, y: Int, cgImage: CGImage) -> UIColor {
        let pixelData = cgImage.dataProvider?.data
        let data: UnsafePointer<UInt8> = CFDataGetBytePtr(pixelData)
        let bytesPerPixel = cgImage.bitsPerPixel / 8
        let offset = y * cgImage.bytesPerRow + x * bytesPerPixel
        
        let red = data[offset]
        let green = data[offset+1]
        let blue = data[offset+2]
        let alpha = data[offset+3]
        
        let color = UIColor(red: CGFloat(red)/255, green: CGFloat(green)/255, blue: CGFloat(blue)/255, alpha: CGFloat(alpha)/255)
        return color.luminance < 0.5 ? .black : .white
    }
}

extension UIColor {
    var luminance: CGFloat {
        let components = cgColor.components!
        return 0.299 * components[0] + 0.587 * components[1] + 0.114 * components[2]
    }
}

关键注意事项 #

• 打印机宽度适配：targetWidth要根据你的打印机最大打印宽度调整（常见有384px、576px等）
• 打印模式选择：如果需要更高密度，可将m改为33（双密度24点模式），但需确认打印机支持该模式
• 剩余行处理：如果图像高度不是24的倍数，最后一个块的高度不足24，代码会自动处理剩余像素，无需额外逻辑

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