# AgoraFilterEffectOptions (/zh-CN/api-reference/rtc/macos/class-filtereffectoptions)

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

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

```objc
__attribute__((visibility("default"))) @interface AgoraFilterEffectOptions: NSObject
@property(nonatomic, copy) NSString* _Nullable path NS_SWIFT_NAME(path);
@property(nonatomic, assign) float strength;
@end
```

<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>