企业官网建设流程全解析

PixelFree 是望图推出的全平台美颜特效 SDK，支持 iOS、Android、HarmonyOS、Windows、macOS、Linux 六大平台，内置50 款可选滤镜，涵盖黑白、暖色调、粉嫩、日系、拍立得等主流风格。只需PFBeautyFilterName（滤镜名）+PFBeautyFilterStrength（滤镜强度，0.0~1.0）两个参数，就能在直播、短视频、相机、照片处理场景中快速完成滤镜切换与强度微调。本文为你整理滤镜完整清单、命名规则与强度调节技巧，3 分钟即可上手。

一、滤镜资源在哪：先认识 filter_model.bundle 📦

PixelFree 的 50 款滤镜统一打包在滤镜资源文件filter_model.bundle中，各平台示例仓库均可找到该资源，例如 SMBeautyEngine_linux/Res/filter_model.bundle、SMUpdateService 等目录。

资源加载流程非常直接：

1. 读取filter_model.bundle文件内容；
2. 以PFSrcTypeFilter（滤镜资源类型）加载；
3. 之后随时可调用PF_pixelFreeSetBeautyFilterParam()切换滤镜名称与强度。

官方 C API 文档详见 doc/api_c.md，其中 doc/api_c.md#L273-L277 给出了最典型的"设置滤镜 + 设置强度"两步写法：

// 设置滤镜名称 const char* filterName = "heibai1"; PF_pixelFreeSetBeautyFilterParam(handle, PFBeautyFilterName, (void*)filterName); // 设置滤镜强度（0.0 ~ 1.0） float filterStrength = 0.8f; PF_pixelFreeSetBeautyFilterParam(handle, PFBeautyFilterStrength, &filterStrength);

💡 小技巧：不想用滤镜时，传入滤镜名origin（原图）或将强度设为0.0即可一键还原原始画面。

二、滤镜完整清单：从黑白到暖色调 🎨

下表汇总自官方各平台 Demo 的滤镜配置（iOS 见 PFDateHandle.m，HarmonyOS 见 pixelfree_filter.json，Android 见 PixeBeautyDialog.kt）：

📌 说明：上表为官方 Demo 中按场景命名的滤镜；完整 50 款滤镜全部打包在filter_model.bundle中，SDK 功能列表见 README.md#L65-L78。滤镜名大小写敏感，建议直接从 Demo 源码中复制参数值使用。

三、滤镜强度调节：0.0~1.0 参数详解 🎚️

滤镜强度通过PFBeautyFilterStrength设置，取值范围0.0 ~ 1.0，这是 PixelFree 滤镜"可玩性"的核心所在：

• 0.0：滤镜完全不生效，等同原图；
• 0.5：中性强度（Demo 默认值，多数滤镜的"标准观感"）；
• 1.0：满强度，色彩与氛围最浓。

按场景调参建议：

HarmonyOS Demo 中滤镜面板的强度回调可直接参考 FilterPanel.ets，其滤镜分类数据源即上文提到的 pixelfree_filter.json。

四、各平台设置滤镜的实践方式 📱

PixelFree 的滤镜 API 跨平台统一，核心都是"名称 + 强度"两步：

• Android / Kotlin：通过PFBeautyFilterType.PFBeautyFilterName传入滤镜名，切换时联动PFBeautyFilterStrength，参考 BeautyView.kt；
• iOS / Objective-C：滤镜列表定义在 PFDateHandle.m，每项包含滤镜参数名、中文标题与默认强度 0.5；
• Windows / Linux / macOS（C/C++）：统一走PF_pixelFreeSetBeautyFilterParam()，详细接口说明见 doc/api_c.md；
• Flutter：封装于 method channel，参考 pixelfree_method_channel.dart；
• HarmonyOS：通过PF_pixelFreeSetBeautyFilterParam等价能力，UI 面板见 FilterPanel.ets。

五、滤镜与美颜叠加后的性能表现 ⚡

不少用户担心：50 款滤镜随便切，会不会掉帧？PixelFree 定位为高性能 + 轻量级引擎，滤镜与磨皮、瘦脸、美型等美颜参数可实时叠加，且切换滤镜无需重建渲染管线。官方 iOS Demo 在 Xcode 能量报告中的实时监测显示，滤镜 + 美颜全开时 GPU、CPU 占用平稳，无过热风险：

更多功能（贴纸、美妆、调色、绿幕）可继续查阅 README.md 与 doc/frequently_asked_questions.md。

六、常见问题 FAQ ❓

Q1：滤镜和磨皮、瘦脸可以同时用吗？可以。滤镜走PFBeautyFilterName/PFBeautyFilterStrength，美肤走PFBeautyFilterTypeFaceBlurStrength（磨皮）等独立参数，互不冲突，这也是短视频 App 的标准组合。

Q2：如何做到"按住预览、松手取消"的滤镜效果？只需在回调中切换滤镜名：按下时设为目标滤镜（如nuansediao1），松手时切回origin，或把强度临时置为0.0。

Q3：强度调高了画面发"脏"怎么办？将强度回落到 0.5 左右，或叠加美颜模块的"美白"（0.2~0.3）与"锐化"参数修正；黑白、拍立得类滤镜天生浓郁，建议上限 0.8。

Q4：Linux / Windows 上滤镜不生效？确认已用PFSrcTypeFilter类型成功加载filter_model.bundle，且滤镜名与资源包内名称完全一致（区分大小写）。

掌握滤镜名称清单与 0.0~1.0 强度调节后，你就能在 PixelFree 的 6 大平台 Demo 上快速复现各种风格化画面。想进一步玩出花样，可结合 doc/doc_c.md 中的完整 C 接口示例，把滤镜切换封装成你自己的滤镜面板。