ISP API Tuning SOP

REVISION HISTORY¶

Revision No.	Description	Date
1.0 (API Ver. 1.0)	Initial release	12/20/2023
1.1 (API Ver. 1.0)	Added AEConvergeSpeedEX API	01/04/2024
1.2 (API Ver. 1.0)	Added FDAWB and FDAWBInfo API Added FWST Strategy API	01/04/2024
1.3 (API Ver. 1.0)	Added Hue API Added AlscAdj API Updated Dummy API Updated Dummy EX API	01/17/2024
1.4 (API Ver. 1.0)	Updated Dummy EX API	02/05/2024
1.5 (API Ver. 1.0)	Updated description of Sharpness and SharpnessEx	02/19/2024
1.6 (API Ver. 1.0)	Added FDAE API Added FDAE_EX API Added FDAF API Added AF_Adjust API Added AF_Adjust_II API Added AF_Adjust_III API Added AF_BackUpPosition API Added AF_Offset API Added FDAF API Added AF_DetectFlatZone API Added AF_StartVCMPos API	05/14/2024
1.7 (API Ver. 1.0)	Revised FDAE_EX API	05/20/2024
1.8 (API Ver. 1.0)	Added description of scene mode API	05/31/2024
1.9 (API Ver. 1.0)	Revised description of FDAE_EX API	06/20/2024
1.10 (API Ver. 1.0)	Update AF_Adjust_III API	06/21/2024
1.11 (API Ver. 1.0)	Revised description of FDAE_EX API	06/26/2024

CALIBRATION¶

OBC¶

OBC基本原理¶

在CMOS传感器采集信息的过程中，AD芯片的精度可能无法将很微弱的信号的一部分转换出来，因此需要在AD输入之前加上一个固定的偏移量，来让暗部细节完整保留，但是会损失一部分亮部细节。OBC模块就是通过校正的方式，来确定这个偏移量的具体值。

RAW图像抓取要求¶

如果sensor没有提供OB参数，或者需要更加精确的OB参数，则需要客户进行黑电平校正。校正需要的RAW图像抓取步骤如下：

A. 将镜头用镜头盖完全遮住，确保镜头不存在漏光现象，如果光圈可变，将设备光圈完全关闭，确保无光线进入。

B. 需要抓取1X增益和最高倍增益的RAW图像进行校正（注：如果结果差距过大，需要多抓几组校正）。具体方法如下：将AE设置为M_Mode，设置ManualExposure中的SensorGain/ISPGain/US。到AEInfo模块下，查看AE是否写入正确。

C. 使用API TOOL抓取RAW文件。

遮黑画面异常范例

OB校正步骤¶

Plugin选单选择SStarCalibrationTool → CalibrationOBC
根据抓取的RAW的名字，设定对应的RAW信息
Open Raw Image（注意文件夹名称不要出现中文），勾选Show OBC Table，点击CalOBGain

校正结果分析¶

CalibrationOBC结果示意图

第0列即为校正结果，可以将结果填写到OB模块中，如果在各个增益下，校正结果差距在±50，即只需校正一组即可。

ALSC¶

ALSC基本原理¶

Shading主要分为两种：Lens Shading 和Color Shading。

Lens Shading：

A. 由于镜头的光学特性，sensor边缘区域接收到的光线强度比中心小，造成的中心和四周亮度不均匀的现象（暗角）。

B. 镜头主光线角度（chief ray angle，CRA）和sensor不匹配，导致sensor边缘区域接收的曝光不足。

Color Shading：

A. 由于镜头在边缘区域的入射角度不足，导致色彩偏差现象（色散），一般表现中心和四周颜色不一致。

B. 由于不同光源或者不同色温的频谱不同，加上IR-cut的影响，导致色彩不均匀。

所以，某些shading严重的镜头（包括Lens Shading和Color Shading），需要在做AWB之前进行shading校正。

RAW图像抓取要求¶

使用DNP灯箱，将镜头正对灯箱平面，保证光照均匀，如果没有DNP灯箱，使用毛玻璃盖住镜头，对准标准灯箱光源也可以。
设定灯箱亮度，或者调节AE target，画面中心亮度是最高亮度的70%左右（抓取RAW，用imageJ，框选中心部分查看亮度）。
抓取RAW数据。

ALSC校正步骤¶

Plugin选单选择SStarCalibrationTool → CalibrationALSC
根据抓取的RAW的名字，设定对应的RAW信息
Open Raw Image（注意文件夹名称不要出现中文），勾选Show ALSC Table
设定对应的OBC参数，以及色温参数
点击GenTable进行校正

校正结果分析¶

CalibrationALSC结果示意图

图像表示即为校正结果，选择对应的色温CT/CT Num，点击API Apply进行在线套用，再到ALSC模块，点击read page，将校正参数读到tool，进行保存。

注意事项¶

记得Apply后，记得到ALSC页面read page，以免校正参数没有保存到。

AWB¶

AWB基本原理¶

AWB校正，即根据sensor在数个标准光源下的白点特征，来计算出真实场景的（R/G、B/G）增益。

AWB校正步骤¶

将镜头对准标准灯箱内的灰墙或灰卡（使其占满整个画面）
设定需要校正的色温（D65/D50/TL84/CWF/U30/A具体根据灯箱情况决定使用）
确认已校正设定好OBC
AE设定为Auto，调整AE target，让画面不要过曝
Plugin选单选择AwbAnalyzerCombo
选择要校正的色温范围，建议是2300K ~ 10000K
拖动小红标或者小蓝标，使得落点全部落在对应的框中，尽量使得整条曲线比较平滑。
调整多个色温，调整完毕点击Apply To Camera，套用到板端查看效果
到AWBCTCali模块中read page，再将参数保存

注意事项¶

校正完，记得多场景测试AWB效果，依法校验调整框的大小，确保在各个环境下的稳定表现。

CCM¶

CCM基本原理¶

CCM校正原理，是根据sensor拍摄各个色温下24色卡的实际颜色信息，再根据目标颜色信息，计算出3X3 CCM矩阵，使得相机输出的颜色表现符合我们的期望。校正前请务必先决定好gamma，如果要校正成对比机的gamma，请参考Gamma Fitting。详细使用说明请参阅CCM Analyzer plugin。

RAW图像抓取要求¶

在标准灯箱中，将镜头对准24色卡，确保色卡位于画面中心，并且占整个画面50%~80%
设定灯箱色温，一般为D65/TL84/A
调整灯光亮度，或者调整AE target，使得抓取的raw第19格不过曝
使用API Tool抓取raw数据

CCM校正步骤¶

Plugin选单选择CCM Analyer
设定对应的Raw信息
Open Source 打开对应的欲校正的影像来源，目前可以支持RAW/BMP两种文件格式
- RAW: 如果打开的文件格式为.raw的话，在校正前会扣除OB(会自动从BleckLevel的Manual数值取得)，并乘上正确的WB gain(从下方6个灰色patch算出)，后续校正过程中会套上Gamma Curve(会自动从Gamma中的Manual Gamma曲线取得)。
- BMP: 如果打开的档案是.bmp，则只有校正过程会被套用Gamma Curve。因此使用bmp作为校正来源，需要确保此.bmp檔是在 CCM前(不含CCM)的模块有被开启、CCM后(含CCM)的模块有被关闭并确认colortrans有对齐拨放器 的情况下拍得。此外如果是.bmp档不需理会raw setting的参数。
开启影像来源后，点击左键，拖曳框选欲校正的色块即可。
Open Target 可以指定每个色块欲校正的目标色彩。目前有几组Default Target可供选择，或者用户可以Customer Target自定义目标色块。

Default Target : 有以下几种目标色彩可供选择
- SkypeCertification : 微软Skype video specification校正色块目标，可参考https://learn.microsoft.com/en-us/SkypeForBusiness/certification/test-spec?redirectedfrom=MSDN。(预设)
- XRite after 2014 : XRite根据2014年11月前统计出的目标校正色块。
- XRite before 2014 : XRite根据2014年11月后统计出的目标校正色块，可参考https://www.xrite.com/service-support/new_color_specifications_for_colorchecker_sg_and_classic_charts。
- BabelColor Avg: BabelColor根据30张色卡平均出来的目标校正色块，可参考https://babelcolor.com/tutorials.htm。
Customer Target : 可以照用户需求自行定义目标色块。在apitool=>taget_image下有提供预设色卡(同SkypeCertification)。

Target Saturation : 可以设定要校正到目标色卡饱和度的几%，建议调整上下限为80%~120%。
调整Component constraint
设定校正参数及目标函数，如下图。
- 黄色框 : 设定目标函数为delta C或delta E，其中delta C只考虑色域误差，delta E会多考虑亮度误差。
- 红色框 : 设定目标函数使用CIE 76或CIE 2000定义的color difference。
- 绿色框 : 抑制Max Error参数，预设为10，可在0~100间调整。调整后可以Trade off Avg Error以及Max Error，但调太大会牺牲Avg Error，建议设置在50以内。
- 蓝色框 : 校正算法选择，勾选的话会使用较精准但较慢的算法，取消勾选则会使用较不精准但较快的算法。
点击Calculate，进行校正计算
取消勾选Floating，选择插入的组别，将校正结果套用到机器

校正结果分析¶

CCM校正结果示意图

校正结果分析界面如上图。

红色框：显示当前校正结果，目标函数对应先前设定的参数。
黄色框：在Lab色彩空间上显示目标色卡颜色落点及校正后颜色落点，圆点为目标色卡颜色落点，方点为机器落点，可以可视化颜色误差大小。
蓝色框：校正结果的CCM矩阵。
绿色框：每个色块的色彩误差值，值越小与标准色卡的差距就越小。可以查看当前校正结果以及各种目标函数组合计算出的结果，组合如下，CIE2000 deltaC、CIE2000 deltaE、CIE76 delta C及CIE 76 delta E。

注意事项¶

在校正结果不是很理想的情况下，可以手动调整CCM矩阵参数，来达到想要的效果，通常由于镜头以及sensor的关系，有些模块单靠CCM很难完全校正准确，这时候可以选择HSV来细微的调整一些颜色表现。

AE Exposure Table 设定¶

不同的sensor及lens特性及能力皆不同，预设的AE exposure table不见得适合目前的module，因此需要去检查，并将其修改为适合目前module的设定。

调整界面¶

点选左方的AE项目，再点选ExpoTblEntry即可出现AE exposure table调整窗口。

AE设定接口

AE Exposure Table

参数说明¶

NumOfExpoTblEntry：设定AE exposure table的数量。以AE设定接口设5为例，AE exposure table就须填入5组设定。

Table第一字段：镜头光圈值（Fn）x10。例如光圈1.6则填入16。

Table第二字段：快门（usec）。

Table第三字段：Total gain（1024 = x1 gain），也就是Sensor gain x ISP gain。

Table第四字段：Sensor gain（1024 = x1 gain）。

设定项目¶

确认lens光圈值，将光圈值x10填入第一栏。
向客人询问maximum gain，填入倒数第一列的第三栏中。
若不使用ISP gain，直接将第三栏的值复制到第四栏中。

3DNR¶

3DNR基本原理¶

3DNR校正是用来评估Sensor的在各种sensor gain中不同亮度的噪音程度。Linear mode校正前需要先确保OBC已经被校正并套用。HDR mode校正前需要先确保OBC以及AWB色温框已经被校正并套用。

RAW图像抓取要求¶

校正场景可以为灯箱Dynamic Range Chart或普通实验室暗房场景（需要尽量复杂确保各种颜色亮度出现）。

3DNR校正场景，左图为Dynamic Range Chart，右图为一般实验室场景

校正3DNR需要根据sensor gain校正，并校正到最大会使用的sensor gain。Index的对应为index 0代表1024、index1代表2048、index2代表4096，以此类推。

拍摄校正raw图前，要先设定欲校正的index。使用Manual AE将ISPGain设定为1024，SensorGain设定为 欲校正的倍率 。调整灯光及Shutter 使画面不过曝或其他不正常曝光 。
画面曝光调整完成后可以先拍摄2张raw检查校正条件是否达标，具体要求可以参考确认校正资料是否合格。
抓取60张同场景raw图作为校正数据，抓取时需要保持环境场景不变（无运动物体、无亮度变化），抓取Raw图时要依照gain index放到文件夹下，例如index0、index1……（名字自定义）。
建议从index0(SensorGain=1024)开始校正，后续 SensorGain每增加一倍，Shutter或光源就减半 ，例如：先校正index0(SensorGain=1024)时，US=14000校正条件达标，当要校正index1(SensorGain=2048)时，则US=7000或光源强度调弱一半，便可确保校正条件维持达标。

校正设定及步骤¶

校正工具

需要IQTool v2.0.124以上，并使用插件SStar3DNRCalibration

选择3DNR校正工具选单

校正接口设定说明

校正参数设定接口

Set Raw Format：设定raw的分辨率、宽、高及Bayer pattern等等信息。
Folder：输入raw的文件夹路径，文件夹中的raw档皆为同一Gain Index的档案。
Assign Gain Index：要校正的Gain Index，需要从0开始填，若有一段Gain Index区间要校正为同一个值，可用横杠连接，例如Gain index 0到6要校正为一样的值可写做0-6。最终要填到gain index 15。
OB Gain Index：校正的OB档位，会从OBC模块去读取对应档位的OBC参数。
Frame：校正的raw数量，建议60张。
OB/Dummy Mode：只读的OBC及dummyEx dummy3参数
HDR Mode：勾选后可以支持HDR长曝校正，并且字段中会出现，各档位WB Gain供填入。
Dump Data勾选可以产生对应校正txt 文件，可以用来参考校正结果是否正常，Debug Log勾选有弹窗提醒。

校正步骤

校正完成显示接口

Step 1. 校正前按照前述章节搜集校正raw档，并依照Gain index区分文件夹。 Linear mode 要先确认BlackLevel已经正确校正并套用及Dummy_EX中的Dummy3已经正确设定。 HDR mode 要先确认BlackLevel_P1已经正确校正并套用。

Step 2. 根据接口说明设定Raw信息及各文件位校正信息，并点击Generate，等待底下进度条跑完即完成校正。

Step 3. 校正完成后接口显示如下，点击文件夹字段下方直方图会显示该校正数据于 每个颜色通道及亮度区间的数量直方图 ，并且会在IQ Tool的data/cfg下产生ne_cali.data，最终可以用来加载版端。如果Dump Data有被勾选会产生dump_ne_data_WIDTHxHEIGHT_gain0#.txt，例如: gain00代表index0，gain01代表index1。

确认校正数据是否合格¶

正常的校正数据范例

从左到右为暗到亮，越暗的场景左边点数越多，需确认每个亮度下RGB三个通道都有对应的count数。（除了前2个亮度count数可以比较低，尽量保证其他亮度count数大于50）

正常校正数据

不合格的校正数据范例

如下图显示点数几乎集中在暗部，亮部几乎没有点数，因此校正数据不合格。如果发生此情形请先依序检查 校正模式（HDR/Linear Dummy Mode）、OB设定以及Raw场景曝光情况 。

异常校正数据

校正结果的套用¶

临时套用

校正结束后可以用接口上工具套用校正数据，以供验证效果。步骤为勾选Load Cali Data，便可点选Select Cali选择校正产生的ne_cali.data，最后点击CalibApply即可套用。但需要注意这种套用方式重新启动，效果不会生效。

接口工具套用校正数据示意图

开机生效套用

如果要开机时就生效需要将ne_cali.data文件放入板端，并调用MI_ISP_CmdLoadCaliData来套用ne_cali.data。

检查校正参数套用是否生效

点击套用或调用MI_ISP_API_CmdLoadCaliData后，串口会显示如下图Log，说明校正数据套用成功。

校正套用成功串口Log文字

3DNR校正后需要重新调整的参数¶

3DNR套用校正后，所有参数都要调回默认， 只需要调整md.thd/md.gain，默认为64/400 。

其他参数建议调整如下：

md.thdByY/md.GainByY全部调回64，可视情况微调。
M2S.Lut还原默认，不建议调整。
MotshpBlendLut还原默认，可视情况调整。
TF.lut还原默认，不建议调整。
MotHistDelayByDiff还原默认，不建议调整。
Dummy.dummy2全改64。

校正效果验证¶

3DNR校正被正确套用后，Debug motion map会在静态场景会比没校正均匀。

校正前，如果没调整md.thdByY/md.GainByY则debug motion map如下，呈现各种亮度的动静判断不均匀。
校正后，即便不大幅度调整md.thdByY/md.GainByY，debug motion map如下呈现各种亮度动静判断均匀。

注意事项¶

场景亮度分布需要相对均匀，不要有过曝或明显曝光不足情况。
OBC或者Dummy_EX dummy3如果有改动，则需要重新打开SStar 3DNR Calibration工具才能生效。
Raw的存放路径要根据ISO文件位分开在不同的文件夹下存放，工具会读取该文件夹路径。

Linear mode ：

Dummy Mode需要从Dummy_EX的Dummy3去设置，3DNR校正工具会从参数中去获取。
OBC的校正数值会从BlackLevel中去获取。
- 当OBC中OpType选择为auto时，则3DNR校正工具会根据字段中的OB Gain Index来Load对应OB值
- 当OBC中OpType选择为manual时，则3DNR校正工具会直接使用manual中的OB参数。

HDR mode ：

HDR mode的3DNR校正只支持长曝校正，因此根据HDR混合情况，后续需要调整亮区的md.thdByY/md.GainByY。
校正时只需要勾选HDR mode并填如WB R/B Gain即可，其他步骤皆跟Linear mode相同。
校正时OBC 是用BlackLevel_P1（长曝OB）去拿。
校正时色温框需要被正确校正，因此色温框有改动时，HDR mode的3DNR视情况需要重新校正。

GAMMA FITTING & COLOR CORRECTION¶

不同的gamma和color对noise会有不同的影响，而且调整denoise时先套入gamma和color设定会比较方便观察，因此通常会先做gamma和color的调整，即便它们在pipeline中是在denoise之后。

Gamma Fitting¶

Color fitting的结果容易受到亮度差异的影响，而亮度差异主要来自AE和gamma，因此在color fitting前务必先做gamma fitting。此步骤主要目的是将调整机台的gamma fit到与对比机的gamma接近。校正前请先确认dynamic range是full range，可以看histogram是否有到最大/最小值。

校正环境¶

使用OECF chart，让光线均匀打在chart上，拍摄时让chart摆在画面中间，不要占满整个画面，否则容易受到shading的影响。

拍摄画面范例

校正界面¶

点选API tool上方Select Plugin，选择Gamma Fitting开启校正接口。

Gamma Fitting界面

校正步骤¶

将环境架设好，首先拍摄调整机台与对比机台fitting所需的image。由于曝光会影响亮度，因此gamma fitting要在相同曝光的基准上会比较准确。要得到接近的曝光，最简单的方式就是拍摄时（调整机拍raw，对比机拍jpg）让OECF最亮色块尽量接近255但不要刚好255，因为我们不知道对比机gamma长甚么样子，但通常gamma最亮点是不会变的，因此拿它来当基准会比拿其它点当基准要好。
读取source raw data的OECF patch值:

点选接口工具栏的Options，填入正确的raw information及OB（WB不需要设定），完成后点选OK。

补充：OB的单位是12bit，最大值只有255，后续会修正为单位是16bit，最大值是65535。

拖曳鼠标来框选OECF，确认每一个patch都有正确落在patch内即完成。
读取target image的OECF patch值:

和上述步骤相同，差别只是target是读取image档，省略了设定raw information的动作。
选择fitting的相关设定，取值方式建议使用patch values，fitting的方式建议使用Exponenitial。
选择好后点选Match GMA执行gamma fitting，观察fitting出来的curve是否有异常，没有的话点选Save GMA储存gamma curve。最后检查储存出来的gamma curve头尾是在0和1023，若不是，请手动作修改。

Color Correction¶

此步骤主要目的是使调整机与对比机的颜色接近，调整主要包含两个部分：第一个也是最主要的部份是color matrix的fitting；另一个为HSV微调的部分，可依需求做局部颜色饱和度与色相的调整。Color matrix与HSV最多可支持16组色温的设定，填参数时务必按照规则，Index0到Index15代表色温由低到高。

CCM调整¶

当使用tool将各色温灯源校正完成，需要手动将校正结果填入CCM对应的项目中。

调整界面

CCM调整界面

参数说明

ISOActEn ：在night mode是否自动将CCM设为unit matrix的开关，若有勾选，当遇到IQMode为Night时会将CCM自动切换为unit matrix。

CCTthr ：色温节点设定，需填入校正CCM时对应的色温值，CCM与HSV要套用哪组设定都会根据此CCTthr来决定，注意index小到大需要按照色温低到高的顺序填入，最多支持16组设定，没用到请设0。

CCM ：各色温color matrix设定，需根据色温填入对应的color matrix，注意index小到大填入时需要按照色温低到高的顺序填入。新增每个Row的总合，SUM0/SUM 1/SUM 2分别代表第1 / 2 / 3列的总合，read就会自动更新，如果不是1024代表有问题，请手动修改CCM。

SATURATIONbyISO ： Color matrix饱和度调整，程序会根据此设定将使用者定义的matrix与unit matrix做内插，值域0 ~ 100，设0表示使用unit matrix，设100表示使用使用者自定义CCM。此参数是根据gain值做切换。

HSV调整¶

当CCM套入后仍有颜色希望微调，则可使用HSV来达成。HSV API在Souffle改为采用HSY色彩空间，会将整个色域切成36分区，其中肤色切分的较细方便使用者对肤色进行细部调整。使用者可依需求调整不同色相及饱和度及亮度对于其他分量作细调。HSV使用auto mode时，请务必确认Index是依据什么来切换，带有_ByIso后缀词的参数是依据gain来切换，而无后缀词是依据色温（这边的色温节点和CCM相同，由CCM来控制）来切换。

Hue的36区块切分方式如下：

HSV Hue切分方式

调整界面

HSV调整界面

参数说明

HueByHueLut ：可依需求局部调整色相，将360度色相分为36份，分别控制每个色相旋转角度。值域范围：-127 ~ 127。（0为不调整），参数切换是根据色温。

HueBySatLut ：可依需求局部调整色相，将饱和度等分为9份，分别控制每个等分饱和度的色相旋转角度，由左至右为饱和度由小到大。值域范围：0 ~ 255。（128 = 1x），参数切换是根据色温。

HueByYLut ：可依需求局部调整色相，将亮度等分为9份，分别控制每个等分亮度的色相旋转角度，由左至右为由暗到亮。值域范围：0 ~ 255。（128 = 1x），参数切换是根据色温。

SatByHueLut ：可依需求局部调整饱和度，将360度色相分为36份，分别控制每个色相的饱和度。值域范围：0 ~ 255。（128 = 1x），参数切换是根据色温。

SatBySatLut ：可依需求局部调整饱和度，分别控制每个等分饱和度的饱和度增减，由左至右为饱和度由小到大。值域范围：-511 ~ 511（0为不调整），参数切换是根据色温。

SatByYLut ：可依需求局部调整饱和度，将亮度等分为9份，由左至右为由暗到亮，分别控制每个等分亮度的饱和度增减。值域范围：0 ~ 255（128 = 1x），参数切换是根据色温。

SatBySYLut ：可依需求局部调整饱和度，将亮度与饱和度的乘积（S*Y）等分为9份，由左至右为亮度与饱和度的乘积（S*Y）由小到大，分别控制每个等分乘积的饱和度增减。值域范围：-511 ~ 511（0为不调整），参数切换是根据色温。

YByHueLut ：可依需求局部调亮度，将360度色相分为36份，分别控制每个色相的亮度。值域范围：值域范围：-511 ~ 511（0为不调整），参数切换是根据色温。

YBySatLut ：可依需求局部调亮度，将饱和度等分为9份，分别控制每个等分饱和度的亮度增减，由左至右为饱和度由小到大。值域范围：0 ~ 255（128 = 1x），参数切换是根据色温。

YByYLut ：可依需求局部调亮度，将亮度等分为9份，分别控制每个等分亮度的亮度增减，由左至右为由暗到亮。值域范围：0 ~ 255（128 = 1x），参数切换是根据色温。

VibranceEn ：自然饱和度功能开关。开启后此模块内与饱和度相关的控制皆会失效。取而代之的是韧体内部内定的饱和度相关调整曲线，可再增加饱和度的同时保持肤色饱和度少量改变。

GrayProtectStrength ：灰色物颜色保护强度。值域范围：0 ~ 63。接近灰色物体可利用此参数来确保色相，饱和度，以及亮度不被调整。

GrayProtectTh ：定义灰色物体的阈值。值域范围：0 ~ 1023。数值越大越容易被定义为灰色物，可利用此参数来确保色相，饱和度，以及亮度不被调整。

DebugMode ：除错模式。值域范围：0 ~ 4可分别显示画面中特定的1.色相，2.饱和度，3.亮度，以及4.亮度与饱和度的乘积。

注意事项： H与Y的调整都是基于Hue的调整量，再针对ByS以及ByY做调整。换句话说，若HbyH的调整量为0，那么HbyS以及HbyY则失效。若YbyH的调整量为0，那么YbyS以及YbyY则失效。

调整步骤

在做完CCM后，若对于画面中的色相（H），饱和度（S），亮度（Y）作微调。

若要微调 色相（H）： 可根据特定的色相（HueByHueLut），特定的饱和度（HueBySatLut）以及特定的亮度（HueByYLut）进行微调，若不知想调整的区块坐落于哪个index则可使用DebugMode来进行查找。
若要微调 饱和度（S）： 可根据特定的色相（SatByHueLut），特定的饱和度（SatBySatLut），特定的亮度（SatByYLut）进行微调，以及特定的饱和度与亮度乘积（SatBySYLut），若不知想调整的区块坐落于哪个index则可使用DebugMode来进行查找。
若要微调 亮度（Y）： 可根据特定的色相（YByHueLut），特定的饱和度（YBySatLut），以及特定的亮度(YByYLut)进行微调，若不知想调整的区块坐落于哪个index则可使用DebugMode来进行查找。

Debug mode使用方式，建议先将HSV设置为Manual Mode

想查找特定区域的HUE，可将Debug mode设置为1，接着使用Manual.HueByHueLut_ByIso设置为下表：

HUE Debug Map

想查找特定区域的SAT，可将Debug mode设置为2，接着使用Manual.HueBySatLut_ByIso设置为下表：

HSY Saturation Debug Map

想查找特定区域的Y，可将Debug mode设置为3，接着使用Manual.HueByYLut_ByIso设置为下表：

HSY Y Debug Map

想查找特定区域的S与Y乘积，可将Debug mode设置为4，接着使用Manual.SatBySYLut_ByIso设置为下表：

HSY SY Debug Map

饱和度与亮度乘积（SatBySYLut）功能通常用于高亮度高饱和区域，可将该区域的饱和度降低，来达到还原高饱和区域的细节，效果图如下：

基于SY 减少饱和度

灰色区域保护功能，通常会希望能拉高饱和度且保持灰度区域不被增加饱和，此时可以使用GrayProtectTh参数来定义灰，若MAX(R,G,B) – MIN(R,G,B)小于定义的TH则会启动该功能，配合上GrayProtectStrength，若设置为63则可保证该区块经过HSY模块后HSY的值都不被调整。

灰色区域保持色相，饱和度，亮度不改变

若想调整整体饱和度但又不想将肤色拉太饱和，则可以使用VibranceEn开关，此开关开启后，原先调整饱和度的参数将失效，取而代之的是韧体内部预设的设置。以下为自然饱和度开启的结果。

开启自然饱和度

HUE调整¶

可以调整整体HUE的角度。

调整界面

HSV调整界面

参数说明

Lev ：可以调整整体HUE的角度，+1为顺时针+2度，-1为顺时针-2度。值域范围：0 ~ 100。（50为不调整）

DataRange调整¶

根据视讯输出格式来调整对应的RGB to YUV转换矩阵。

若未开启Colortrans以及ColortransEX功能，系统内默认值为BT601 limit。

调整界面¶

于左侧选单点选Colortrans，接着在右侧主画面可找到Colortrans以及ColortransEX接口。

Colortrans以及ColortransEX

参数说明¶

< Colortrans >

Enable ：开启自定义色彩转换矩阵功能。

Colortrans.Y.Ofst ：调整Y偏差值。10-bit domain，值域范围：0 ~ 2047，负数以2的补码表示，等同于±1023。

Colortrans.U.Ofst ：调整U偏差值。10-bit domain，值域范围：0 ~ 2047，负数以2的补码表示，等同于±1023。

Colortrans.V.Ofst ：调整V偏差值。10-bit domain，值域范围：0 ~ 2047，负数以2的补码表示，等同于±1023。

Colortrans.Matrix ：调整RGB-YUV矩阵，值域范围：0 ~ 1023，1倍为256，负数以2的补码表示，等同于±1.996。

对于YUV_OFST，Matrix[9]，负数以2的补码表示。

UV偏差值，在矩阵相乘后，已经预设加上128。

下面例子为，将YUV转为16 ~ 235的值域范围

Y = (0.257 * R) + (0.504 * G) + (0.098 * B) + 16
Cb = -(0.148 * R) - (0.291 * G) + (0.439 * B) + 128
Cr = (0.439 * R) - (0.368 * G) - (0.071 * B) + 128

Matrix[9] = {66, 129, 25, 986, 950, 112, 112, 930, 1006}
Y_OFST = 64
U_OFST = 0 （预设已加上128 * 4，所以填0）
V_OFST = 0 （预设已加上128 * 4，所以填0）

< ColortransEX >

Enable ：开启变更色彩转换矩阵功能，若ColortransEX Enable开启，Colortrans参数则失效。

Type ：共六种转换矩阵可以选择，分别为BT601 limit、BT601 full、BT709 limit、BT709 full、BT2020 limit以及BT2020 full。

Saturation调整¶

根据亮度（Y）及饱和度（UV）做UV的调整，分为adjust uv by y及adjust uv by uv，主要是留一些颜色调整弹性在YUV domain上，且因为亮度与饱和度的独立性，可保持亮度恒定，又达到局部调整饱和度的效果。在传感器用到高曝光值的时候，也可适度降低暗处色躁。亦或根据使用者喜好调高或降低饱和度，使画面看起来更鲜艳或较柔和。

调整界面¶

于左侧选单点选Saturation，接着在右侧主画面可找到Saturation接口。

Saturation调整界面

参数说明¶

Sat.AllStr ：整体饱和度的可变强度数值，值域范围：0 ~ 127（32 = 1x）。

Sat.ByYsft、Sat.BySsft ：根据Y/UV调整UV的X轴间距可以透过此调整，但有特殊限制：

节点为2的幂次方并向上相加，例：Sat.ByYsft[5] = {3, 3, 5, 7, 7}

第一点为0，第二点为0+2^{3，第三点为0+2}3+2^{3，第四点为0+2}3+2³⁺²5，以此类推；

则X轴间距点为：{0, 8, 16, 48, 176, 255}，最后一点超过卡到255。

特殊限制为：X轴前四点总和小于255，最后一点一定要大于等于256。

例：Sat.ByYsft[5] = {8, 0, 0, 0, 0}，第一点为0，第二点为0+2^8=256，则违反规则。

Sat.ByYLut、Sat.BySYLut ：节点的数值可以自由决定

Sat.Coring ： UV做同减的动作，建议使用Sat.BySYLut即可。

特殊应用：HDR效果开启后，高亮度会过于饱和，以此可以透过Sat.ByYLut/Sat.BySLut将高亮度/高饱和度的UV向下压，让影像在HDR效果下更显自然。

Sat.ByYsft[5] & Sat.ByYLut[6]

Sat.BySsft[5] & Sat.BySLut[6]

DENOISE & EDGE ENHANCEMENNT¶

虽然板子连上API tool时会将iqfile中默认参数读回接口，但各IP开关与否并不会显示在接口上，若要完全从头开始调整一颗新sensor的画质，建议先去Enable Control界面bypass除了sharpness和之前调整完毕项目（OB、ALSC、Gamma、Color）以外的功能，了解一下这颗sensor尚未做任何denoise前的状况（若画面过于扰动，可以上一点3DNR），例如解像力极限、是否有crosstalk或false color等等，之后再依需求开启对应的功能来调整，避免多余的功能影响画质表现。理论上sharpness也要bypass，但为了方便观察现象，建议还是开着，先用默认值让画面不要太离谱即可（高倍gain可把OverShootGain和UnderShootGain设小一些）。

当调整高倍gain时，没有denoise又开sharpness画面会很脏，脏到无法辨识调整参数的效果，建议可在调NR3D前将Y.TF.STR开强，让画面定住，方便调整NR3D前的一些function。调整建议照ISO index顺序调整，此外，为避免参数内插影响判断，建议将AE设为Manual的SV mode，直接给定各节点的gain值来做调整，完整调好一个再跳下一个增益。调整画质前请将镜头擦干净且确实对到焦，RGB sensor要确认IR cut有盖上。

此外，在高倍增益的情况下噪声较大，过完WB Gain之后，R和B Channel的噪声会再被放大，导致画面暗处偏紫。在该情况下，可优先考虑多扣R和B Channel的OBC方式来做校正。此外也可以将暗处2DNR强度增强（DPC，NRDeSpike）来压低躁声，减少躁声被放大。

Crosstalk & False Color调整¶

调整denoise前先检查是否有fixed pattern、cross talk或false color等现象，有的话先调整，一来是因为这些功能本来就在denoise之前，二来是特殊现象就要用专门的功能才能有效处理，硬用denoise去消除这些现象容易造成画质损失。

Crosstalk（Green Equal）¶

这主要是lens与sensor搭配性的问题，当光线进入sensor上micro lens的角度太大，容易误接收到应该被邻近pixel接收的讯号，导致Gr、Gb差异变大，因此这现象较容易发生在画面角落，或是光线从某个特殊角度进入时。

现象

画面出现迷宫纹：

Crosstalk造成的迷宫纹现象

调整界面

于左侧选单点选BayerCompensation，接着在右侧主画面可找到Crosstalk接口

Crosstalk调整界面

参数说明

Strength ： crosstalk强度值，值域0 ~ 31，越大效果越强。

StrengthByY ：根据亮度调整crosstalk强度值，横轴越右边代表越亮，值域0 ~ 127，越大效果越强。值为64代表不做调整。

Threshold ： crosstalk threshold ratio值，值域0 ~ 255，越大作用范围越大。

Offset ： crosstalk threshold offset值，值域0 ~ 4095，越大作用范围越大。

调整步骤

将Offset设为0，Threshold设为128，Strength由0往上升，观察欲消除crosstalk的区域及欲保留的细节区，调整至crosstalk与细节保留都可接受即停止。
如需微调则再利用Threshold来做微调。
若暗处还是有很明显的crosstalk，再来拉大Offset。

False Color¶

由于demosaic时未考虑方向或方向判断错误导致错误的颜色产生，容易发生在画面高频区域或edge边缘。

现象

画面高频处或edge边缘出现伪色。

False Color现象

调整界面

于左侧选单点选BayerCompensation，接着在右侧主画面可找到AntiFalseColor接口。

False Color调整界面

参数说明

DbgEn : Debug模式，值域范围：0 ~ 1，影像越亮则去伪彩强度越强。此debug模式和Demosiac的debug模式会有冲突，以最后呼叫的API为主。

ColorSpaceSel : 去伪彩模式，值域范围：0 ~ 1，0代表在RGB domain做灰，对齐G通道的值，1代表在yuv domain做灰，不会影响到亮度。

Preserve : 边缘保护强度，值域范围：0 ~ 7，值越大则边缘区域越不容易被判断成moire区域，去伪彩强度越弱。

Strength : 整体强度，值域范围：0 ~ 31，值越大则moire区域愈容易被降饱和度，去伪彩强度越强。

调整步骤

将Strength设最大值，使用debug模式去观察moire区域是否符合预期，再调整Preserve，最后再调降Strength。
切换ColorSpaceSel，观察不同做法的效果如何。

补充:

开启FalseColor对较细的紫边稍微有帮助，若FalseColor开到最强紫边仍严重，可以再利用HSV针对紫色色相降低饱和度，但调整时须注意正常紫色物品的饱和度是否过低。

False Color的调整与Crosstalk存在高度相依（过强的Crosstalk会导致伪彩严重，进而导致后级的False Color无法将伪彩去干净），建议先完成Crosstalk的调整后再进行anti-false color的调整。

由于BayerCompensation接口的write page会先呼叫False Color，再呼叫Demosaic，所以debug模式会以Demosaic为主，如果需要看False Color的debug模式，再呼叫一次False Color即可。

PFC（Purple Fringing Compensation）¶

现象

主要是由色散现象造成，通常会在亮暗交界处出现紫色边缘。

Purple fringing现象

调整界面

于左侧选单点选PFC，接着在右侧主画面可找到PFC接口。

PFC调整界面

参数说明

DbgEn ：显示PFC/BLCC的作用范围。值域0 ~ 8，各数值表示如下：

value	output
0	Debug off
1	PFC ByHue strength
2	PFC ByY strength
3	PFC ByContrast strength
4	BLCC ByHue strength
5	BLCC ByY strength
6	BLCC ByContrast strength
7	PFC final strength
8	PFC/BLCC final strength

MaskSel ：对比区判断的Mask大小选择。值域0 ~ 2，Mask 0范围较小，Mask 2范围较大。

UStrength ： PFC/BLCC作用在U channel的强度。值域0 ~ 255，值越大越强。

VStrength ： PFC/BLCC作用在V channel的强度。值域0 ~ 255，值越大越强。

UStrengthLimit ： PFC/BLCC作用在U channel的强度上限。值域0 ~ 63。

VStrengthLimit ： PFC/BLCC作用在V channel的强度上限。值域0 ~ 63。

PFCByY ：紫边 (Purple Fringing) 通常出现在较暗的地方，且周围是高亮区域，所以可针对不同亮度，给予不同PFC的强度，横轴越右边代表亮度越大。值域0 ~ 4095，值越大越强。

PFCByHue ：根据不同的Hue，给予不同强度的PFC处理。值域0 ~ 255，值越大PFC越强。

PFCByContrast ：针对对比的程度，给予不同强度的PFC，横轴越右边代表对比越强。值域0 ~ 511，值越大PFC越强。

BLCCByY ：背光颜色 (Backlit Color) 通常出现在较暗的地方，且周围是高亮区域，所以可针对不同亮度，给予不同BLCC的强度，横轴越右边代表亮度越大。值域0 ~ 4095，值越大越强。

BLCCByHue ：根据不同的Hue，给予不同强度的BLCC处理。值域0 ~ 255，值越大BLCC越强。

BLCCByContrast ：针对对比的程度，给予不同强度的BLCC，横轴越右边代表对比越强。值域0 ~ 511，值越大BLCC越强。

ByYSft ： PFCByY/BLCCByY的横轴节点，以二的幂次方累加，值域范围：1 ~ 15。

ByContrastSft ： PFCByContrast/BLCCByContrast的横轴节点，以二的幂次方累加，值域范围：1 ~ 11。

Hue颜色表示

ByHue各index颜色分布

调整步骤

依据镜头表现，观察紫边的宽度，选择MaskSel的大小，若紫边较宽，可先选用较大的mask做补偿。
观察紫边所处的颜色分布、亮度区域、对比程度，来调整PFCByHue、PFCByY，以及PFCByContrast。
观察背光颜色所处的颜色分布、亮度区域、对比程度，来调整BLCCByHue、BLCCByY，以及BLCCByContrast。
调整最终PFC强度，如有特别颜色需求，可分开调整Ustrength、Vstrength的强度。

DEMOSAIC¶

现象

增加画面分辨率的同时减少方向误判与artifacts的产生。

物体边缘出现的artifacts现象

高频区方向判断错误

调整界面

于左侧选单点选BayerCompensation，接着在右侧主画面可找到DeMosaic接口。

DeMosaic调整界面

参数说明

DbgMode : Debug模式，值域范围：0 ~ 2，1代表方向判断影像，红/蓝/绿/黑色区域分别对应到垂直/水平/细节区域/无向性区域，2代表non-smooth影像，只有开启SmoEn才会有效果，影像越亮代表越不会被抹平，影像越黑代表越会被抹平。此debug模式和FalseColor的debug模式会有冲突，以最后呼叫的API为主。

Demosaic方向判断流程

GradientTh : 方向性区域判断阀值，值域范围：0 ~ 63，值越大则越少区域被判断成方向性区域，可能导致细节模糊和拉链状artifacts，值太小则会使细节区变少。

bDetailIntpEn : 辅助高频区域开关，值域范围：0 ~ 1。

u8BRatio : 辅助高频区域判断，值越大高频区域越有方向性，值域范围：0 ~ 15。

SmoEn : 抹平功能开关，值域范围：0 ~ 1。

SmoRange : 抹平范围，值域范围：0 ~ 7，值越大则越多区域被抹平。

SmoStrength : 抹平强度，值域范围：0 ~ 255，值越大则抹平的强度越强。

u8VarThX[8] : u8VarThY的亮度节点，以二的幂次方累加，值域范围：0 ~ 7，可以根据不同亮度区间改变可调整的范围大小。

u8VarThY[8] : 无向性区域判断阀值（IsoTh），值域范围：0 ~ 255，值越大则越多区域被判断成无向性区域，可能导致细节模糊和拉链状artifacts。

调整步骤

关闭抹平功能（SmoEn设0）。
将DbgMode设1，观察方向判断是否符合预期，再微调u8VarThY和GradientTh来区分无方向/有方向/细节区。
如有需求，再尝试开启抹平功能，抹平一些因为Demosaic造成差值错误的区域，可以同时将DbgMode设2，观察抹平区域和强度是否符合预期。

补充：

建议先使用默认值即可。若有调整需求，建议调整幅度不要太大，除非很确定适用于各种场景。

请不要将抹平功能当成NR，除非其他模块都调不动，再来微调此模块。

DynamicDP & NRDespike调整¶

如同前一节所说，peak noise基本上也算是一种特殊的noise，因此需要利用专门的功能去做消除或减弱的动作。建议在处理一般noise前先处理peak noise，这样可避免硬用其他denoise功能去处理peak noise而造成画质损失。有DynamicDP和NRSpikeNR两种功能可选择，可同时使用。

DynamicDP（Dynamic Defective Pixel Correction）¶

DPC处理peak noise的方式是将该点取代掉，因此效果较为明显。

受限于sensor的制造工艺，对于几百万像素的sensor，不可能做到所有的像素都是完好的，尤其是对于低成本的sensor来说，坏点数为100或者1000ppm（parts per million，百万分之一）是正常的。

若sensor中存在坏点，经过图像的插值（如demosaic）和滤波过程，坏点的尺寸会变大（坏点扩散），而且由于色彩校正和串扰补偿，坏点处颜色的强度和饱和度也会明显提高，因此需要在插值等过程之前对坏点进行校正。

调整界面

于左侧选单点选BayerCompensation，接着在右侧主画面可找到DynamicDP接口。

DynamicDP调整界面

参数说明

HotPixEn ：去除亮坏点开关。

HotPixCompSlope ：判断是否为亮peak点的阀值，值域0 ~ 255，越大越不容易判断为亮peak点，越小越容易。

DarkPixEn ：去除暗坏点开关。

DarkPixCompSlope ：判断是否为暗peak点的阀值，值域0 ~ 255，越大越不容易判断为暗peak点，越小越容易。

DPCTH ：本身与周围同通道的threshold，值域0 ~ 255，越大越不容易，越小越容易。

BlendEn ： blending开关。

DiffLut ：依据DPC的结果和原始值的差异程度来做blending，值域0 ~ 1024，越大越容易取代。

YLut ：依据亮度程度来做blending，值域0 ~ 1024，越大越容易取代。

调整步骤

先判断要开启HotPix或DarkPix。
DPCTH是判断与同通道的差异，与PixCompSlope需同时成立才会进行坏点补偿
慢慢增加PixCompSlope至peak noise与细节保留都可接受时停止，完成调整。
开启BlendEn，再依照想混合的程度调整DiffLut和YLut，以挽救细节。

DynamicDP Cluster¶

DynamicDP会依照该点与周围点差异来判断是否为defect，DynamicDP cluster会考虑周围的点也刚好是defect的情况，先将周围的最亮（暗）点排除一些，然后再进入DynamicDP模块去处理。

调整界面

于左侧选单点选BayerCompensation，接着在右侧主画面可找到DynamicDP_Cluster接口。

DynamicDP_Cluster调整界面

参数说明

EdgeMode ： Edge mode开关，对周围点换掉0~1点最亮点或最暗点。

NeiDeltaTh ：周围8点与此8点平均值的差异阀值，会累计差异大于此阀值的各数（count）。

NeiSmooth ：累计阀值，count小于此阀值会将最亮（暗）点做取代。

SortEn ： Sort mode总开关，将周围点做排序，希望取出最亮（暗）点符合以下条件，最亮（暗）点与次亮（暗）点的差异够大，且次亮（暗）点与第三亮（暗）点的差异够小，代表意思为周围只有一个点很亮（暗），其他点都很相似，所以替换掉该点。最多补偿个数为，周围点换掉0_{2点最亮点和0}1点最暗点。

SortRGGBEn ： Sort mode各自channel开关，可以指定特定channel做或是不做坏点替换。

Sort1x3ModeEn ： 1x3 mode开关。若与中心相邻两点为最亮点和次亮点，且次亮点和第三亮点差异大于SortLumaTblL，会将最亮两点用第三亮点取代。

SortLumaTblL ：最亮点和次亮点阀值，可根据亮度调整，大于此值则取代。值设越大，最亮点需超过次亮点越多，才可能把最亮点替换掉，代表判断条件越严格。

SortLumaTblD ：最暗点和次暗点阀值，可根据亮度调整，大于此值则取代。值设越大，最暗点需超过次暗点越多，才可能把最暗点替换掉，代表判断条件越严格。

SortLumaTblS ：次亮（暗）点和第三亮（暗）点阀值，可根据亮度调整，小于此值则取代。值设越小，次亮点与第三亮点需越相似，才可能把最亮（暗）点替换掉，代表判断条件越严格。

调整步骤

若原有DynamicDP补不掉的defect，可以尝试开启EdgeMode或SortEn，开得越多，越容易补defect，但也更容易破坏细节。
建议Cluster可以开较宽松，即将抓出多数defect，再依照defect程度做blending。

NRDeSpike¶

NRDeSpike处理peak noise的方式是将该点与邻近点的mean/median拉近，因此只能降弱，无法完全消除。

调整界面

于左侧选单点选BayerDenoise，接着在右侧主画面可找到NRDeSpike接口。

NRDeSpike调整界面

参数说明

NRDeSpike同时用三种方式判断depeak的强度，取最弱的来当最终的强度。

< CenterNeighbor >

Strength ： CenterNeighbor方式的强度，值域0 ~ 5，越大越强。

DiffGain ： CenterNeighbor方式的Threshold，超过此值depeak强度会设最强，值域0 ~ 255，越小越容易使用最强的depeak强度。

CenterNeighbor参数示意图

< CornerCross >

Strength ： CornerCross方式的强度，值域0 ~ 5，越大越强。

DiffThd ： CornerCross方式的Threshold，小于此值depeak强度会设最强，值域0 ~ 255，越大越容易使用最强的depeak强度。

CornerCross参数示意图

< MeanStd >

Strength ： MeanStd方式的强度，值域0 ~ 5，越大越强。

DiffGain ： MeanStd方式判断条件中的一个gain值，值域0 ~ 31，越大越容易使该pixel使用最强的depeak强度。

MeanStd参数示意图

BlendRatio ：总强度设定，值域0 ~ 15，越大会让peak越不明显。

BlendLut ：选用median/mean的混合比例，值域0 ~ 2047，横轴为中心与周为差异程度，越右边差异越大，纵轴为混合比例，值越大，偏向median设定，值越小，偏向mean设定。

StrengthByY ：根据不同亮度，给予不同强度，值域0 ~ 127，64为不调整，值越小越弱，越大越强。

调整步骤

由于是拿三种方法强度最弱的来用，单独调整某个参数不见得可以看到效果，建议依照下面介绍的方式将各方式调到最好状态。

为了方便观察，先将BlendRatio设15。
找出各方法的最佳参数，调整某个方法时要将另外两个强度设到最强。

< 以调整CenterNeighbor为例 >

将CornerCross及MeanStd开到最强

Strength.CornerCross = 5

DiffThd.CornerCross = 255

Strength.MeanStd = 5

DiffGain.MeanStd = 31
将Strength.CenterNeighbor设0，DiffGain.CenterNeighbor由255慢慢下降，直到peak noise与细节维持达到可接受程度即停止。
调整好的参数另外记下来。
参考步骤2，将剩下两种方式调整好，之后将各自的最佳参数填回界面。
将BlendRatio慢慢下降至peak noise与细节可接受程度即完成调整。
由于Spike与DPC共享source input，所以坏点可能会混入spike的补偿结果上，此时可调整BlendLut，让spike结果偏向median的结果，来避掉坏点。若此问题不会发生，也可偏向mean结果来取得较平滑的结果。

NR3D、NRLuma_Adv & NRChroma调整¶

NR3D的功能强大，除了降低temporal noise之外，还能提供静态或动态区域的信息给NRLuma_Adv做为参考，因此建议先从NR3D调起。

NR3D ON¶

主要用来降低temporal noise，包含Y & color noise，开强可以有效降低噪声，但side effect就是会出现残影，因此调整方向就是找出一个noise与残影都可接受的平衡点。

调整界面

于左侧选单点选Denoise_3DNR，接着在右侧主画面可找到NR3D接口。

NR3D调整界面

参数说明

DbgEn ：Debug模式，值域0 ~ 1。影像颜色越黑则代表越被判断成动区。

< Spatial Domain Denoise、SF系列参数 >

这边的控制，请参考NRLuma_Adv、NRChroma_Adv、NRChroma_Pre

< Temporal Domain Denoise、MD、TF系列参数 >

TF.StrY ：控制消除Y noise的temporal denoise 强度，值域0 ~ 127，值越大denoise强度越强，建议不要设超过64，超过64移动物体容易产生拖影。

TF.StrC ：控制消除color noise的temporal denoise 强度，值域0 ~ 127，值越大denoise强度越强，建议不要设超过16，超过16移动物体容易产生颜色拖曳。

MD.Thd ： motion阀值控制，值域0 ~ 255。值越大NR3D越强，Motion低于阀值的地方将被判断为静止。

MD.Gain ： motion scale控制，值域0 ~ 10230。值越大motion information越小，NR3D越强。

MotEdgeRefineStr ：抑制移动物体前缘被判定为动态区的强度。值域0 ~ 1023，越大移动物体前缘越不容易被判定为动态区，但须同时注意避免造成严重拖影。

MD.ThdByY ： motion阀值根据亮度控制，值域0 ~ 255。值越大NR3D越强。

MD.GainByY ： motion scale根据亮度控制，值域0 ~ 255。值越大motion information越小，NR3D越强。可针对特定noise较强的亮度作加强，或对拖影有疑虑的亮度作减弱。

MD.ThdByMot ： motion阀值根据motion控制，值域0 ~ 63。值越大NR3D越强。

MD.GainByMot ： motion scale根据motion控制，值域0 ~ 48。值越大motion information越小，NR3D越强。

M2S.LUT ：动态区转静态区NR3D强度控制，横轴为动到静，值域0 ~ 4095。值越小NR3D越弱，NR3D收敛越慢。建议动到静曲线变化不要太陡，否则移动物体和静止区中间过渡区会不自然。

TF.LUT ：主要利用difference与motion信息来决定temporal denoise的强度，difference与motion小很有机会是静态区，反之则很有机会是动态区。Temporal denoise强度共有0 ~ 15共16阶，此TF.LUT值由左至右分别控制强度14 ~ 0的x轴坐标，因此table里面的值会是递增的，值域0 ~ 255，默认值：{24, 25, 26, 27, 28, 30, 32, 33, 36, 38, 42, 46, 51, 59, 73}。

TF.LUT

< Denoise by motion系列参数 >

MotShpBlendLut ：根据motion信息调整混和sharpness branch的权重，值域0 ~ 64。由左至右代表动到静，值越大混合权重越大，用来降低动态区域的shrapness强度。注意shrapness branch的实际shrapness强度需以Sharpness API中的BranchStrength控制。

MotHistDelayByDiff ： Motion信息延迟时间，值域范围：0 ~ 7。横轴为当前帧和前一帧的motion信息差异，纵轴为motion信息往后级传的额外延迟时间，值越大则延迟越久，希望静态的motion信息有延迟，让运动过后的区域的motion信息持续久一些，在3DNR还未收敛前，让后级的2DNR能保持在较强的强度（动区通常强度较强）久一些。

ShdMotSensitivity ：针对移动阴影区域的motion敏感度，越大代表对motion侦测越敏感，2DNR较强，3DNR较弱，越小代表对motion侦测越不敏感，2DNR较弱，3DNR较强。

调整步骤

首先针对静止画面调整NR3D强度，降低画面noise跳动的程度。
- 调整NR3D强度，目标是让画面整体看起来安定。建议TF.Str设63，将MD.Gain增加至画面变安定即停止。若MD.Gain需要设很大才能让画面安定，可以适时增加MD.Thd，但建议不要超过10。
接着针对物体移动过后区域NR3D强度变化做调整。
- 主要调整M2S.LUT。M2S.LUT曲线不要设太陡，否则物体移动过后区域由糊到清楚的转换边界会很明显且不自然。
- 可以基于建议值来做微调，如果比较不希望看见残影则需要设小一点的值，此时物体移动过后区域的NR3D越弱，看起来比较扰动；相反的如果希望物体移动后区域清楚一些，能接受一些残影，则将值设大一些，扰动会比较小但可能会有颗粒noise跑出来。
- 建议值：{0, 2048, 2731, 3072, 3277, 3413, 3511, 3584, 3686, 3803, 3910, 3988, 4020, 4048, 4061, 4069}
微调动区sharpness与noise程度的平衡。
- 调整MotShpBlendLut，由左至右代表动态区到静态区域。将值慢慢加大至动区shrapness与noise程度都能接受的程度。建议同时搭配Sharpness的BranchStrength与BranchGainByStd做调整。
针对拖影严重的亮度，可利用MD.GainByY做微调。将对应亮度区域的值慢慢下降至拖影与noise都可接受的程度。
当gain越来越高，移动noise若都只靠MotShpBlendLut是不够的，此时可以修改TF.LUT，让曲线下降得更缓慢一些来增加移动区域NR3D的强度，但同时也须考虑拖影变严重的程度。

NR3D OFF¶

由于有些IC为了节省成本没有DRAM，因此没有NR3D只能使用其他denoise，以下为建议调整方式。

调整界面

同NR3D ON调整界面。

参数说明

同NR3D ON参数说明。

调整步骤

确认Iqfile是使用3dnr off的版本，系统NRLevel设置应为0，Despike调整方法与3DNR on相同。若还有需求，可以再调整剩下的denosie，调整方法与3DNR on相同。若无法处理太扰动的noise建议可以降弱Sharpness，且善用NRLuma_Adv的debug map，利用EdgeTHByLuma将平坦区域与细节及明显边界区域分开来，在平坦区域用较强的SF2，可以得到较好的noise表现。需注意：因3DNR被设置为关闭，此时ISP无法提供画面的motion信息，其他模块中有用到byMotion机制的参数，皆会使用index 1（最动），在调整上需注意。

NRLuma_Adv¶

NRLuma_Adv主要用来降低spatial noise，透过调整NRLuma_Adv中< Edge区域划分参数 >，能将画面分为平坦区以及Edge区域，再透过< NR Strength相关参数 >来各别调整平坦区以及Edge区域的denoise强度，其中< Edge区域划分参数 >以及< NR Strength相关参数 >，皆可针对动静区域再做进一步的调控。

调整界面

于左侧选单点选Denoise_YNR，接着在右侧主画面可找到NRLuma_Adv接口

NRLuma_Adv调整界面

参数说明

< Edge区域划分参数 >

DbgMode ： Debug模式，值域范围：0 ~ 2，1为edge判断的模式，影像越亮代表越被判断成edge区，影像越暗则代表越被判断成non-edge区，这边只做Luma处理，影像颜色没有意义。2为defect detection的模式，可以观察白点defect出现的地方。

HotPixCnt ：亮点补偿个数，值域范围：0 ~ 7，决定需要补偿的坏点（亮点）数，值越大需要补偿的坏点（亮点）越多，NR强度越强，建议值为1。

DarkPixCnt ：暗点补偿个数，值域范围：0 ~ 7，决定需要补偿的坏点（暗点）数，值越大需要补偿的坏点（暗点）越多，NR强度越强，建议值为1。

HotPix ：亮点补偿阀值，值域范围：0 ~ 255，四个值决定阀值曲线（亮点的程度）。当前像素与周围像素点差值小于第一个阀值则不为坏点，而差值大于第四个阀值时就会判定为坏点（亮点），使用较强的Noise reduction，中间两个阀值则是作为要混合多少Noise reduction的依据。

DarkPix ：暗点补偿阀值，值域范围：0 ~ 255，四个值决定阀值曲线，当前像素与周围像素点差值小于第一个阀值则不为坏点，而差值大于第四个阀值时就会判定为坏点（暗点），使用较强的Noise reduction，中间两个阀值则是作为要混合多少Noise reduction的依据。。

EdegThByLuma ：根据亮度调节Edge阀值，值域范围：0 ~ 8191，横轴为亮度，越右边越偏亮。可以搭配DbgMode调整，观察edge分布是否合理。

LumaSft ： EdegThByLuma的亮度节点，值域范围：0 ~ 8，可以根据不同亮度区间改变可调整的范围大小。

EdegThByMot ：根据motion调节L1 Edge阀值，值域范围：0 ~ 255，横轴为motion程度，越右边越静。小于L1 Edge阀值的部分将被划分为平坦区域，可以搭配DbgMode调整，观察edge分布是否合理。

EdegThByMot1 ：根据motion调节L2 Edge阀值，值域范围：0 ~ 255，横轴为motion程度，越右边越静。大于L1 Edge+L2 Edge阀值的部分将被划分为Edge区域，可以搭配DbgMode调整，观察edge分布是否合理。

EdgeThByRadius_Sft ：调整EdgeThByRadius与中心点距离的尺度大小，值域范围：0 ~ 7，可以根据不同距离区间调整尺度大小。

EdgeThByRadius ：根据与中心点距离调节Edge阀值，值域范围：0 ~ 255，横轴为与中心点的距离大小，越右边离中心点越远。

< NR Strength参数 >

SF1_Str ： edge区的NR强度，值域范围：0 ~ 127，可以按照Debug模式来观察何处edge区来调整NR大小。

SF2_Str ：平坦或是移动区域的NR强度，值域范围：0 ~ 127，可以按照Debug模式来观察何处是平坦或是动区来调整NR大小。

SF3_KerStr ：有方向性的去躁参数，与中心点差异的横移量，值域范围：0 ~ 9，值越大则去躁效果越强。

SF3_KerWei ：有方向性的去躁参数，混合权重表，值域范围：0 ~ 63，横轴为与中心点的差异，越右边差异越大；纵轴为权重，正常情况下，差异越小则权重设越大。

SF3_StrByLuma ：有方向性的去躁参数，依据亮度调整强度，值域范围：0 ~ 127，横轴为亮度，越右边越偏亮。

SF3_StrByMot ：有方向性的去躁参数，依据motion去混合mean filter的结果，值域范围：0 ~ 127，横轴为motion，越右边越偏静，纵轴为混合mean filter结果的比例，由于mean filter过强，因此不建议设太大。

SF3_StrByHue ：有方向性的去躁参数，依据hue调整强度，值域范围：0 ~ 127，横轴为hue（同HSV）。

SF3_StrByHue_SatTh1 ：有方向性的去躁参数，依据saturation调整强度，值域范围：0 ~ 127，当saturation小于SF3_StrByHue_SatTh1，则SF3_StrByHue失效，也就是强度的调整不受到饱和度太低的hue影响，当saturation大于SF3_StrByHue_SatTh2，则完全依照SF3_StrByHue调整强度，过度区则线性变化。

SF3_StrByHue_SatTh2 ：有方向性的去躁参数，依据saturation调整强度，值域范围：0 ~ 127，当saturation小于SF3_StrByHue_SatTh1，则StrengthByHue失效，也就是强度的调整不受到饱和度太低的hue影响，当saturation大于SF3_StrByHue_SatTh2，则完全依照SF3_StrByHue调整强度，过度区则线性变化。

SF3_StrByDir_Sft ：调整SF3_StrByDir边缘状态（edge state）的尺度大小，值域范围：0 ~ 7。

SF3_StrByDir ：有方向性的去躁参数，依据边缘状态（edge state）调整强度，值域范围：0 ~ 127。

SF4_KerStr ：无方向性的去躁参数，与中心点差异的横移量，值域范围：0 ~ 9，值越大则去躁效果越强。

SF4_KerWei ：无方向性的去躁参数，混合权重表，值域范围：0 ~ 63，横轴为与中心点的差异，越右边差异越大；纵轴为权重，正常情况下，差异越小则权重设越大。

SF4_StrByLuma ：无方向性的去躁参数，依据亮度调整强度，值域范围：0 ~ 127，横轴为亮度，越右边越偏亮。

SF4_StrByMot ：无方向性的去躁参数，依据motion去混合mean filter的结果，值域范围：0 ~ 127，横轴为motion，越右边越偏静，纵轴为混合mean filter结果的比例，由于mean filter过强，因此不建议设太大。

Strength ：整体强度，值域范围：0 ~ 256，Strength1为edge区的强度，Strength2为平坦与移动区的强度，值越大则NR越强。最终强度是以Strength为基础，再加上StrengthByMot和StrengthByLuma的控制，因此建议不要将Strength设到最强，否则StrengthByMot和StrengthByLuma就失效了。

StrengthByMot ：依据motion调整强度，值域范围：0 ~ 64，横轴为motion，越右边越偏静。

StrengthByLuma ：依据亮度调整强度，值域范围：0 ~ 64，横轴为亮度，越右边越亮。

CombinationRatio ：weak-edge区（DbgMode灰色）使用无方向性和有方向性的去躁参数混合比例，值越大有方向性的去躁参数比例越多，值越小无方向性的去躁参数比例越多，值域范围：0 ~ 255。

调整步骤

先将DbgMode设为1，调整EdgeTh相关的参数来区分edge区和non-edge区。
将Strength（Strength1、Strength2）调到最大，并将SF4的参数调到最弱。
调整SF1_str与SF2_str的强度是否可以符合预期。
调整SF3 by y/mot，如果觉得强度不符合预期可以再调（SF3_Kerstr、SF3_KerWei）。
若仍有无法消除的躁点或是有方向性的纹路可以将SF4打开。
调整SF4 by mot，如果觉得强度不符合预期可以在调（SF3_Kerstr、SF3_KerWei）。
如果有针对特殊需求可以在调整SF3_StrByHue、SF3_StrByRadius。
将DbgMode设为2，观察坏点位置，来调整defect detection参数（HotPixCnt、DarkPixCnt、HotPix、DarkPix）。
调整整体强度，可以针对亮度与motion去做混和。
开关NRLuma_Adv来确认前后效果差异，而后继续调sharpness或是其他NR的参数。

NRChroma_Adv¶

压抑画面中颜色的噪声。

调整界面

于左侧选单点选Denoise_CNR，接着在右侧主画面可找到NRChroma_Adv接口。

NRChroma_Adv调整界面

参数说明

StrengthByY ：针对不同亮度，给予不同NR强度的控制，横轴越右边代表亮度越大。值域0 ~ 255，值越大越强。

StrengthByYEdge ：使用Luma来侦测Edge程度，针对不同Edge，给予不同NR强度的控制，横轴越右边代表Edge越大。值域0 ~ 63，值越大越强。

StrengthByCEdge ：使用Chroma来侦测Edge程度，针对不同Edge，给予不同NR强度的控制，横轴越右边代表Edge越大。值域0 ~ 255，值越大越强。

MaxStrength ：控制Y/C差异小的区域，NR的强度。值域0 ~ 255，值越大越强。

StrengthByMot ：依据motion调整NR的强度，横轴为motion，越右边越偏静。值域0 ~ 63，值越大越强。

MotionClip ：针对移动区域，给予更多NR强度。值域0 ~ 255，值越大越强。

MotionColorReduce ：针对移动区域，可降低饱和度。值域0 ~ 255，值越大饱和度降越多。

MotionColorRecover ：针对移动区域，可根据MotionColorReduce所降低的饱和度，再把gain乘回来。值域0 ~ 255，值越大饱和度回复越多。

PreStrength ：针对Chroma先做简单的去躁处理。值域0 ~ 128，值越大越强。

调整步骤

MotionClip先设定为0。
观察静态区，调整MaxStrength和StrengthByMot，将NR调整到一个可接受的色躁范围。
观察动态区，调整MotionClip，将移动的部分，基于步骤一的NR强度，做加强的动作，若调整MotionClip程度不够强，可回去步骤一做强度的加强。
如有需要，可调整MotionColorReduce，针对移动的部分，做饱和度的压抑，这个动作可帮忙NRChroma_Adv更容易的移除色躁。若不希望影像看到移动区的饱和有下降，可调整MotionColorRecover将移动区的饱和再拉回来。

NRChroma_Pre¶

压抑画面中颜色的噪声。

调整界面

于左侧选单点选Denoise_CNR，接着在右侧主画面可找到NRChroma_Pre接口。

NRChroma_Pre调整界面

参数说明

DbgEn ： Debug模式，值域范围：0 ~ 1，使用前务必将Strength设为最大值256，影像的U/V信道值越小代表越使用mean filter结果，U/V通道值越大代表越使用median filter结果。

Strength ：整体强度，值域范围：0 ~ 256，值越大则NR效果越强。

MotionEnhance ：动态区域加强程度，值域范围：0 ~ 127，第一格为Y信道加强幅度，第二格为U/V信道加强幅度，值越大则动态区域NR效果越强。

MaskGenTh ： U/V通道阀值，用于产生mask，并在此mask内做NR，值域范围：0 ~ 1023，值越大则mask越大，NR效果越强。

MeanFilterTh ： Y/U/V通道阀值，用于控制mean filter强度，值域范围：0 ~ 1023，第一格为Y通道阀值，第二格为U/V通道阀值，只有当mask内的差值小于此阀值才会被纳入做mean filter，值越大则NR效果越强。

MedianFilterTh ： Y/U/V通道阀值，用于控制median filter强度，值域范围：0 ~ 1023，第一格为Y通道阀值，第二格为U/V通道阀值，只有当mask内的差值小于此阀值才会被纳入做median filter，值越大则NR效果越强。

BlendTh ：混合阀值，值域范围：0 ~ 1023，当mask内的U/V通道最大差值小于BlendTh，则使用mean filter的结果，值越大则越偏向使用mean filter的结果。

BlendGap ：混合区间，值域范围：0 ~ 15，当mask内的U/V通道最大差值大于BlendTh+2^BlendGap，则使用median filter的结果，值越大则越偏向使用mean filter的结果。

调整步骤

将Strength设最大。
将BlendTh设1023，观察mean filter的效果，如有需求再调整MeanFilterTh和MaskGenTh。
将BlendTh和BlendGap都设0，观察median filter的效果，如有需求再调整MedianFilterTh和MaskGenTh。
调整BlendTh和BlendGap，适当分配mean filter和median filter范围，可搭配Debug模式以方便观察。
观察动态区色噪，再微调MotionEnhance。
调整Strength，减轻色溢。

Sharpness调整¶

调整锐化强度调整，例如不同亮度的锐化强度，黑边白边的锐化强度，动静态的锐化强度等等。SOUFFLE一共有两个Sharpness调整模块，分别为Sharpness以及SharpnessEX。

Sharpness流程图

SharpnessEX流程图

Sharpness¶

调整界面

于左侧选单点选Sharpness，接着在右侧主画面可找到Sharpness & SharpnessEx接口。

Sharpness调整界面

Sharpness_EX调整界面

参数说明

< Sharpness >

DbgEn ：Debug模式，值域范围：0 ~ 1。灰色代表没上edge，白/黑色分别代表白/黑边。

SharpnessUD ：无向性edge的强度，用于提高发丝和草地等细小纹理清晰度，值域范围：0 ~ 127。横轴依序为高频/中频/中低频，纵轴为无向性edge的强度增益，值越大则edge越强。

SharpnessD ：方向性edge的强度，用于增强图像边缘，但调的太强会导致锯齿状，值域范围：0 ~ 127。横轴依序为高频/中频/中低频，纵轴为方向性edge的强度增益，值越大则edge越强。

[名词解释] Edge state ：算法会估算出每个像素边缘状态的分数，来判断单纯边缘区和复杂区，值越小则越偏向单纯边缘区，使用者可以透过更改StateByGain及StateByOffset来调整算法估算出的Edge State。StateByGain及StateByOffset参数中都各有Filter0及Filter1两组调整分数的机制，调整后的分数用途略有不同。

Filter0：用于区分有向及无向性的边缘（StateByGain越大越偏向DratioByState的左边，StateByOffset越大越偏向DratioByState的右边）。

Filter1：用于区分单纯边缘区和复杂区，作为D/UDWeibyState中Static[0] Motion[0]及Static[1] Motion[1] Blending的依据（StateByGain越大越偏向使用Static[1] Motion [1]，StateByOffset越大越偏向使用Static[0] Motion [0]）。

StateByGain ：依据增益量调整滤波器得到边缘数值，增益量越小表示保留较多复杂区/平坦区，值域范围：0 ~ 31。

StateByOffset ：依据位移量调整滤波器得到边缘数值，位移量越大表示保留较多复杂区/平坦区，值域范围：0 ~ 255。

StdvByY ：依据亮度调整标准偏差的增益，值域范围：0 ~ 255。横轴为亮度，越右边越偏亮，纵轴为调整标准偏差的增益（64 = 1x），值越大则标准偏差越大。

StdvByMot ：依据motion调整标准偏差的增益，值域范围：0 ~ 63。横轴为motion，越右边越偏静，纵轴为调整标准偏差的增益（16 = 1x），值越大则标准偏差越大。

UDWeiByState ：依据state调整无向性边缘的中低频/中频/高频edge混合比例，值域范围：0 ~ 256。横轴由左至右依序为静态纹理细节区（Static[0]）、静态边缘区（Static[1]）、动态纹理细节区（Motion[0]）、动态边缘区（Motion[1]），纵轴为混合比例的权重数值，当权重值等于0时，则偏向中低频edge、当权重值等于256时，则偏向高频edge。

DWeiByState ：依据state调整方向性边缘的中低频/中频/高频edge混合比例，值域范围：0 ~ 256。横轴由左至右依序为静态纹理细节区（Static[0]）、静态边缘区（Static[1]）、动态纹理细节区（Motion[0]）、动态边缘区（Motion[1]），纵轴为混合比例的权重数值，当权重值等于0时，则偏向中低频edge、当权重值等于256时，则偏向高频edge。

UDWeiByMot ：依据motion调整无向性的频段，值域范围：0 ~ 256。横轴为motion由动至静，越右边越偏静，纵轴为调整频段权重，值越大则越偏向静态边缘频段

DWeiByMot ：依据motion调整方向性的频段，值域范围：0 ~ 256。横轴为motion由动至静，越右边越偏静，纵轴为调整频段权重，值越大则越偏向静态边缘频段。

UDGainByStd ：依据标准偏差调整无向性的增益，值域范围：0 ~ 255。横轴为经过StdvByY和StdvByMot处理过的标准偏差，越右边标准偏差越大，纵轴为edge增益（64 = 1x），值越大则edge越强。

DGainByStd ：依据标准偏差调整方向性的增益，值域范围：0 ~ 255。横轴为经过StdvByY和StdvByMot处理过的标准偏差，越右边标准偏差越大，纵轴为edge增益（64 = 1x），值越大则edge越强。

UDEdgeKillLutUp ：根据edge强度调整无向性白边的edge强度，值域范围：0 ~ 1023。横轴为输入edge，纵轴为输出edge，值越大则edge越强。

UDEdgeKillLutDown ：根据edge强度调整无向性黑边的edge强度，值域范围：0 ~ 1023。横轴为输入edge，纵轴为输出edge，值越大则edge越强。

DEdgeKillLutUp ：根据edge强度调整方向性白边的edge强度，值域范围：0 ~ 1023。横轴为输入edge，纵轴为输出edge，值越大则edge越强。

DEdgeKillLutDown ：根据edge强度调整方向性黑边的edge强度，值域范围：0 ~ 1023。横轴为输入edge，纵轴为输出edge，值越大则edge越强。

DRatioByState ：设定不同的Edge state要用多少无向性与方向性edge的混合比例表，值域范围：0 ~ 256。横轴为Edge state，越左边越偏单边缘区，越右边越偏复杂区/平坦区，纵轴为混合无向性与方向性edge，值越大则越偏向方向性edge。

EdgeGain ：整体增益调整，值域范围：0 ~ 1023。Edge增益（128 = 1x），值越大edge强度越强。

GainByStd ：依据标准偏差调整整体增益，值域范围：0 ~ 255。横轴为经过StdvByY和StdvByMot处理过的标准偏差，越右边标准偏差越大，纵轴为edge增益（64 = 1x），值越大则edge越强。通常平坦区的标准偏差较小，因此可以降低标准偏差小的区域的edge，让平坦区更平顺。也可以用来降低运动的edge，若将StdvByMot的前几格降低，则GainByStd就会查到前几格，使得运动区降低edge。总共有七个节点，如有需要改变横轴节点，可调整GainByStdSft。

GainByStdSft ：GainByStd的横轴节点，值域范围：0 ~ 15。有七个断点，横轴依序为0、2^{GainByStdSft[0]、2}GainByStdSft[0] + 2^{GainByStdSft[1]、2}GainByStdSft[0] + 2^GainByStdSft[1] + 2^GainByStdSft[2]、...等等，纵轴依序为GainByStd[0]、GainByStd[1]、GainByStd[2] ...等等。如需调整，建议用Excel画出原本的曲线，调整GainByStdSft将想要细调的区间切细后，找到对应的GainByStd，确认效果和先前一致后，再调整GainByStd。

CorByY ：依据亮度调整coring，值域范围：0 ~ 255。横轴为亮度，越右边越偏亮，纵轴为coring 值，值越大则edge越弱。

SclByY ：依据亮度调整edge增益，值域范围：0 ~ 255。横轴为亮度，越右边越偏亮，纵轴为edge增益（64 = 1x），值越大则edge越强。

GainByMot ：依据motion调整最终edge增益，值域范围：0 ~ 255。横轴为motion由动至静，越右边越偏静，纵轴为edge增益（128 = 1x），值越大则edge越强。

< Dering >

SOUFFLE新增Dering系列参数，当前像素要做边缘强化时，会考虑周遭像素的状况来加以限制Edge的输出，Edge的变化量只能比周遭第N亮/暗（DerRmNRCnt）的点拉升/降低多少，降低或拉升的量则可以根据不同亮度来设置。如下图所示，CurrentY为当前像素亮度值，Edge为经过边缘强化后的数值，UpBound（DerOver/UnderShootLimitByY）为限制加强的上/下界，而最终又可以透过GainByMot来根据动静区域来给定不同的限制，out edge为最终输出。

顺序：DerOver/UnderShootLimitByY -> DerOver/UnderShootGain -> DerGainByMot

Dering示意图

DerRmNRCnt ：排除与周遭像素差异第N暗的点（DerRmNRCnt[0]）、排除与周遭像素差异第N亮的点（DerRmNRCnt[1]）作为edge增强的参考亮度，值域范围：0 ~ 6。

DerOverShootGain ：白边的强度调整，值域范围：0 ~ 255。横轴为edge程度由左至右为平坦到边缘，纵轴为edge增益，值越大则白边强度越强。

DerUnderShootGain ：黑边的强度调整，值域范围：0 ~ 255。横轴为edge程度由左至右为平坦到边缘，纵轴为edge增益，值越大则黑边强度越强。

DerGainByMot ：根据motion调整edge强度，值域范围：0 ~ 255，横轴为motion，越右边越偏静，纵轴为edge强度（64 = 1x），值越大则edge越强。

DerOverShootLimitByY ：依据亮度调整白边的强度，值域范围：0 ~ 1023。横轴为亮度，越右边越偏亮，纵轴为edge强度，值越大代表保留较多白边强度。

DerUnderShootLimitByY ：依据亮度调整黑边的强度，值域范围：0 ~ 1023。横轴为亮度，越右边越偏亮，纵轴为edge强度，值越大代表保留较多黑边强度。

StrengthByHue ：根据hue调整edge强度，值域范围：0 ~ 255。横轴为hue（同HSV），纵轴为edge增益（64 = 1x），值越大则edge越强，实际效果受到StrengthBySat影响。

StrengthBySat ：根据saturation调整edge强度，值域范围：0 ~ 127。横轴为saturation，当saturation小于StrengthBySat[0]，则StrengthByHue失效，也就是edge强度的调整不受到饱和度太低的hue影响，当saturation大于StrengthBySat[1]，则完全依据StrengthByHue调整edge强度，过度区则线性变化。

BranchStrength ：输出Sharpness强度，用于3DNR – MotShpBlendLut，值域范围：0 ~ 255。Edge强度（64 = 1x），值越大则edge越强。

BranchGainByStd ：依据标准偏差调整增益，值域范围：0 ~ 255。横轴为经过StdvByY和StdvByMot处理过的标准偏差，越右边标准偏差越大，纵轴为Edge增益（128 = 1x），值越大则edge越强。

ROIEn ：ROI模式开关，值域范围：0 ~ 1。

ROIStr ：8个ROI的Sharpness强度，值域范围：0 ~ 255。

< Sharpness_EX >

DbgEn ：Debug模式，值域范围：0 ~ 1。灰色代表没上edge，白/黑色分别代表白/黑边。

Sharpness ：无向性edge的强度，用于提高发丝和草地等细小纹理清晰度，值域范围：0 ~ 127。横轴依序为高频/中频，纵轴为无向性edge的强度增益，值越大则edge越强。

StateByGain ：依据增益量调整滤波器得到边缘数值，增益量越小表示保留较多复杂区/平坦区，值域范围：0 ~ 31。横轴为滤波器得到边缘数值，数值越小判断成复杂区/平坦区、数值越大判断成单纯边缘区。

StateByOffset ：依据位移量调整滤波器得到边缘数值，位移量越大表示保留较多复杂区/平坦区，值域范围：0 ~ 255。横轴为滤波器得到边缘数值，数值越小判断成复杂区/平坦区、数值越大判断成单纯边缘区。

StdvByY ：依据亮度调整标准偏差的增益，值域范围：0 ~ 255。横轴为亮度，越右边越偏亮，纵轴为调整标准偏差的增益（64 = 1x），值越大则标准偏差越大。

StdvByMot ：依据motion调整标准偏差的增益，值域范围：0 ~ 63。横轴为motion，越右边越偏静，纵轴为调整标准偏差的增益（16 = 1x），值越大则标准偏差越大。

WeiByState ：依据state调整无向性边缘的中频/高频edge混合比例，值域范围：0 ~ 128。横轴由左至右依序为静态纹理细节区（Static[0]）、静态边缘区（Static[1]）、动态纹理细节区（Motion[0]）、动态边缘区（Motion[1]），纵轴为混合比例的权重数值，当权重值等于0时，则偏向中频edge、当权重值等于128时，则偏向高频edge。

WeiByMot ：依据motion调整无向性的权重，值域范围：0 ~ 256。横轴为motion由动至静，越右边越偏静，纵轴为调整无向性的权重，值越大则越偏向静态state。

EdgeGain ：整体增益调整，值域范围：0 ~ 1023。Edge增益（128 = 1x），值越大edge强度越强。

GainByStd ：依据标准偏差调整整体增益，值域范围：0 ~ 255。横轴为经过StdvByY和StdvByMot处理过的标准偏差，越右边标准偏差越大，纵轴为edge增益（64=1 x），值越大则edge越强。通常平坦区的标准偏差较小，因此可以降低标准偏差小的区域的edge，让平坦区更平顺。也可以用来降低运动的edge，若将StdvByMot的前几格降低，则GainByStd就会查到前几格，使得运动区降低edge。总共有七个节点，如有需要改变横轴节点，可调整GainByStdSft。