自定义滤镜

滤镜文件

其示例和说明如下：

{
    /* 滤镜组 */
    "filterGroups": [
        {
            /* 滤镜组文件 */
            "file": "lsq_filter_Leica_1.gfilter",
            /* 滤镜组名字 */
            "name": "lsq_filter_group_Leica",
            /* 滤镜组默认滤镜 */
            "default_filter_id": 12,
            /* 滤镜名称背景色 */
            "color": "#E74C3C",
            /* 滤镜 */
            "filters": [
                {
                    /* 滤镜 id */
                    "id": 11,
                    /* 滤镜名字 */
                    "name": "lsq_filter_Brilliant",
                    /* 滤镜缩略图 */
                    "thumb": "lsq_filter_thumb_Brilliant.jpg",
                    /* 滤镜名称背景色 */
                    "color": "#E74C3C",
                    /* 滤镜参数 */
                    "args": {
                        /* 混合 */
                        "mixied": 0.5
                    }
                },
                { "id": 12, "name": "lsq_filter_Leica" },
                { "id": 13, "name": "lsq_filter_Gloss" },
                { "id": 14, "name": "lsq_filter_Harmony" },
                { "id": 15, "name": "lsq_filter_Noir" }
            ]
        },
        {
            "file": "lsq_filter_Beauty_6.gfilter",
            "default_filter_id": 65,
            "filters": [
                { "id": 61, "name": "lsq_filter_SkinNature" },
                { "id": 62, "name": "lsq_filter_SkinPink" },
                { "id": 63, "name": "lsq_filter_SkinJelly" },
                { "id": 64, "name": "lsq_filter_SkinNoir" },
                { "id": 65, "name": "lsq_filter_SkinRuddy" },
                { "id": 66, "name": "lsq_filter_SkinPowder" },
                { "id": 67, "name": "lsq_filter_SkinSugar" }
            ]
        }
    ]
}

更改滤镜显示名称

cocoapod 安装更新 TuSDK 的用户

更改滤镜在滤镜栏上的显示名称，需要找到工程中的 Pods 部分中的 Pods/TuSDK/Resources/TuSDK.strings 文件，修改对应的名称即可。
建议用户 将此文件复制或替换到自己的项目下进行修改，以免将来升级 SDK 时被覆盖。

手动集成 TuSDK 的用户

更改滤镜在滤镜栏上的显示名称，需要找到工程中的 TuSDK.strings 文件，修改文件中对应的名称即可。
建议用户进行 SDK 版本更新后修改 TuSDK.strings，因为手动集成更新需要下载新文件替换原有旧文件。

更改滤镜列表项顺序

调整 TuSDK.bundle/others/lsq_tusdk_configs.json 文件中元素的顺序即可。

修改第一级的滤镜效果图

将所需要的效果图保存为 240 * 240 的 JPG 放入工程，并更改 TuSDK.bundle/others/lsq_tusdk_configs.json 文件中 default_filter_id 字段对应滤镜的 thumb 字段。

修改第二级的滤镜效果图

将所需要的效果图保存为 240 * 240 的 JPG 放入工程，并更改 TuSDK.bundle/others/lsq_tusdk_configs.json 文件中相关的 thumb 字段。

使用部分滤镜

使用配置文件的方式

删除 TuSDK.bundle/others/lsq_tusdk_configs.json 文件中的元素，同时删除 TuSDK.bundle/textures 目录下的相关文件。

使用代码动态改变

使用代码方式动态设置滤镜的显示比使用配置文件的方式更加灵活，用户需要给出要显示的滤镜的名称即可。
在相机中使用部分滤镜

TuSDKPFCameraOptions *opt = [TuSDKPFCameraOptions build];
opt.filterGroup = @[@"SkinNature", @"SkinPink", @"SkinJelly", @"SkinNoir", @"SkinRuddy", @"SkinPowder", @"SkinSugar"];

在多功能组件中使用部分滤镜

_photoEditMultipleComponent.options.editFilterOptions.filterGroup = @[@"SkinNature", @"SkinPink", @"SkinJelly", @"SkinNoir", @"SkinRuddy", @"SkinPowder", @"SkinSugar"];

获取滤镜名称

滤镜的名称可以在 TuSDK.bundle/others/lsq_tusdk_configs.json 文件中获得，在该文件中滤镜列表的层次结构如下所示：

filterGroups[] -> filters[] -> name:lsq_filter_%{Brilliant}
filterGroups[] 指用户所拥有的所有滤镜组；
filters[] 指滤镜组中的其中一组；
filterName:lsq_filter_%{Brilliant} 指的是一组中具体某个滤镜代号，而滤镜的名称从这个代号里面取得。
filterCode：Brilliant ；
比如对于 lsq_filter_Brilliant ，滤镜名称就是 Brilliant，因此用户只需把 Brilliant 这个字符串放到一个字符串数组中并传给设置滤镜的代码即可。
SDK 内部不提供滤镜名称和展示的文案，Demo 只提供了部分的滤镜名称和文案，如果使用的滤镜没有文案展示，请根据 lsq_tusdk_configs.json 提供的 name 字段在 TuSDK.strings进行文案的配置。

打包和上线

打包操作是用户在获取滤镜后，在我的滤镜库中进行打包，在控制台资源打包处进行下载，下载好的滤镜可以直接在用户本地显示。如果用户是需要大量使用滤镜那么下载的资源包就会有较大的体积，那么对于用户想优化 APP 体积大小来说会有一定影响，而且打包下载到本地显示，用户的应用从更新滤镜到应用发布还会有时间延迟，那么相对一些要及时更新的流行滤镜来说就会有影响。
上线操作是用户在获取滤镜后，在我的滤镜库中进行上线操作，那么已经上线的滤镜就会在组件的在线滤镜进行展示，那么用户可以通过涂图的控制台随时更新上线的滤镜资源，APP 的使用者可以随时在我的在线滤镜下载用户实时更新的滤镜，不会影响用户发布的应用的体积，更不会影响使用滤镜资源的时效性。
需要注意的是如果需求使用上线操作的话，那么组件中滤镜栏显示需要按照默认的分组展示的形式进行使用。

涂图