# FilterEffectOptions (/zh-CN/api-reference/rtc/cpp-all-platforms/class-filtereffectoptions)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="class_filtereffectoptions__prototype"></a>

```cpp
struct FilterEffectOptions {
  const char * path;
  float strength;
};
```

<a id="class_filtereffectoptions__detailed_desc"></a>

:::info[自从]
自 v4.4.1 版本新增。
:::

<a id="class_filtereffectoptions__parameters"></a>

## 属性 [#属性]

<ParameterList>
<a id="path"></a>
<Parameter name="path">

本地立方体贴图纹理文件的绝对路径，用于自定义滤镜特效。指定的 .cube 文件必须严格遵循 Cube LUT 格式规范，否则滤镜选项无效。

:::note
注：

- 立方体贴图文件第一行的标识符 `LUT_3D_SIZE` 表示三维查找表的大小。滤镜特效的 LUT 大小只能设置为 32。
- SDK 提供了内置的 `built_in_whiten_filter.cube` 文件。你可以传入该文件的绝对路径以获得美白滤镜效果。
:::

</Parameter>
<a id="strength"></a>
<Parameter name="strength">

滤镜特效的强度，取值范围为 [0.0, 1.0]。0.0 表示无滤镜效果，默认值为 0.5。数值越大，滤镜效果越强。

</Parameter>
</ParameterList>