如何在macOS平台用Swift将XML内HEX格式灰度BMP数据转为可显示图像

前置说明 #

你已经完成XML解析可以拿到HEX像素串、图像宽高的前提下，以下实现和你之前ActionScript的逻辑完全对齐，同时自带越界校验逻辑。 #

核心实现步骤 #

1. HEX字符串转灰度字节数组 #

先将HEX格式的像素字符串转换为UInt8类型的灰度字节数组，同时自动过滤非法字符、校验格式合法性。

2. 数据越界校验 #

校验输入宽高有效性、灰度字节数是否和宽×高匹配，不匹配直接返回空，避免数组越界。

3. 构造ARGB像素数组 #

和原ActionScript逻辑一致，每个灰度值对应4个字节：255（Alpha通道不透明）+ 灰度值（R通道）+ 灰度值（G通道）+ 灰度值（B通道）。

4. 生成NSImage并更新UI #

通过Core Graphics生成CGImage后转换为NSImage，赋值给NSImageView，同时按需调整占位符的尺寸。 #

完整代码实现 #

工具方法：HEX转字节数组 #

func hexStringToBytes(_ hex: String) -> [UInt8]? {
    // 清洗输入字符串：去除空格、换行、0x前缀
    let cleanedHex = hex
        .replacingOccurrences(of: " ", with: "")
        .replacingOccurrences(of: "\n", with: "")
        .replacingOccurrences(of: "0x", with: "")
    // 校验HEX长度必须为偶数
    guard cleanedHex.count % 2 == 0 else { return nil }
    
    var bytes = [UInt8]()
    var currentIndex = cleanedHex.startIndex
    while currentIndex < cleanedHex.endIndex {
        let nextIndex = cleanedHex.index(currentIndex, offsetBy: 2)
        let byteSubstring = cleanedHex[currentIndex..<nextIndex]
        // 逐位转UInt8，遇到非HEX字符直接返回失败
        guard let byte = UInt8(byteSubstring, radix: 16) else { return nil }
        bytes.append(byte)
        currentIndex = nextIndex
    }
    return bytes
}

核心方法：生成可显示的NSImage #

func generateGrayImage(hexPixelStr: String, width: Int, height: Int) -> NSImage? {
    // 合法性校验，避免越界
    guard width > 0, height > 0 else { return nil }
    let expectedPixelCount = width * height
    guard let grayBytes = hexStringToBytes(hexPixelStr), 
          grayBytes.count == expectedPixelCount else { return nil }
    
    // 构造ARGB格式像素数组
    var argbBuffer = [UInt8]()
    argbBuffer.reserveCapacity(expectedPixelCount * 4)
    for grayValue in grayBytes {
        argbBuffer.append(255) // Alpha通道：完全不透明
        argbBuffer.append(grayValue) // R通道
        argbBuffer.append(grayValue) // G通道
        argbBuffer.append(grayValue) // B通道
    }
    
    // 配置位图参数
    let bitsPerComponent = 8
    let bitsPerPixel = 32
    let bytesPerRow = 4 * width
    let colorSpace = CGColorSpaceCreateDeviceRGB()
    let bitmapInfo = CGBitmapInfo(rawValue: CGImageAlphaInfo.noneSkipFirst.rawValue)
    guard let dataProvider = CGDataProvider(data: Data(argbBuffer) as CFData) else { return nil }
    
    // 生成CGImage
    guard let cgImage = CGImage(
        width: width,
        height: height,
        bitsPerComponent: bitsPerComponent,
        bitsPerPixel: bitsPerPixel,
        bytesPerRow: bytesPerRow,
        space: colorSpace,
        bitmapInfo: bitmapInfo,
        provider: dataProvider,
        decode: nil,
        shouldInterpolate: false, // 不需要插值，适合签名类灰度图
        intent: .defaultIntent
    ) else { return nil }
    
    // 转换为NSImage
    return NSImage(cgImage: cgImage, size: NSSize(width: width, height: height))
}

UI调用示例 #

// 替换为你从XML解析得到的实际数据
let parsedHexStr = "xxxx"
let parsedWidth = 300
let parsedHeight = 150

// 生成图像并赋值
if let targetImage = generateGrayImage(hexPixelStr: parsedHexStr, width: parsedWidth, height: parsedHeight) {
    // 赋值给Storyboard中关联的NSImageView
    yourImageView.image = targetImage
    // 动态调整占位符尺寸（Frame布局写法）
    yourImageView.frame.size = NSSize(width: parsedWidth, height: parsedHeight)
    // 自动布局写法：更新宽高约束的constant
    // imageViewWidthConstraint.constant = CGFloat(parsedWidth)
    // imageViewHeightConstraint.constant = CGFloat(parsedHeight)
}

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