Core Image：iOS图像处理技术追踪

let filepath: String? = Bundle.main.path(forResource: “test_video”, ofType: “MOV”)

let fileURL = URL.init(fileURLWithPath: filepath!)

let asset = AVAsset(url: fileURL)

let item = AVPlayerItem(asset: asset)

item.videoComposition = AVMutableVideoComposition(asset: asset) { request in

let filter = CIFilter(name: “CIVortexDistortion”)

filter?.setValue(request.sourceImage, forKey: kCIInputImageKey)

filter?.setValue(NSNumber(400), forKey: “inputAngle”)

filter?.setValue(NSNumber(1200), forKey: “inputRadius”)

filter?.setValue(CIVector(x: 700, y: 400), forKey: “inputCenter”)

let out = filter?.outputImage

request.finish(with: out ?? request.sourceImage, context: nil)

}

avPlayer = AVPlayer(playerItem: item)

测试核心代码

原视频（笔者本人取材）

添加CIVortexDistortion滤镜后的视频

图四：断点调试时Core Image对每帧的处理流程

基于Metal构建Core Image Kernel

==============================

---

使用CI Kernel有诸多优势，包括上文提及的缩短runtime编译时间、高性能语言特性（如gather-reads、group-writes、半精度浮点数）、高效开发体验（如缩进检查、缩进高光）。基于Metal构建CI Kernel有5步流程，会在下文进行逐一介绍。

▐  在项目中增加自定义构建规则

苹果官方推荐在项目target中增加两项自定义构建规则。第一个构建规则针对以“.ci.metal”为后缀名的文件。该构建规则会创建一个以“.ci.air”为后缀名的二进制输出文件。

图五：针对“*.ci.metal”文件的构建规则

第二个构建规则针对以“.ci.air”为后缀名的文件（上一个构建规则的输出结果）。该构建规则会在app的资源文件夹内创建以“.ci.metallib”为后缀名的输出文件。

图六：针对“*.ci.air”文件的构建规则

▐  在项目中增加.ci.metal资源

在Xcode提供的创建面板中选择Metal File即可。开发者对Metal File进行命名时需要以“.ci”作为后缀名，这样项目中新生成的文件会以“.ci.metal”作为后缀名。

▐  编写Metal Kernel

便携Metal Kernel需要include CoreImage.h头文件，用来使用Metal和Core Image提供的各种类。官方提供的范例编写了一个CIColorKernel，输入参数为coreimage::samle_t对象（表示输入图片的一个像素）、time和coreimage::destination对象，返回float4像素。

图七：苹果官方提供的代码范例：Metal Kernel编写

苹果官方为开发者提供了描述CI Kernel中Metal Shader语言的文档，详情见「 Metal Shading Language for Core Image Kernels」① 。

▐  加载Kernel并应用于新图像（基于Swift）

Kernel会被CI滤镜的子类使用。苹果官方推荐开发者在实例化滤镜的CIKernel对象时使用静态属性（static property），这种情况下加载metallib资源的工作仅会执行一次（在首次需要时）。CI滤镜的子类也必须重载输出图片的属性，Kernel将在getter中进行图像处理并创建新图像。

图八：苹果官方提供的代码范例：Kernel加载与使用

Core Image的Debug支持

======================

---

苹果官方在WWDC20详细介绍了Debug特性：CI_PRINT_TREE。

▐  什么是CI_PRINT_TREE

CI_PRINT_TREE的基础框架与Xcode提供的Core Image Quick Look支持相同。Core Image Quick Look为开发者提供了快捷可视化的Core Image图片（详见上文图三），而CI_PRINT_TREE支持几种不同的模式和选项用来查看Core Image如何优化和渲染图像。

▐  如何启用CI_PRINT_TREE

苹果官方提供了CI_PRINT_TREE的两种启动方式。最常用的方法是编辑Xcode target scheme，在Arugments窗体下的环境变量列表中加入CI_PRINT_TREE并设置值。另一种方法是在Terminal.app中通过命令行启动CI_PRINT_TREE（需要在执行应用程序前设定）。

图九：启用CI_PRINT_TREE的两种方式

▐  如何控制CI_PRINT_TREE

CI_PRINT_TREE的字符串格式为“ ”

• **graph type：**表示Core Image render的若干stage，包括type-1初始图像（有助于查看被使用的色彩空间）、type-2优化后的图像（有助于查看core image对render的优化效果）、type-4级联图像（有助于查看各stage如何级联于GPU程序，以便了解render需要多少中间缓存）以及type-7（输出图像type1、2和4）。

图十：苹果官方对graph type四个stage的描述

• **output type：**输出格式可以是pdf或png。在macOS上trees会被存储在临时项目文件夹，在iOS上trees会被存储在文档（Documents）目录下。如果output type没有确定，core image会把tree以紧凑文本格式输出在标准输出（stdout）。通过设置CI_LOG_FILE=“oslog”，文本也可以前往Console.app（在iOS开发中更为方便）。

• **options：**对于CI_PRINT_TREE，开发者可以设定额外的选项。如通过设定context==name来限制输出（仅输出名字相同的context），或是通过设定frame-n来框定具体输出context的哪一帧。更多option及详情请见图十一。设定option对debug能提供很大帮助，但也需谨慎使用，因为生产这些文件需要额外的时间和内存。

图十一：苹果官方提供的option

图十二：type设定为7时tmp文件夹下的文件

▐  如何获得CI_PRINT_TREE文件

在macOS中，开发者只需要进入“/tmp”文件夹就能找到生成的CI_PRINT_TREE文件。需要注意的是沙盒应用会使用特有的临时存储文件夹。

在iOS中，开发者需要将Custom iOS Target Properties中的“Application supports iTunes file sharing”项设为YES（图十三）。这样生成的CI_PRINT_TREE文件可以在连接中的iOS设备上被找到并拖拽至macOS存储中。

图十三：Custom iOS Target Properties中进行设置

▐  如何解释CI_PRINT_TREE文件

读CI_PRINT_TREE时，需要遵循以下规则：