在开发或集成摄影应用时,支持 Apple ProRAW 需要在捕获、存储和后期编辑的整个流程中进行相应的配置。这涉及到使用 AVFoundation 进行捕获、PhotoKit 进行存储,以及 Core Image 进行编辑。

### 1. 捕获流程:使用 AVFoundation

要捕获 ProRAW 图像,需要配置 `AVCaptureSession` 和 `AVCapturePhotoOutput`。关键步骤包括:

* **设置会话预设:** 将 `session.sessionPreset` 设置为 `.photo` 以确保支持最高质量的照片捕获。
* **配置 PhotoOutput:** 必须在开始会话前,通过设置 `photoOutput.isAppleProRAWEnabled = photoOutput.isAppleProRAWSupported` 来启用 ProRAW 功能。同时,可以设置 `photoOutput.maxPhotoQualityPrioritization` 来控制捕获的质量偏好(如 `.quality` 或 `.balanced`)。
* **准备 PhotoSettings:** 创建 `AVCapturePhotoSettings` 时,需要指定正确的 RAW 像素格式。可以通过 `photoOutput.availableRawPhotoPixelFormatTypes` 筛选出符合 `AVCapturePhotoOutput.isAppleProRAWPixelFormat` 的格式。如果需要同时捕获处理后的照片和 ProRAW,可以在 `AVCapturePhotoSettings` 中提供 `processedFormat`。
* **请求资源:** 可以选择只请求 ProRAW 照片,或者请求包含处理后照片和 ProRAW 的组合。为了提升用户体验,建议请求一个嵌入式的全分辨率 JPEG 预览图,这在很多情况下能提供最佳的平衡。
* **捕获与处理:** 使用 `photoOutput.capturePhoto(with:photoSettings, delegate:delegate)` 进行捕获。当照片处理完成后,`photoOutput(_:didFinishProcessingPhoto:error:)` 委托方法会被调用。在处理完成的 `AVCapturePhoto` 对象中,可以通过 `photo.isRawPhoto` 判断是否为 ProRAW,并使用 `photo.fileDataRepresentation()` 获取 DNG 文件数据,或使用 `photo.pixelBuffer` 获取原始像素数据。
* **自定义压缩:** 若需调整 ProRAW 的压缩设置,可以实现 `AVCapturePhotoFileDataRepresentationCustomizer` 协议,通过 `replacementAppleProRAWCompressionSettings` 方法来控制比特深度和质量,以实现无损或有损压缩。

### 2. 存储流程:使用 PhotoKit

将捕获的 ProRAW 文件保存到照片库时,使用 PhotoKit 框架。这需要对共享的 `PHPhotoLibrary` 执行更改请求 (`PHAssetCreationRequest`),并将捕获到的 ProRAW 文件(例如通过 `fileURL`)作为主要的 `.photo` `PHAssetResource` 添加到创建请求中。

若需要从用户已有的照片库中获取 ProRAW 资源,可以使用 `PHAssetCollection.fetchAssetCollections(with:subtype:options:)` 配合 `.smartAlbumRAW` 子类型来获取包含 RAW 资源的集合。然后,遍历 `PHAssetResource`,查找类型为 `.photo` 或 `.alternatePhoto` 且符合 RAW 图像 UTType 的资源,最后使用 `PHAssetResourceManager` 请求该资源的实际数据。

### 3. 后期编辑与展示流程:使用 Core Image

Core Image 框架用于编辑和展示 ProRAW 图像。获取 ProRAW 的不同方式决定了后续操作的起点:

* **获取预览:** 可以使用 `CGImageSourceCreateThumbnailAtIndex` 或在 iOS 15/macOS 12 中使用 `CIRAWFilter(imageURL:url).previewImage` 来获取预览图。
* **获取完整可编辑数据:** 如果需要最大程度的编辑自由度,应使用 `CIFilter(imageURL:url, options:nil)` 创建一个 `CIFilter` 实例,并获取其 `outputImage`。这个 `CIFilter` 允许修改其输入参数。
* **应用调整:** 通过设置 `CIRAWFilter` 的属性(如 `exposure`、`neutralTemperature`、`sharpnessAmount`、`localToneMapAmount` 等)来应用用户调整。例如,设置 `rawFilter.exposure = -1.0` 可以使图像变暗。
* **获取线性数据:** 要获得全精度的线性场景参考数据,需要将 `CIRAWFilter` 的默认外观相关的输入(如 `baselineExposure`, `shadowBias`, `boostAmount`, `localToneMapAmount`)设置为 0,并禁用色域映射 (`isGamutMappingEnabled = false`)。得到的 `linearRawImage` 包含完整的 14 档动态范围数据,可用于科学计算。
* **渲染输出:** 调整后的图像可以渲染到不同格式。例如,保存为 8-bit HEIC 使用 `ciContext.writeHEIFRepresentation`,或使用 `ciContext.writeHEIF10Representation` 保存为 10-bit HEIC。对于展示,若目标是扩展动态范围(EDR)显示,推荐使用 MetalKit View,并设置 `rawFilter.extendedDynamicRangeAmount = 1.0` 来渲染出全动态范围的图像。

总结来说,开发流程是:**AVFoundation 捕获** $
ightarrow$ **PhotoKit 存储** $
ightarrow$ **Core Image 编辑/展示**,每一步都需要针对 ProRAW 的特性进行特定的 API 调用和配置。

信息来源