如何用ImageIO将BT.2100 HDR JXL正确色调映射为SDR sRGB JPEG？

我需要在应用中从Apple照片库的16bpc BT.2100 HDR JXL导出8bpc SDR sRGB JPEG，要求将HDR输入色域正确色调映射到适合JPG低位深的SDR（sRGB或P3色域）。Apple色彩管理本身支持该功能——比如在色彩管理正确的macOS SDR显示器上，原JXL图像能正常显示。

因为要支持61MP+的10bpc/16bpc大尺寸图像，我选择内存效率和性能最优的ImageIO（直接通过CGImageSource转CGImageDestination）。之前用Core Image不仅无法生成正确色调映射的图像，还会导致内存占用激增（转换时内存上升500-800MB）且耗时很长。

注意：这里的HDR是真正的高动态范围文件，和那种把多次曝光合并成常规SDR图像的“HDR摄影”不是一回事。

当前实现代码 #

guard let data = sourceImageData,
      let source = CGImageSourceCreateWithData(data as CFData, [kCGImageSourceShouldCache: false, kCGImageSourceTypeIdentifierHint: asset.uniformType.identifier as CFString] as CFDictionary),
      let cfOutputData = CFDataCreateMutable(nil, 0),
      let imageDestination = CGImageDestinationCreateWithData(cfOutputData, outputUTType.identifier as CFString, 1, nil) else {
    break
}

var outputOptions: [AnyHashable: Any] = [kCGImageDestinationMergeMetadata: true,
                               kCGImageDestinationLossyCompressionQuality: options.outputLossyCompressionQuality,
                             kCGImageSourceCreateThumbnailFromImageAlways: true,
                               kCGImageSourceCreateThumbnailWithTransform: true]
if case let .scaled(scale) = options.outputResize {
    outputOptions[kCGImageDestinationImageMaxPixelSize] = Double(max(asset.pixelWidth, asset.pixelHeight)) * scale
} else if case let .aspectResized(maxPixelSize) = options.outputResize {
    outputOptions[kCGImageDestinationImageMaxPixelSize] = maxPixelSize
}
if [.jpeg /* and other 8bpc formats */].contains(options.outputDataFormat) {
    outputOptions[kCGImageSourceDecodeRequest] = kCGImageSourceDecodeToSDR
    outputOptions[kCGImageDestinationPreserveGainMap] = false
    outputOptions[kCGImagePropertyNamedColorSpace] = CGColorSpace.sRGB
} else {
    outputOptions[kCGImageSourceDecodeRequest] = kCGImageSourceDecodeToHDR
    outputOptions[kCGImageSourceDecodeRequestOptions] = [
        "kCGFallbackHDRGain": 10000,
        "kCGTargetColorSpace": CGColorSpace.itur_2100_PQ,
        "kCGTargetHeadroom": 1000000
    ]
}

CGImageDestinationAddImageFromSource(imageDestination, source, 0, outputOptions as CFDictionary)

if CGImageDestinationFinalize(imageDestination) {
    imageData = cfOutputData as Data
}

问题现象 #

我原本以为设置kCGImageSourceDecodeRequest = kCGImageSourceDecodeToSDR就能完成HDR到SDR的色调映射，但实际没生效。

有意思的是，iPhone拍摄的HDR图像不是BT.2100（或其他HDR）色域，而是带gain map元数据层的P3基础图像，我通过kCGImageDestinationPreserveGainMap = false能正确处理这类图像。

错误输出对比 #

• ImageIO输出：生成的JPG仍为BT.2100色域，因位深不足出现色带（Posterization）。
• Core Image输出：已正确设置sRGB色域，但未执行色调映射，颜色显示错误。
• Photos应用输出：用Photos复制JXL图像能生成色调映射正确、渐变平滑的P3色域JPG。

环境说明 #

HDR JXL格式支持macOS 14+、iOS 17+；在macOS 15.0+的Preview（搭配现代MacBook Pro）或Pro Display XDR等HDR显示器上可查看完整动态范围；Sequoia之前的macOS版本中，Preview不支持显示HDR图像，可导入Photos查看。

恳请提供实现需求的建议，感谢。

内容的提问来源于stack exchange，提问作者Léo Natan