Core Image框架详细解析（十六） —— 包装和加载图像单元 Packaging and Loading Image Units

版本记录

版本号	时间
V1.0	2018.01.29

前言

Core Image是IOS5中新加入的一个框架，里面提供了强大高效的图像处理功能，用来对基于像素的图像进行操作与分析。还提供了很多强大的滤镜，可以实现你想要的效果，下面我们就一起解析一下这个框架。感兴趣的可以参考上面几篇。
1. Core Image框架详细解析（一） —— 基本概览
2. Core Image框架详细解析（二） —— Core Image滤波器参考
3. Core Image框架详细解析（三） —— 关于Core Image
4. Core Image框架详细解析（四） —— Processing Images处理图像（一）
5. Core Image框架详细解析（五） —— Processing Images处理图像（二）
6. Core Image框架详细解析（六） —— 图像中的面部识别Detecting Faces in an Image（一）
7. Core Image框架详细解析（七） —— 自动增强图像 Auto Enhancing Images
8. Core Image框架详细解析（八） —— 查询系统中的过滤器 Querying the System for Filters
9. Core Image框架详细解析（九） —— 子类化CIFilter：自定义效果的配方 Subclassing CIFilter: Recipes for Custom Effects（一）
10. Core Image框架详细解析（十） —— 子类化CIFilter：自定义效果的配方 Subclassing CIFilter: Recipes for Custom Effects（二）
11. Core Image框架详细解析（十一） —— 获得最佳性能 Getting the Best Performance
12. Core Image框架详细解析（十二） —— 使用反馈处理图像 Using Feedback to Process Images
13. Core Image框架详细解析（十三） —— 在写一个自定义滤波器之前你需要知道什么？
14. Core Image框架详细解析（十四） —— 创建自定义滤波器 Creating Custom Filters（一）
15. Core Image框架详细解析（十五） —— 创建自定义滤波器 Creating Custom Filters（二）

Packaging and Loading Image Units - 包装和加载图像单元

图像单元表示Core Image过滤器的插件体系结构。 图像单元使用NSBundle类作为打包机制，允许您将创建的过滤器提供给其他应用程序。 图像单元可以包含可执行或不可执行的过滤器。 （有关详细信息，请参阅Executable and Nonexecutable Filters。）

要从自定义过滤器创建图像单元，您必须执行以下任务：

• 1. 按照Creating a Custom Filter中的说明书写过滤器。
• 2. Create an Image Unit Project in Xcode在Xcode中创建一个图像单元项目。
• 3. Add Your Filter Files to the Project将您的筛选文件添加到项目。
• 4. Customize the Load Method自定义加载方法。
• 5. Modify the Description Property List修改描述属性列表。
• 6. Build and Test the Image Unit建立和测试图像单元

阅读完本章之后，你可能也想

• 阅读Image Unit Tutorial 深入了解编写内核和创建图像单元的信息。
• 访问Apple的Image Units Licensing and Trademarks webpage，了解如何验证图像单元并获取图像单元logo。

---

Before You Get Started - 在你开始前

下载CIDemoImageUnit示例。 当你创建一个图像单元时，你应该有类似的文件。 这个图像单元包含一个过滤器FunHouseMirror。 图像单元中的每个过滤器通常都有三个文件：过滤器类的接口文件，关联的实现文件和内核文件。 正如你可以在示例代码项目中看到的那样，FunHouseMirror过滤器是这样的：FunHouseMirrorFilter.h，FunHouseMirrorFilter.m和funHouseMirror.cikernel。

每个图像单元还应该具有CIPlugInRegistration协议的接口和实现文件。 在该图中，请参阅MyPlugInLoader.h和MyPlugInLoader.m。 您需要修改的另一个重要文件是Description.plist文件。

现在，您已经了解了一些图像单元项目中的文件，现在可以创建一个。

---

Create an Image Unit Project in Xcode - 在Xcode中创建一个图像单元项目

Xcode提供了一个创建图像单元的模板。 在创建一个图像单元项目之后，您将拥有大部分需要开始的文件，并且该项目将链接到适当的框架。

在Xcode中创建一个图像单元项目

• 启动Xcode并选择File> New Project。
• 在模板窗口中，选择System Plug-in > Image Unit Plug-in。 然后点击下一步。
• 命名图像单元项目，然后单击完成。

项目窗口随着创建的这些文件打开：

• MyImageUnitPlugInLoader.h和MyImageUnitPlugInLoader.m，CIPlugInRegistration协议的接口和实现文件
• MyImageUnitFilter.h和MyImageUnitFilter.m
• MyImageUnitFilterKernel.cikernel

图像单元项目中提供的MyImageUnitKernelFilter.cikernel文件是一个示例内核文件。 如果你已经创建了一个过滤器，你将不需要这个文件，所以你可以删除它。 你会在短时间内将自己添加到项目中。

---

Customize the Load Method - 自定义加载方法

打开实施CIPlugInRegistration协议的文件。 在其中你会发现一个load方法，如Listing 10-1所示。 您可以选择向此方法添加代码以执行所需的任何初始化，例如注册检查。 如果过滤器已成功加载，则该方法返回true。 如果您不需要任何自定义初始化，则可以保持原样装入方法。

Listing 10-1  The load method provided by the image unit template

-(BOOL)load:(void*)host
{
    // Custom image unit initialization code goes here
    return YES;
}

如果需要，可以编写unload方法来执行过滤器可能需要的任何清理任务。

---

Add Your Filter Files to the Project - 将您的筛选文件添加到项目

将之前创建的过滤器文件添加到图像单元项目。 回想一下，您将需要每个过滤器和关联的内核文件的接口和实现文件。 如果尚未编写过滤器，请参阅Creating Custom Filters。

请记住，您可以在一个图像单元中打包多个过滤器，并且可以为过滤器提供所需的多个内核文件。 只要确保包含了要打包的所有筛选器和内核文件。

---

Modify the Description Property List - 修改描述属性列表

对于可执行过滤器，只能从Description.plist文件中读取版本号，过滤器类和过滤器名称。 您可以在代码中提供过滤器的属性列表（请参阅Write a Custom Attributes Method）。 您需要检查图像单元模板中提供的Description.plist文件，确保过滤器名称正确并输入版本号。

对于CPU不可执行的过滤器，图像单元主机将读取Description.plist文件以获取有关表10-1中列出的过滤器属性的信息。 您需要修改Description.plist文件，使其包含适当的信息。 （有关过滤器键的信息，另请参阅Core Image Reference Collection）。

Keys in the filter description property list

Table 10-2列出了输入参数类和与每个类关联的值。 对于不可执行的过滤器，可以为每个输入和输出参数提供参数类别。

---

Build and Test the Image Unit - 建立和测试图像单元

在开始创建图像单元之前，您应该测试内核代码以确保其正常工作。 （请参阅 Use Quartz Composer to Test the Kernel Routine。），成功构建图像单元后，您需要将其复制到以下目录：

• /Library/Graphics/Image Units
• ~/Library/Graphics/Image Units

然后，您应尝试从应用程序中加载图像单元，并使用包装在单元中的过滤器（或多个过滤器）。 请参阅 Loading Image Units，Querying the System for Filters和 Processing Images。

---

Loading Image Units - 加载图像单元

Apple提供的内置过滤器会自动加载。 您需要加载的唯一过滤器是打包成图像单元的第三方过滤器。 一个简单的图像单元可以包含一个或多个图像处理过滤器。 如果图像单元安装在Build and Test the Image Unit中讨论的位置之一中，则可由任何调用CIPlugin类提供的load方法之一的应用程序使用，如表10-3所示。 您只需要加载一次图像单位。 例如，要加载所有全局安装的图像单元，可以将以下代码行添加到应用程序的初始化例程中。

 [CIPlugIn loadAllPlugIns];

调用load方法后，您将继续使用Apple提供的任何图像处理过滤器。 按照本章其余部分的说明进行操作。

---

See Also - 也可参考

• Image Unit Tutorial（图像单元教程）提供了编写各种内核的步骤说明，并将它们打包为图像单元。
• CIDemoImageUnit是一个示例图像单元Xcode项目。

后记

本篇已完成，后面更精彩~~~