--- title: 空域接口参数说明 description: "空域滤波包含0~4号基础滤波器即nXsf0、nXsf1、nXsf2、nXsf3、nXsf4，也包含基础滤波器的组合处理。不同级采用了不同类型的空域滤波器，第0级和第1级采用的滤波器去噪保边的能力较强，但易出现条状噪声（称为SFi滤波器组）。第2级和第3级的滤波器去噪保边的能力稍弱，但副作用较小（称为SFk滤波器组）。" url: https://www.hiascend.com/document/detail/zh/canncommercial/latest/others/ispdevug/ispdevug_0064.html sourcePath: /source/zh/canncommercial/900/others/ispdevug/ispdevug_0064.html indexId: f7427913e428fc1afe00f6eda0d422f537adf0049b8b11babaa0e12aa1165f9f64 --- # 空域接口参数说明 空域滤波包含0~4号基础滤波器即nXsf0、nXsf1、nXsf2、nXsf3、nXsf4，也包含基础滤波器的组合处理。不同级采用了不同类型的空域滤波器，第0级和第1级采用的滤波器去噪保边的能力较强，但易出现条状噪声（称为SFi滤波器组）。第2级和第3级的滤波器去噪保边的能力稍弱，但副作用较小（称为SFk滤波器组）。 - [nXsf1] [nXsf2] [nXsf4]分别用于调试一号，二号滤波器和四号滤波器（三种不同特性的空域滤波器）。 - 一号和二号滤波器的特点对于图像强边缘的去噪能力较强，但是对于平坦区域的去噪能力较弱（相对于四号滤波器，平坦区域的颗粒感强一些）。 - 四号滤波器的特点是对于平坦区域的去噪能力强，可以很好的去除平坦区域的颗粒感。保边的能力强（图像强边缘更加锐利），但边缘去噪能力相对较弱。 - 第2级中的SFk滤波器组，一号滤波器和二号滤波器共用二号强度参数。 - 每级的[nXsf1] [nXsf2]和[nXsf4]接口均有三个参数。 - 第一个和第二个参数用于调节滤波器强度，设置范围均为[0,255]。通常只需要调节第一个参数（第二个参数设置为0）；然而在第一个参数设定较大的时候，仍需要加强去噪强度，可调节第二个参数作为补充。（注意一号滤波器的去噪强度只跟第一个参数相关。） - 第三个参数用于调试“亮暗不对称”去噪模式：设置为128时表示亮暗对称去噪模式（默认模式）；设置为小于128时倾向去亮噪声，设置为大于128时倾向去暗噪声。该参数偏离128值越大，表示不对称强度越大。取值范围 [0, 255]。 - [nXsf0、nXsf3]非显性可调参数的两个滤波器，分别为0号和3号滤波器。 - 其中0号滤波器为该级输入的原始像素。 - 第3号滤波器效果介于2号和4号滤波器之间。 - nXsf3与nXsf4共用相同配置参数。 - [kmode]：用于决定第2级和第3级滤波器的SFk滤波器是否根据亮度决定不同的去噪强度。 - 其中值为0时：普通模式，不能根据亮度决定去噪强度。 - 当值为1，2或3时，第4号滤波器将使用数组（sbs_k[32]和sds_k[32]）来表示不同亮度强度时不同的去噪参数曲线。kmode值为1，2，和3的差异在于亮度度量方式不同，差异较小，建议取值为1不需要调试。 - [sbs_k sds_k]：第2级和第3级有该接口。将亮度分为32份，每个亮度对应的图像内容可调节不同的第2级和第3级中的4号滤波器强度，其中sbs_k和sds_k分别表示为针对相对亮区噪声和相对暗区噪声的空域去噪强度。取值范围：[0, 8191]。 - [nXsf5]：该接口用于调试五号滤波器，是一号至四号滤波器的混合结果，用于组合不同频段的降噪或者细节增强。其中四个参数分别用于配置四组滤波器结果，第一个参数用于配置一号滤波器结果，以此类推。 - 当[nXsf5]接口中对于某滤波器的参数小于64的时候，该滤波器结果用于去噪，值越小去噪的强度就越大； - 当该参数大于64的时候，滤波器结果用于细节增强，值越大增强的效果越强； - 当该参数等于64时，相当于关闭该滤波器对于最后组合结果的影响。取值范围为[0,255] - 此接口最终输出是四组滤波器混合的结果。如果四个参数的平均值大于64，最终输出倾向于增强的结果；如果小于64，最终输出倾向于去噪的结果。 - 此接口取值有一定的限制：对于所有小于64的取值，它们到64的距离累加和要小于64。 - [sfs5]：该接口用于第3级，设置五号滤波中四组滤波器的强度，值越大滤波或者增强的效果越强。 - [dzsf5]：该参数用于控制五号滤波器结果在图像中的作用范围，该值越小，作用的范围越大，当设置成999的时候，相当于关闭五号滤波器功能，取值范围为[0,999]。 - [nXsf6]：该接口配置六号滤波器结果，为两组滤波器的混合结果。该接口前两个参数为参与混合滤波器号码（可以从0~5号滤波器中选择）。最后一个参数则为混合方式，取值范围[0, 4]。该参数取0的时候输出是原始值，其他表示四种不同的混合方式： 第一种是按比例混合，混合权重由第三个参数决定（取值范围为[0,15]），混合权重越大，越倾向于取后面一组滤波器的结果。 该值为2~4时混合方式为选择输出第二个滤波器的结果为输出结果，但是会倾向靠近第一个滤波器的结果。 - [nXsfr6]：该接口在sf6接口的第四个参数选择4的时候生效。用于该模式约束的四种检查机制，值越大倾向选择[nXsf6]的第二个结果。取值范围均为[0,31]。结果取4种方式中最靠近第二个结果的。 - [nXsbr6]：该接口用于六号滤波器的亮暗非对称调节。该参数只在[nXsf6]第四个参数选择4的时候生效，两个参数用于分别控制[nXsf6]第一个结果和第二个结果混合比例，可以配置在亮和暗的两个结果采用不同的混合比例。 - [nXsfn] [nXsth/nXsthd]：nXsfn表示不同图像特征区域选择不同滤波器的类型，取值[0,6]，与[nXsth/nXsthd]接口配合使用，nXsth/nXsthd则表示不同区域的特征区分阈值的上下限，取值为[0,511]，nXsth的取值应大于等于nXsthd。 假设某一级空域nXsfn/nXsth/nXsthd参数分别为sfn0、sfn1、sfn2、sth1/sth_d1、sth2/sth_d2 - 第二个特征小于sth_d2时选择sfn2的结果； - 大于等于sth2且第一个特征小于sth_d1时则选择sfn1结果； - 第一个特征大于sth1时选择sfn0的结果。 此方法可实现在不同区域需要不同处理效果。 sth1/sth_d1、sth2/sth_d2分别使用不同滤波器的特征阈值，度量存在差异，不能直接进行对比。 - [sfr]：整个空域滤波结果控制，取值[0,31]，值越大空域作用程度越强，当N为0，则空域滤波关闭。