ISP PQ Tool User Guide
简介
概述
本文档主要介绍 SpacemiT 图像调试,包含调试工具(Tuning Tool)、定标插件(Calibration Plugins)、图像分析工具(VRF viewer),平台调试辅助等。
缩略语
Name | Description |
---|---|
ISP | Image Signal Process |
VRF / vrf | RAW image with information at the end |
BLC | Black Level Correction |
LSC | Lens Shading Correction |
AWB | Auto White Balance |
AEC | Auto Exposure Control |
AF | Auto Focus |
OTP | One Time Programmable |
AEM | Auto Exposure Monitor |
AFM | Auto Focus Monitor |
CCM | Color Correction Matrix |
CT | Color Temperature |
BPC | Bad Pixel Correction |
CAC | Color Aberration Correction |
LTM | Local Tone Mapping |
PDC | Phase Detection Compensation |
Phase Detection Correction | |
PDAF | Phase Detection Auto Focus |
SE | Special Effect |
EIS | Electronic Image Stabilization |
CDAF | Contrast Detection Auto Focus |
FV | Focus Value |
SAD | Sum of absolute difference |
ROI | Region of Interest |
NR | Noise Reduction |
EE | Edge Enhancement |
HDR | High Dynamic Range |
Qn | Accuracy, 2n is double |
Tuning Tool 概述
Tuning Tool 框架

Figure - ISP Tool 框架
PC 端 tuning tool 安装
调试软件是免安装的压缩文件,解压即可使用,文件名 AsrIspToolVX.X.X.X.rar
解压后包含如下文件:

Figure - ISP Tool 文件
调试环境准备
软硬件需求
-
硬件环境
- 台式电脑或笔记本电脑
- 1GHz 或更快的处理器
- 1GB RAM(32 位) 2GB RAM(64 位)
- 至少 10GB 可用硬盘空间
- 1920 x 1080 屏幕分辨率或更高
- USB 端口
- 集成了 ASR ISP 的终端设备
-
软件环境
- Windows 7 64 位或以上版本的操作系统
设备连接
AsrIspTool 通过 USB 与终端设备连接,通过 ADB 与设备交互。
【注:连接之前设备需先启动 tuning server 线程,即启动 camera】
Tuning Tool 基本操作
Tuning Tool 主界面
双击 AsrIspTool.exe ,启动调试工具,主界面如 Figure 3.1-1 所示

Figure - ISP Tool 主界面
-
menu:菜单功能区
- Open:打开参数文件
- Save:保存参数文件
- SaveAS:参数文件另存为
- IP Address:reserved
- ADB(SN):ADB 方式连接终端设备,支持输入 ADB serial
- Connect:连接终端设备
- Vied:单/水平叠加/垂直叠加 窗口显示
- Format:十进制/十六进制显示切换
- Display:矩阵编辑/行编辑/列编辑模式切换
- Plugins:插件
- Frequency:参数刷新速度调节
- Capture:抓取 VRF 数据(vrf)
- Register:ISP 寄存器读写工具
- I2C:I2C 读写工具
- Push: reserved
- Transfer: reserved
- VRF:看图 工具
- DNG:reserved
-
Module list & Filter list:模块列表
-
parameter list:参数列表
-
Log:日志区
Online 基本操作
连接终端设备
打开 tool 之后,在选择 ADB(SN),点击 Connect,连接成功会自动读取当前所有模块的参数,并以 500ms(功能菜单可修改 Frequency)为周期定时刷新只读参数。(多台终端与 PC 相连,可指定 serial)
如果想将可读写参数也定时刷新,将右上角 AutoUpdate 勾选即可(勾选之后参数不可设置)。
如果想单次读取所有参数,点击右上角 Read 按钮。

Figure - ISP Tool 连接界面
注意:ADB 连接方式只适用于使用 Android 系统的项目,我们主要使用 TCP 网络连接开发板进行 tunning。
参数类型说明

Figure - 参数说明
-
可调参数
- 可勾选参数,如 m_bAutoCalculateAEMWindow
- 可编辑参数,如 m_nPreEndingPercentage
- 可编辑数组参数,如 m_pSubROIPermil,若为二维数组,可切换矩阵/行/列编辑模式
-
只读(灰色)
- 只读,如 m_nAdjacentLumaSAD
-
特别说明
- 在插件或参数列表中修改参数,会标红显示修改的内容,鼠标覆盖时会显示原值。
实时修改参数
- 在模块列表区展开想要调试的模块列表
- 在模块列表区点击想要修改的模块
- 在参数列表区通过滑动条或者直接修改参数值,参数即时生效。
抓取 VRF 图
- 在菜单功能区点击 Capture 按钮
- 选择 RAW,设置保存路径
- 点击 Start Capturing 可生成后缀为 vrf 的原始图像
Register 读写

Figure - Register 读写
-
在菜单功能区点击 Register 按钮
-
设置 Address(寄存器地址)
-
Value(8bit)(寄存器值)
- Read 读寄存器
- Write 写寄存器
-
Value(32bit)(寄存器值)
- Read 读寄存器
- Write 写寄存器
I2C 读写

Figure - I2C 读写
-
在菜单功能区点击 I2C 按钮
-
设置 Device ID (I2C 设备号)
-
设置 Device Address (从设备地址)
-
设置 Address Bytes(寄存器地址位宽)
-
设置 Register Address(寄存器地址)
-
设置 Value Bytes(寄存器值位宽)
-
Value(寄存器值)
- Read 读寄存器 / Batch Read 文件导入批量读寄存器
- Write 写寄存器 / Batch Write 文件导入批量写寄存器批量读写寄存器文件格式如下,
{Address, Value }
, 批量读写寄存器点击 Batch Read / Batch Write 导入 reg_batch.txt。读取结果会在红色框中显示对应 log,同时会生成同名_read.txt 用于后续查看。
批量读写寄存器文件格式示例

Figure - I2C 批量读
保存参数
- 在菜单功能区点击 Save 按钮
- 选择路径并设置文件名
- 点击保存生成参数文件
打开本地参数文件
在菜单功能区点击 Open 按钮或者直接拖曳对应参数文件到工具对应模块中,该操作将把参数直接写入硬件;
Offline 基本操作
打开本地参数文件
- 在菜单功能区点击 Open 按钮或者直接拖曳参数文件到工具中;
修改参数
- 在模块列表区展开想要调试的模块列表;
- 在模块列表区点击想要修改的模块;
- 在参数列表区通过滑动条或者直接修改参数值;
- 如果是一维向量,在参数编辑界面点击波形按钮可进入曲线编辑模式;
定标插件
- 在菜单功能区点击 Plugins 下拉菜单选择插件;
保存参数
- 在菜单功能区点击 Save 按钮,输入文件名,参数将保存至本地文件;
ISP 插件
本节介 绍 BLC、LSC、AWB、CCM、Curve、Noise、PDC、PDAF 定标调试,以及调试辅助工具 General Information、Raw preprocessor。
标定插件支持 online(连接设备)与 offline(导入参数文件),只有打开对应 Filter 参数时,插件才能打开。
BLC 定标与调试
BLC 定标 VRF 图要求
在全黑环境或将镜头完全遮挡采集 VRF 数据。
BLC 定标步骤

Figure - BLC 定标界面
- 在 BLC 插件中点击 Load 导入 VRF 图;
- 选择 Pipe ID(非单 pipeline 可选);
- 选择 Channel ID;
- 点击 Calibrate,校正结果显示在 Calibrated Result 界面,若结果不理想亦可手动修改 Result;
- 点击 Update,参数将更新到参数列表,若结果不理想,可点击 Cancel 重新校正;
BLC 定标说明
- Calibrated Result panel 显示 4 个通道,10bits 与 8bits 的值,参数保存到文件中会映射到 12bits。
- Channel ID:表示对应 2 ᵅ[倍 gain 下的 BLC 参数,BLC 可随 Gain 调整,从 1x 倍 gain 到 2048 倍 gain,共 12 个等级(见 Gain-BlackValue 示意图);最后一档 manual 在 manual mode 使能时生效,此时 BLC 不随 gain 调整。

Gain – BlackValue 示意图
BLC 调试说明
BLC 参数位于 CDigitalGainFirmwareFilter
- 若 BLC 不随增益变化,将 m_bManualMode 置为 1,此时 BLC 值为 m_pGlobalBlackValueManual
- 若 BLC 随增益变化,将 m_bManualMode 置为 0,此时 BLC 值为 m_pGlobalBlackValue
LSC 定标与调试
LSC 定标 VRF 图要求
在灯箱环境(D65、 CWF、 A 光)或存在 shading 的环境中使用 diffuse 挡住镜头,拍摄若干进光均匀的图片。
LSC 定标步骤

Figure - LSC 定标界面
- 在 LSC 插件中点击 Load 导入 VRF 图;
- 选择 Pipe ID(非单 pipeline 可选);
- 选择 Channel ID;
- 调整补偿的比例 Current Percentage,建议先设为 100%,后期可修改 strength 控制补偿强度;
- 点击 Calibrate,校正仿真结果显示在 Calibrated Image;
- 点击 Update,参数将更新到参数列表,若结果不理想,可点击 Cancel 重新校正;
LSC 定标说明
- Channel ID: 0 为低色温补偿表;1 为中色温补偿表;2 为高色温补偿表;manual 在 manual mode 使能时生效,此时 LSC 不随色温调整。
LSC 调试说明
LSC 可随 CT 或 CorrelatedCT 调整(见 CT-LSCProfile 示意图)
CT 定义: 256*AWB_RGain/AWB_BGain(可通过 AWB plugin 中的 CT 信息/4 获得);
CorrelatedCT 定义:相关色温,光源发出的光与某一色温的黑体辐射光相似的程度

CT – LSCProfile 示意图
LSC 参数位于 CLSCFirmwareFilter
- LSC 需随色温变化,设置合适的 m_pCTIndex,以设置不同色温下的 Shading 表。
【注:LSC 插值依据可选择 AWBFilter 计算结果 CT(在 AWB 插件中读取 CT)或 CCTCalculatorFilter 计算结果 CCT(在 WbFirmwareFilter 中读取 m_nCorrelationCT),推荐使用 m_nCorrelationCT】

CCM 与 CCT 定标与调试
CCM 定标 VRF 图要求
在灯箱环境中使用拍摄 24 色卡,画面中色卡尽量对正,色卡居中,占画面约 1/9。
D65 、CWF 、 A 光是必要的光源。
CCM 定标步骤

Figure - CCM 定标界面
- 在 CCM 插件中点击 Load 导入 VRF 图,VRF 使用 Raw preprocessor 插件补偿 LSC 和 PDF(如存在 PD 像素);
- 在图中框选完整的色卡,保证 24 个 ROI 都落在色块之内,若拍摄图片不正或畸变严重,可点击 start,勾选期望单独调整的 ROI,然后手动拖动 ROI;
- 设定期望校正 的饱和度;
- 点击 Calibrate,校正仿真结果显示在 Calibrated Result;
- 选择 Pipe ID(非单 pipeline 可选);
- 选择 Channel ID;
- 点击 Update,参数将更新到参数列表,若结果不理想,可在 Saturation Table 中针对修改某一个 block 的饱和度,然后重新 calibrate;
CCT 定标步骤

Figure - CCM 定标界面
- 定标步骤与 CCM 定标可同时进行, CCT 只需要 A 与 D65;
- CCM Calibrate A 光之后,选择 profile 2850K,点击 UpdateCTMatrix;
- CCM Calibrate D65 光之后,选择 profile 6500K,点击 UpdateCTMatrix;
- 结果将自动更新到 CCTCaluatorFilter 中 m_pCTMatrix_low / high 中;
CCM 定标说明
- Use Internal Curve – Calibration: 无需勾选
- Use Internal Curve – Render: 无需勾选
- Use AGTM: 勾选
- Target:保持 D50
- View Environment:保持 D50
- Calibrated Result: 显示校正之后的仿真结果
- CCM Result: 列出了校正之后的色彩矩阵,此处亦可手动修改,点击 set 设到硬件中;
- Channel ID:0 为低色温 CCM 参数;1 为中色温 CCM 参数;2 为 高色温 CCM 参数;manual 在 manual mode 使能时生效,此时 CCM 不随色温调整。
- Make DNG Profile: reserved
- UpdateCTMatrix:更新 CCT matrix
- SaveImage:保存 render 出的图片
CCM 调试说明
CCM 可随色温调整(见图 CCM-色温控制曲线)

CT – CCM index 示意图
CCM 参数位于 CColorMatrixFirmwareFilter
- CCM 需随色温变化,设置合适的 m_pCTIndex,以设置不同色温下的色彩矩阵,推荐使用 CorrelatedCT。
【注:CCM 插值依据可选择 AWBFilter 计算结果 CT(在 AWB 插件中读取 CT)或 CCTCalculatorFilter 计算结果 CCT(在 WbF irmwareFilter 中读取 m_nCorrelationCT)】

AWB 定标与调试
AWB 白点定标 VRF 图要求
AWB 定标无需额 外拍图,完成 CCT 定标即可进行。
AWB 白点定标步骤

Figure - AWB 定标界面
- 打开 AWB 插件。
- 点击 Optimize,定标参数将自动更新到参数界面;
AWB 亮度定标
在 AE 调试完成之后,需对模组亮度进行定标, 从而得到 AWB 需要的 Lux,定标步骤如下:
- 相机置于灯箱,拍摄灯箱壁,光源选择 D65;
- 使用色温照度计测量灯箱照度,填入 AECFilter 中 m_nCalibSceneLux;
- 在 AECFilter 中读取 m_nExpIndexLong,填入 AECFilter 中 m_nCalibExposureIndex;
- 在 AECFilter 中读取 m_nLumQ16,填入 AECFilter 中 m_nCalibSceneLum;
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nCalibExposureIndex | 亮度定标的曝光索引 | 是 | |
m_nCalibSceneLum | 亮度定标的场景亮度 | 是 | |
m_nCalibSceneLux | 定标场景对应的实际照度 | 是 | |
m_nSceneLux | AWB debug参数,当前AE计算得到的场景照度 | - | 只读 |
AWB Debug
Block debug 信息
连接设备,点击 AWB 插件,每个 block 的落点将以蓝色点显示在坐标轴上,AWB 统计图像显示为缩略图。
统计图上可框选区域(默认展示所有区域的落点),框选之后只会显示框中 block 的落点。

Figure - AWB 插件界面
ROI 中的白点
点击 Show ROI, 可以看到不同 ROI 中包含的 block 情况,白色为参与白平衡计算的 block,即落入 ROI 区域的 block。
下图可见具体 32X24 个 block 所属 ROI。

Figure - ROI 信息界面
Block 的权重
勾选 auto update 会定时更新 lux 及统计图,并实时计算 block 的权重。
拖动 Weight Percentage,可以调整 debug 图上实际场景与参与白平衡计算的 block 的比例。0% 显示实际场景,100% 显示参与白平衡计算的 block 的权重(权重参考热力图)。
若设为 100%,画面显示为全黑,表示该 lux 下所有 block 权重为 0。

Figure – AWB 插件界面
设置 Weight Percentage 为 100%,以热力图形式显示 block 的权重,可以将鼠标拖动到期望了解的 block,热力图右侧会显示对应 block 的权重(AWB Frameinfo 也可以看到 debug 信息),上图鼠标选择的是 block[12][2],权重为 16

白平衡 gain 的落点
RGB gain panel 模块,勾选 enabled,填入 Q12 精度的 RGB gain (debug 信息 CurrentResult),对应白平衡 gain 在色温坐标系中以蓝色方块呈现,色温坐标系通过鼠标从左上到右下框选放大,从右下到左上框选缩小。
当前白平衡 gain 在色温坐标系中以红色方块呈现。

Figure – 白平衡落点
AWB 调试说明
-
定标 Panel
- Calibrate Panel
- Visible:勾选将在坐标中显示该 ROI
- Enable:勾选将使能该 ROI
- Calibrate Files Panel
- Percentage:选取 VRF 图的比例。20%,表示选择中心 20% 的区域用于定标,图像中心的区域受到 shading 的影响较小。
- Optimize:自动定标
- Load config: (reserved)
- Save config: (reserved)
- Load:导入 VRF
- Calibrate:reserved
- Update:更新参数到参数列表
- Cancel:取消参数更新
- ShowROI:显示各个 ROI 的百点情况
- Calibrate Panel
-
调试 Panel
- Control Panel
- Pipe ID:当前的 pipeline ID(非单 pipe 可选)
- Auto Update:online 状态自动更新当前亮度与统计窗口(勾选时,在插件中将不能修改参数)
- Manual Lux:固定当前亮度
- Weight Percentage:debug 参数,调整显示白平衡统计块与块的权重。0% 显示统计块,100% 显示块权重热力图。
- RGB Gain:debug apply 的 gain,对应色温坐标系中红色的点。
- Luminance Boundary:参与 AWB 统计的像素的亮度区间(8 bit)
- Valid Number:白平衡计算所需最少有效 block,[0,768]
- Correct Limit Panel:block 限制区间,超出 Limit 且处于 ROI 的 block 将会在 XY 上方向映射。
- Green Shift Panel
- Shift Max Weight:shift 权重,与 exposure shift 相乘得到最终的 shift 权重,最大 32,完全偏向 outdoor gain
- Green Number Threshold:落在 G 区的 block 的数目,在此区间则进入 green shift
- Outdoor RGB Gain:green shift 目标 gain
- Shift Weight:依据 exposure 调整 weight
- Luminance Panel
- Lux:亮度索引
- Weight:对应 ROI 在当前亮度下的权重
- Min / Max:luma 区间(8 bit)
- Control Panel
-
Debug Panel
- RGB Gain Panel
- enabled:用于展示白平衡 gain 在色温坐标系的位置
- RGB:白平衡 gain
- Gain Panel:debug 信息,鼠标在色温坐标系上滑动,可显示对应位置的 debug 信息。
- X Y:色温坐标系上点对应 XY 坐标
- CT:色温坐标系上点对应 CT 值, 可用于提供 LSC、CCM 插值依据。
- RGB:色温坐标系上点对应白平衡 gain
- CCT 、Tint:色温坐标系上点对应 CCT 与 Tint, 可用于提供 LSC、CCM 插值依据。
- CCT curve:色温坐标系上显示 CCT curve。
- Vaild only:色温坐标系上只展示有效统计块。
- Applied Gain:当前场景白平衡 gain 落点,对应色温坐标系中红色的点。
- Block 、Weight:鼠标在统计图上滑动,可显示对应 block 的位置及权重。
- RGB Gain Panel
Curve 调试
Curve 调试步骤

Figure - Curve 调试界面
- 打开 Curve 插件;
- 选择 Pipe ID(非单 pipeline 可选);
- 选择 Channel ID;
- 鼠标滑至 Curve 上想要调节的点,左键拖动到期望位置;
- 点击 Update,参数将更新到参数列表,若结果不理想,可点击 Cancel 重新校正;
Curve 调试说明
- Channel ID:
- BacklightCurveManual:用于控制背景亮度,建议保持曲线不变,调整 strength 即可;
- ContrastCurveManual:用于控制对比度,建议保持曲线不变,调整 strength 即可;
- GTMCurve0:gain 为 m_pGainIndex[0] (Q4 精度)时的曲线
- GTMCurve1:gain 为 m_pGainIndex[1] (Q4 精度)时的曲线
- GTMCurve2:gain 为 m_pGainIndex[2] (Q4 精度)时的曲线
【注:当 m_nCurveSelectOption 设为 0 时,curve 依据当前 gain 做插值(见 Curve-Gain 控制曲线示意图)】

Gain– Curve index 示意图
Curve 参数位于 CCurveFirmwareFilter
- Curve 可随 gain 变化,设置合适的 m_pGainIndex,以设置不同 gain 下的 curve。

Noise 定标与调试
Noise 定标 RAW 图要求
在实验室环境中使用拍摄 24 色卡,画面中色卡尽量对正,色卡居中,占比约 1/9。
控制灯光亮度,依次拍摄 1、2、4、8、16、32、64、128、256、512、1024、2048 倍 Gain 下的色卡。
Noise 定标步骤

Figure 5.6.2 Noise 定标界面
- 在 Noise 插件中点击 Load 导入 RAW 图,VRF 使用 Raw preprocessor 插件补偿 LSC 和 PDF(如存在 PD 像素);
- 在图中框选色卡最下方的 6 个块,保证 6 个 ROI 都落在色块之内,若拍摄图片不正或畸变严重,可点击 sta rt,勾选期望单独调整的 ROI,然后手动拖动 ROI;
- 设定期望 Denois Strength;
- 点击 Calibrate,标定噪声水平显示在 Noise Result;
- 选择 Pipe ID;
- 选择 Channel ID;
- 点击 Update,参数将更新到参数列表,若结果不理想,可点击 Cancel 重新校正;
Noise 定标说明
- Noise Result 显示标定的噪声水平;
- Channel ID: 0 为 1 倍 gain 下的去噪参数;1 为 2 倍 gain 下的去噪参数;以此类推,11 为 2048 倍 gain 下的去噪参数;manual 为 manual mode 下的去噪参数。
PDAF 定标
PDAF 定标 VRF 图要求
在实验室环境中拍摄棋盘格,拍摄物距 2 米,棋盘格和 sensor 平行。
控制灯光亮度,使得增益尽量接近 1 倍。
拍摄马达从有效位置最小值到有效位置最大值的图像(将整个扫描区域均分成 30 段, 31 个位置),共 31 张(vrf 文件名命名规范为 position.vrf ,PD raw files 文件名 position_L.raw,position_R.raw)

PDAF 定标步骤

Figure - PDAF 定标界面
- 在 PDC 插件中点击 Load 选择 VRF 文件夹(若导入的是已抽出 PD 的 raw files,还需填写 raw 的宽高);
- 点击 Calibrate,将显示图像分割为 5x5 的块所对应的块的 position – shift 图;
- 选择 Pipe ID(非单 pipeline 可选);
- 点击 Update,CAFFilter 中 m_pPDShiftPositionLUT 参数将更新,
- 若结果不理想,可点击 Cancel 重新校正;
PDC 定标
PDC 用于将 PD 像素或 shadow 像素亮度补偿到正常亮度供 PDAF 对焦算法使用。
已知 PD 点,shadow 分布情况(m_pPixelMask 和 m_pPixelTypeMask)下,通过含 PD 点分布的图像,对 PDC 参数 m_pRatioBMap 进行标定。
PDC 定标 VRF 图要求
在灯箱环境 D65 中,使用毛玻璃拍摄灯箱壁。
PDC 定标步骤

Figure - PDC 定标界面
- 在 PDC 插件中点击 Analyze,pdc plugin 判断 setting 中 m_pPixelMask 和 m_pPixelTypeMask 设置是否合理,如果不合理需要调整这两个参数。
- Analyze 分析 setting,合理后,Load 按钮有效化。QuadBayer PD 可选择补偿方式(0-1 通道互补或 2-3 通道互补,四通道 PD 点数目相同时,还可选择四通道互补)。
- Load 图像成功后,右边会显示对应通道抽取的 PD 点组成的小图像。按下 Calibrate 按钮,会计算根据图像计算得到的 m_pRatioBMap,并会将用新的 m_pRatioBMap 补偿过的 P D 点组成的小图像显示在右图中。
- Update 按钮会更新 PDC 参数中 m_pRatioBMap,若结果不理想,可点击 Cancel 重新校正。
- 选择 Pipe ID(非单 pipeline 可选)。
- 点击 Update,参数将更新到参数列表,若结果不理想,可点击 Cancel 重新校正。
PDC 定标说明
m_pPixelMask,m_pPixelTypeMask 说明
- 两个参数标定图像 PD,shadow 分布,分布以 32x32 周期分布。如果 m_pPixelMask=1,则当前点为 PD 点,m_pPixelTypeMask 表示像素遮蔽的四种方向;如果 m_pPixelMask=0,m_pPixelTypeMask>0,则当前点为 s hadow 点。
- 两个参数一般由 sensor 厂商提供,如果没有则拍摄 RAW 图手工标定。
Raw preprocessor 插件
Raw preprocessor 插件说明
Raw preprocessor 插件用于 raw 预处理,支持 PD 点矫正,LSC 补偿,Unpack VRF(ASR RAW packed format)功能。
Raw preprocessor 插件使用

Figure - Raw preprocessor 界面
- 在 Raw preprocessor 插件中设置 input 和 output VRF 文件;
- 选择对应的 pipe 以及 LSC channel;
- 选择期望的预处理功能,PDF,LSC,Unpack;
- 点击 Preprocess
- Batch preprocess 支持文件夹导入,批处理 VRF 文件
General Information 插件
General Information 插件用于连接设备实时显示一些 debug 信息
General Information 显示
默认配置了如下信息供调试工程师参考

Figure - General Information 信息
General Information 拓展
点击 setting,出现如下信息编辑页,可以自由编辑想要关注的信息。一行为一个显示条目,格式说明详见 Expression Manual

Figure - General Information 拓展
ISP Tuning
CTopFirmwareFilter 调试说明
CTopFirmwareFilter 用于配置 ISP Top 信息。
TOP 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nBayerPattern | Bayer模式:0: RGGB 1: GRBG 2: GBRG 3: BGGR 4: monochrome | 依据硬件设置 | |
m_bAELinkZoom | AE窗口关联zoom | 用户设置 | |
m_bAFLinkZoom | AF关联zoom | 用户设置 | |
m_bAWBLinkZoom | AWB关联zoom | 用户设置 | |
m_nPreviewZoomRatio | 预览zoom系数,Q8 | 用户设置 | |
m_bPreviewLowPowerMode | 预览低功耗模式 | 用户设置 | |
m_nAEProcessPosition | AE处理时机0: eof 1: sof | 用户设置 | |
m_nAEProcessFrameNum | AE处理频率,支持:eof每帧处理 / eof 每两帧处理 / sof每帧处理 / sof 每三帧处理 | 用户设置 | |
m_bHighQualityPreviewZoomEnable | Reserved |
CAEMFirmwareFilter 参数说明
CAEMFirmwareFilter 模块用于配置自动曝光统计模块。
AEM 使能及参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | AEM使能:0:关闭自动曝光统计模块 1:使能自动曝光统计模块 | 否 | |
m_nAEStatMode | AE统计模块模式:0:统计信息不经过白平衡 1:统计信息经过白平衡 | 否 | |
m_bZSLHDRCapture | 零延迟HDR抓拍使能0:不启动 1:启动零延迟HDR抓拍功能 | 用户设置 | |
m_nInitialExpTime | 初始化曝光时间 | 是 | |
m_nInitialAnaGain | 初始化模拟增益 | 是 | |
m_nInitialSnsTotalGain | 初始化sensor总增益 | 是 | |
m_nInitialTotalGain | 初始化总增益 | 是 | |
m_nStableTolerance | AE稳定容忍度百分比:若当前曝光量与前一次曝光量的差值小于前一次曝光量的m_nStableTolerance%,则给出AE StableFlag信号,供其他模块如LTM参考 | 用户设置 | |
m_nStableToleranceExternal | AE稳定容忍度百分比,共外部系统使用 | 用户设置 | |
m_bAutoCalculateAEMWindow | AE统计窗口计算方式:0:由hardware配置 1:由firmware控制 | 否 | |
m_nPreEndingPercentage | 不参与AE统计模块的行数相对于图像高的百分比 | 否 | |
m_bDRCGainSyncOption | DRCgain同步:0:每帧同步 1:AE稳定后同步 | 否 | |
m_pSceneChangeSADThr | 判断场景变化的SAD门限 | 用户设置 | |
m_pSubROIPermil | 6个子统计模块的起始坐标及结束坐标相对于图像宽高的千分比可根据人脸测光或对焦测光联动,由application修改 | 用户设置 | |
m_nSubROIScaleFactor | 副窗口缩放百分比系数 | 用户设置 | |
m_nFaceLumaOption | 人脸亮度统计方式:0:硬件统计(pixel) 1:软件统计(block) | 否 | |
m_bMotionDetectEnable | 运动检测开关:0:关闭运动检测 1:使能运动检测 | 用户设置 | |
m_bMotionDetectExt | 运动检测方式:0: 使用内部 AEM 统计 1:使用外部 gyro sensor | 用户设置 | |
m_nMotionStrengthExt | 外部运动强度控制,运动检测方式为外部 gyro 时有效 | 用户设置 | |
m_nSADIntervalFrame | 计算 SAD 的间隔帧数,运动检测方式内部 AEM 统计时有效 | 否 | |
m_nMotionThreshold | 判断运动的 SAD 门限,运动检测方式内部 AEM 统计时有效 | 否 | |
m_nMotionDetectFrame | 连续 m_nMotionDetectFrame 帧检测到 SAD 超过门限,则认为是运动场景 | 否 | |
m_nFaceDetFrameID | 侦测到人脸的帧号 | - | 只读 |
m_nAdjacentLumaSAD | 当前SAD | - | 只读 |
m_pMainRoiCoordinate | 主窗口坐标 | - | 只读 |
m_pSubRoiCoordinate | 副窗口坐标 | - | 只读 |
CDigitalGainFirmwareFilter 参 数说明
CDigitalGainFirmwareFilter 模块用于配置数字增益和黑电平。
DigitalGain 使能及参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | digital gain使能:0:关闭数字gain 1: 使能数字gain | 用户设置 | |
m_nISPGlobalOffsetValue12bit | 0:在stretch中扣除黑电平1:在digital gain中完全扣除黑电平2-511:完全扣除黑电平后,12bit添加的offset(此offset会在stretch扣除) | 用户设置 | |
m_bManualMode | 手动模式使能 0: 自动模式1: 打开手动模式,此时黑电平参数不随gain变化,使用manual参数,用于debug | ||
m_pGlobalBlackValueManual | 手动模式参数,作用和自动一致 | ||
m_pGlobalBlackValueManualCapture | 同上,拍照起效 | ||
m_pGlobalBlackValue | R/ GR/ GB/ B四个通道的黑电平(见Gain-BlackValue示意图) | 定标结果参数 | 可随gain变化 |
m_pGlobalBlackValueCapture | 同上,拍照起效 | 定标结果参数 | 可随gain变化 |
m_pWBGoldenSignature | 白平衡golden模组特征 | - | 只读 |
m_pWBCurrentSignature | 白平衡当前模组特征 | - | 只读 |

Gain – BlackValue 示意图
CWBGainFirmwareFilter 参数说明
CWBGainFirmwareFilter 模块用于自动白平衡增益。
WBGain 使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | WB gain使能:0:关闭白平衡gain 1: 使能白平衡gain | 否 |
CStretchFirmwareFilter 参数说明
CStretchFirmwareFilter 模块用于弥补扣除黑电平之后像素不饱和。
Stretch 使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | stretch使能:常开,用于弥补扣除黑电平,并补偿像素不饱和 | 否 |
CColorMatrixFirmwareFilter 参数说明
CColorMatrixFirmwareFilter(CCM)模块用于色彩校正。
CCM 使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | CMC使能:0:关闭色彩校正矩阵 1:使能色彩校正矩阵 | 否 |
CCM 参数及调试
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bUseCorrelatedCT | 插值依据选项:0:使用AWB的CT 1:使用WbFirmwareFilter中m_nCorrelationCT(CCT matrix需要标定) | 用户设置 | |
m_pColorTemperatureIndex | 色温分段控制点。(示例见图cmc-色温控制曲线)色温位于[0,Index[0]]区间,认定为低色温区间,使用CMC0的色彩校正矩阵;色温位于[Index[0],Index[1]]区间,使用CMC0与CMC1插值的色彩校正矩阵;色温位于[Index[1],Index[2]]区间,认定为中色温区间,使用CMC1的色彩校正矩阵;色温位于[Index[2],Index[3]]区间,使用CMC1与CMC2插值的色彩校正矩阵;色温位于[Index[3],8192]区间,认定为高色温区间,使用CMC2的色彩校正矩阵; | 是 | |
m_pCMC0 | 低色温色彩校正矩阵,由CCM插件定标得到。R'G'B' to RGB ,Q12精度。 | 定标结果参数 | 可依据色温调用 |
m_pCMC1 | 中色温色彩校正矩阵,由CCM插件定标得到。R'G'B' to RGB ,Q12精度。 | 定标结果参数 | 可依据色温调用 |
m_pCMC2 | 高色温色彩校正矩阵,由CCM插件定标得到。R'G'B' to RGB ,Q12精度。 | 定标结果参数 | 可依据色温调用 |

图 cmc-色温控制曲线
CCM 彩边抑制功能及参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bColorFringleRemoveEnable | 彩边抑制使能:0:关闭 1: 使能 | 用户设置 | |
m_nColorFringRemovalStrength | 彩边抑制强度:值越大,彩边抑制效果越强 | 是 |
备注:Final CFR_Ratio=HueRatio*EdgeRatio>>HighFreqTransShiftNum
- Hue 控制参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nHueTransShiftNum | Hue过渡带偏移系数:(示例见图HueTrans-HueRatio控制曲线)Hue落入[(ColorFringeHueRange[0]-(1<<ShiftNum),ColorFringeHueRange[0]]区间做平滑处理;Hue落入[ColorFringeHueRange[1],(ColorFringeHueRange[1]+(1<<ShiftNum)]区间做平滑处理; | 是 | |
m_pColorFringeHueRange | 彩边抑制的Hue区间(示例见图HueTrans-HueRatio控制曲线)HueRange[0] 需小于 HueRange[1] | 是 |
ColorFringeHueRange[0],[1]用于选定彩边抑制的 Hue 区间;
HueTransShiftNum 用于设定平滑过渡带:

图 HueTrans-HueRatio 曲线
- Freq 控制参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nHighFreqThreshold | 彩边抑制频率下限(示例见HighFreqTrans-EdgeRatio曲线)值越大,更少边缘进入彩边抑制区域 | 是 | |
m_nHighFreqTransShiftNum | 高频过渡带偏移系数(示例见HighFreqTrans-EdgeRatio曲线)频率落入[HighFreqThreshold, HighFreqThreshold +(1<<HighFreqTransShiftNum)]区间做平滑处理 | 是 |

图 HighFreqTrans-EdgeRatio 曲线
CCM Manual 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bManualMode | 手动模式使能 0: 自动模式1: 打开手动模式,此时色彩校正矩阵参数不随色温变化,使用manual参数,用于debug | - | Debug参数 |
m_pCMCManual | 手动模式参数,作用和自动一致 | - | Debug参数 |
CCM 其他参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bDisgardHFEnable | 丢弃高频信息使能:0:添加高频信息 1:丢弃高频信息 | 用户设置 | |
m_pCMCSaturationList | 饱和度控制 | 可随Gain变化 |
CBPCFirmwareFilter 调试说明
CBPCFirmwareFilter(BPC)模块用于去坏点。
BPC 使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | BPC使能0: 关闭坏点校正 1: 打开坏点校正 | 用户设置 |
BPC 动态控制参数
BPC 强度可随增益与亮度动态调节。
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_pBpcGainIndex | 增益索引,建议保持缺省值 | 否 | Gain控制节点 |
m_pSegG | 亮度索引,相邻两档间跨度须保证为2的整数幂,建议保持缺省值 | 否 | Lum控制节点 |
- 增益控制参数为 m_pBpcGainIndex ,0-11 共十二组,16 为 1 倍增益,增益处于两个节点之间时,参数为两个节点参数插值的结果。

- 亮度控制参数为 m_pSegG,0-8 共九组,其中第 8 组固定为 255 不可改,对应 VRF 数据像素值(映射到 8 比特),亮度处于两个节点之间时,参数为两个节点参数插值的结果,相邻两档间跨度须保证为 2 的整数幂,建议保持缺省值。

- 强度控制参数,可随增益和亮度的变化动态调节。
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_pCrossChnStrength | 跨通道强度,值越大,参考更多其他通道信息,也更容易受其他通道的坏像素干扰 | 是 | 可随Gain变化 |
m_pSlopeG | G通道控制曲线参数,值越大,容忍度越大,去坏点能力越弱 | 是 | 可随Gain和Lum变化 |
m_pInterceptG | G通道控制曲线参数,值越大,容忍度越大,去坏点能力越弱 | 是 | 可随Gain和Lum变化 |
m_pSlopeRB | RB通道控制曲线参数,值越大,容忍度越大,去坏点能力越弱 | 是 | 可随Gain和Lum变化 |
m_pInterceptRB | RB通道控制曲线参数,值越大,容忍度越大,去坏点能力越弱 | 是 | 可随Gain和Lum变化 |
以 m_pSlopeG 为例:
Column 表示 Gain 的档位,与 m_pBpcGainIndex 一一对应。
Row 表示 Lum 档位,与 m_pSegG 一一对应。

- 参数随 Lum 变化插值说明

【注:上述随 Lum 变化的 Value 包含 Slope, Intercept】
【注:最终容忍度由 Slope, Intercept, Ratio 共同决定,容忍度 = (Lum*Current_Slope+Current_Intercept)*Ratio. 容忍度越大,去坏点越弱】
说明:Current_Slope 与 Current_Intercept 均根据 Lum 和 gain 变化插值得出说明:Ratio 分为 Dead/SpikeRatio 与 RB/G,共 4 种情况
BPC 功能模块及参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nMinThrEn | 暗点检测通道选择Bit 0:参考跨通道信息使能;Bit 1:参考GrGb通道信息使能;Bit 2:参考相同通道信息使能。 | 否 | |
m_nMaxThrEn | 亮点检测通道选择Bit 0:参考跨通道信息使能;Bit 1:参考GrGb通道信息使能;Bit 2:参考相同通道信息使能。 | 否 | |
m_nNearThr | 使用跨通道的亮度下限值,只有亮度大于此阈值时,才会使用跨通道信息。 | 否 | |
m_bDeadEnable | 暗点矫正使能 | 用户设置 | |
m_nDeadRatioG | G通道暗点系数,值越大,G通道暗点容忍度越大,去坏点能力越弱 | 是 | |
m_nDeadRatioRB | RB通道暗点系数,值越大,RB通道暗点容忍度越大,去坏点能力越弱 | 数 | |
m_bSpikeEnable | 亮点矫正使能 | 用户设置 | |
m_nSpikeRatioG | G通道亮点系数,值越大,G通道亮点容忍度越大,去坏点能力越弱 | 是 | |
m_nSpikeRatioRB | RB通道亮点系数,值越大,RB通道亮点容忍度越大,去坏点能力越弱 | 是 | |
m_bSameChnNum | 相同通道预矫正使能1:打开相同通道预矫正,开启后可排除相同通道坏点干扰 | 用户设置 | |
m_nDeltaThr | 相同通道预矫正阈值,建议保持缺省值 | 否 | |
m_nRingGRatio | 相同通道预矫正阈值,建议保持缺省值 | 否 | |
m_nRingMeanRatio | 相同通道预矫正阈值,建议保持缺省值 | 否 | |
m_bCornerDetEn | 拐角检测使能使能可保护拐角 | 用户设置 | |
m_pSlopeCorner | 拐角控制曲线参数,值越大,保护的拐角越少,与容忍度无关 | 是 | 可随Gain和Lum变化 |
m_pInterceptCorner | 拐角控制曲线参数,值越大,保护的拐角越少,与容忍度无关 | 是 | 可随Gain和Lum变化 |
m_bEdgeDetEn | 边缘检测使能使能可保护边缘 | 用户设置 | |
m_nEdgeTimes | 边缘判定门限,值越小 ,边缘保护的越多 | 是 | |
m_bGrGbNum | GrGb通道预矫正使能1:打开GrGb通道预矫正,开启后可排除GrGb通道坏点干扰 | 用户设置 | |
m_bAroundDetEn | 亮块检测使能使能可保护亮度突变的像素块 | 用户设置 | |
m_bBlockDetEn | 2x2 坏块检测使能使能可排除2x2坏块干扰 | 用户设置 |
BPC Manual 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bManualMode | 手动模式使能1: 打开手动模式,此时bpc参数不随gain变化,使用manual参数,用于debug | - | Debug参数 |
m_nCrossChnStrengthManual | 手动模式参数, 具体功能和自动功能一致 | - | Debug参数 |
m_pSlopeGManual | 手动模式参数, 具体功能和自动功能一致 | - | Debug参数 |
m_pInterceptGManual | 手动模式参数, 具体功能和自动功能一致 | - | Debug参数 |
m_pSlopeRBManual | 手动模式参数, 具体功能和自动功能一致 | - | Debug参数 |
m_pInterceptRBManual | 手动模式参数, 具体功能和自动功能一致 | - | Debug参数 |
m_pSlopeCornerManual | 手动模式参数, 具体功能和自动功能一致 | - | Debug参数 |
m_pInterceptCornerManual | 手动模式参数, 具体功能和自动功能一致 | - | Debug参数 |
CLSCFirmwareFilter 参 数说明
CLSCFirmwareFilter 模块用于镜头阴影矫正。
LSC 使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | LSC使能0: 关闭镜头阴影校正 1: 打开镜头阴影校正 | 用户设置 | |
m_bUseOTP | LSC OTP使能 | 用户设置 |
LSC 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bAutoScale | AutoScale使能:0: 关闭自动计算缩放参数功能 1: 打开自动计算缩放参数功能 | 否 | |
m_bEnhanceEnable | Enhance使能:当前模组期望补偿倍数超过4倍时需要打开0: 关闭shading增强功能 1: 打开shading增强功能 | 用户设置 | |
m_nProfileSelectOption | shading补偿表选择:0:依据色温自动选择 1:使用LSC Profile[0] 2:使用LSC Profile[2] 3:使用LSC Profile[2] | 否 | |
m_nFOVCropRatioH | 水平方向裁剪比例 | 是 | binning尺寸决定 |
m_nFOVCropRatioV | 垂直方向裁剪比例 | 是 | binning尺寸决定 |
m_pLSCStrength | shading补偿强度:(示例见Gain-strength示意图)64表示1倍; 32表示1/2倍; 16表示1/4倍; 其他值以此类推 | 是 | 可依据gain调整 |
m_bUseCorrelatedCT | 插值依据选项:0:使用AWB的CT 1:使用WbFirmwareFilter中m_nCorrelationCT(CCT matrix需要标定) | 用户设置 | |
m_pCTIndex | 色温分段控制选择LSC profile(示例见图LSC-色温控制曲线):当m_nProfileSelectOption设置为0时有效。色温位于[0,CTIndex[0]]区间,认定为低色温区间,使用LSCProfile[0]的补偿表;色温位于[CTIndex[0],CTIndex[1]]区间,使用LSCProfile[0]与LSCProfile[1]插值的补偿表;色温位于[CTIndex[1],CTIndex[2]]区间,认定为中色温区间,使用LSCProfile[1]的补偿表;色温位于[CTIndex[2],CTIndex[3]]区间,使用LSCProfile[1]与LSCProfile[2]插值的补偿表;色温位于[CTIndex[3],8192]区间,认定为高色温区间,使用LSCProfile[2]的补偿表; | 是 | |
m_pLSCProfile | LSC补偿表,由LSC插件定标得到 | 定标结果参数 | 可依据色温调用 |

图 LSC-色温控制曲线

Gain-strength 示意图
自适应 color shading 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bLSCCSCEnable | 自适应color shading校正使能(CSC) | 用户设置 | |
m_bAdjustCSCTblMinEnable | 依据R/G(B/G)最小值调节CSC表 | 否 | |
m_nDifThr | 向量中值滤波后dif阈值,dif大于该值,则该块不参与计算CSC | 否 | |
m_nDifThrMinPerc | 向量中值滤波后dif阈值,dif小于DifThrMinPerc*DifThr,则计算CSC不考虑角度 | 否 | |
m_nAngleThr | 向量中值滤波后角度阈值,角度大于该值,则该块不参与计算CSC | 否 | |
m_nDifThrVMF | 向量中值滤波前后dif阈值,dif大于该值,则该块不参与计算CSC | 否 | |
m_nAngleThrVMF | 向量中值滤波前后角度阈值,角度大于该值,则该块不参与计算CSC | 否 | |
m_nGradThrMin | 向量中值滤波后有效梯度最小值 | 否 | |
m_nGradThrMax | 向量中值滤波后有效梯度最大值 | 否 | |
m_nGradMaxError | CSC估计统计值梯度与真实统计值梯度最大误差容忍值 | 是 | |
m_nGradThrConv | CSC两次计算的梯度差异门限,梯度差异小于该值,不更新CSC | 是 | |
m_nGradMax | CSC最大补偿强度 | 是 | |
m_nTblAlpha | 收敛速度,值越大收敛越快 | 是 | |
m_nCSCGlobalStrength | CSC全局强度 | 是 | |
m_nEffPNumAll | 全图像有效块门限 | 否 | |
m_nEffPNumHalf | 1/2图像有效块门限 | 否 | |
m_nEffPNumQuarter | 1/4图像有效块门限 | 否 | |
m_pEffNumRing | 三个ROI对应的有效块门限,ROI0为中心6x4,ROI1为中心12x8(不包含ROI0),ROI2为12x12(不包含ROI0,ROI1) | 否 | |
m_pCSCCTIndex | CSC色温控制点,CT > CSCCTIndex[1]时CSC失效 | 是 | |
m_pCSCLuxIndex | CSC亮度控制点,Lux > CSCLuxIndex[1]时CSC失效 | 是 |
LSC Manual 及 frameinfo
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bManualMode | 手动模式使能:1: 打开手动模式,此时LSC参数不随色温变化,使用manual参数,用于debug | Debug参数 | |
m_nLSCStrengthManual | 手动模式参数, 具体功能和自动功能一致 | Debug参数 | |
m_pLSCProfileManual | 手动模式参数, 具体功能和自动功能一致 | Debug参数 | |
m_nRGPolyCoefRO | 当前CSC补偿R ratio | 只读 | |
m_nBGPolyCoefRO | 当前CSC补偿B ratio | 只读 | |
m_pRGRatio | 16x12 统计块对应R/G ratio | 只读 | |
m_pBGRatio | 16x12 统计块对应B/G ratio | 只读 | |
m_pOTPProfileInternal | OTP shading表 | 只读 |
CDemosaicFirmwareFilter 调试说明
CDemosaicFirmwareFilter(Demosaic)模块用于 Bayer 插值。
Demosaic 子功能使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bIfEdgeGenerate | 高频信息生成功能开关:可用于inline sharpen(inline sharpen功能需要cmc模块配合使用) 0:关闭 1:打开 | 用户设置 | |
m_bIfGbGrRebalance | GbGr差异消除功能开关0:关闭 1:打开 | 否 | |
m_bIfDNS | inline 去噪功能开关, 建议关闭0:关闭 1:打开 | 否 |
Demosaic 动态控制参数
Demosaic 参数可随 gain 动态调节。
增益控制节点 N 从 0-11,共十二组,节点为 2 的 N 次方倍 gain,即第 0 档为 1 倍 gain;第 11 档为 2048 倍 gain。
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nInterpOffset | 四方向噪声容忍度 | 否 | 可随Gain变化 |
m_nInterpOffsetHV | 水平垂直噪声容忍度 | 否 | 可随Gain变化 |
m_nNoiseSTD | 噪声容忍度标准差 | 否 | 可随Gain变化 |
m_nLowpassGLevel | 插值频率控制参数, 越小越倾向于4方向插值结果, 越大越倾向于无方向低通插值的结果 | 是 | 可随Gain变化 |
m_nGbGrThr | GbGr差异消除功能对应的阈值,越小GbGr差异消除功能越弱, 反之则越强 | 是 | 可随Gain变化 |
m_nSharpenStrength | 高频信息放大倍率,值越大,锐化越强 | 是 | 可随Gain变化 |
m_nShpThreshold | 高频信息软阈值处理时的阈值, 建议保持缺省值 | 否 | 可随Gain变化 |
m_nDenoiseThreshold | inline 去噪功能软阈值, 越大去噪能力越强, 建议保持缺省值 | 否 | 可随Gain变化 |
m_nNoiseAddbackLevel | inline 去噪功能噪声回加强度, 越大去噪能力越弱, 建议保持缺省值 | 否 | 可随Gain变化 |
m_pDenoiseLumaStrength | 依据亮度控制去噪强度缩放系数,亮度区间为8bit下[8,16,32],亮度64以上系数为32,不缩放 | 否 | 可随Gain变化 |
m_nChromaNoiseThreshold | 去除彩噪功能阈值, 越大去除彩噪能力越强, 建议保持缺省值 | 否 | 可随Gain变化 |
m_pUSMFilter | USMFilter = conv([1 2 1], [usm2 usm1 usm0 64-2*(usm0+usm1+usm2) usm0 usm1 usm2]), 建议保持缺省值 | 否 | 可随Gain变化 |
以 m_nSharpenStrength 为例:
Column 表示 Gain 的档位,Column[0]表示 1 倍 gain 下对应的值;Column[11]表示 2048 倍 gain 下对应的值


Gain – Sharpen 示意图
Demosic 其他参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_pHFFragShiftIndex | 高频信息分段增益处理的分段信息, 建议保持缺省值 | 否 | |
m_pHFFragGainIndex | 高频信息分段增益处理的增益信息, 建议保持缺省值 | 否 |
Demosaic Manual 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bManualMode | 手动模式使能 0: 自动模式1: 手动模式,此时demosaic参数不随gain变化,使用manual参数,用于debug | - | Debug参数 |
Manual结尾参数 | 手动模式参数, 具体功能和自动功能一致 | - | Debug参数 |
CRawDenoiseFirmwareFilter 调试说明
CRawDenoiseFirmwareFilter(RawDenoise)模块用于 RAW 域去噪。
RawDenoise 使能
参数名 | 说明 | 建议修改 | 特殊性 |
---|---|---|---|
m_bEnable | RAW denoise 模块使能开关0: 关闭RAW域去噪 1: 打开RAW域去噪 | 依据用户设置 |
RawDenoise 动态控制参数
RawDenoise 参数可随 gain 动态调节。
增益控制节点 N 从 0-11,共十二组,节点为 2 的 N 次方倍 gain,即第 0 档为 1 倍 gain;第 11 档为 2048 倍 gain.(见 Gain-Denoise_strength 示意图)
参数名 | 说明 | 建议修改 | 特殊性 |
---|---|---|---|
m_pMaxSpacialDenoiseThreGain | 边角最大去噪强度, Q8精度, 值越大, 边角能达到的去噪强度越强 | 是 | 可随Gain变化 |
m_pSigma | 去噪强度阈值, 值越大去噪强度越强 | 是 | 可随Gain变化 |
m_pGns | G通道去噪强度, 值越大去噪强度越强 | 是 | 可随Gain变化 |
m_pRbns | RB通道去噪强度, 值越大去噪强度越强 | 是 | 可随Gain变化 |
m_pL0 | 对应1.5%亮度下的去噪强度伸缩系数, Q5精度, 值越大, 该亮度下去噪强度越强 | 是 | 可随Gain变化 |
m_pL1 | 对应7.8%亮度下的去噪强度伸缩系数, Q5精度, 值越大, 该亮度下去噪强度越强 | 是 | 可随Gain变化 |
m_pL2 | 对应20%亮度下的去噪强度伸缩系数, Q5精度, 值越大, 该亮度下去噪强度越强 | 是 | 可随Gain变化 |
m_pL3 | 对应45%亮度下的去噪强度伸缩系数, Q5精度, 值越大, 该亮度下去噪强度越强 | 是 | 可随Gain变化 |
m_pL0 - m_pL3 对应不同亮度下的去噪强度

luma-strength
以 m_pSigma 为例:
Column 表示 Gain 的档位,Column[0]表示 1 倍 gain 下对应的参数;Column[11]表示 2048 倍 gain 下对应的参数;


Gain - Denoise_strength 示意图
RawDenoise 功能模块及参数
参数名 | 说明 | 建议修改 | 特殊性 |
---|---|---|---|
m_bMergeEnable | 计算去噪权重时2x2->1x1的转换方式0: 取左下角, 1: 取2x2的均值 | 否 | |
m_bLocalizedEnable | 去噪强度跟随局部亮度变化功能使能1. - 关闭2. - 打开 | 否 | |
m_bSpacialEnable | 边缘去噪强度增强使能:0:关闭 1:打开 | 依据用户设置 | |
m_bSpacialAddbackEnable | 边缘去噪回加使能:0:关闭 1:打开 | 依据用户设置 | |
m_nSpacialOffCenterPercentage | 边缘去噪增强区域控制参数,去噪强度从Centerpercentage*R开始增强 (见R – CenterPercent示意图) | 是 | |
m_pMaxSpacialDenoiseThreGain | 边缘去噪最大增强门限,最远距离所能达到的最大去噪强度(见Distance – RadialGain示意图) | 是 |

R - CenterPercent 示意图

Distance - RadialGain 示意图
RawDenoise debug 参数
参数名 | 说明 | 建议修改 | 特殊性 |
---|---|---|---|
m_bManualMode | 手动模式使能 0: 自动模式1: 打开手动模式,此时raw denoise参数不随gain变化,使用manual参数,用于debug | ||
m_nSigmaManual | 手动模式参数,作用和自动一致 | ||
m_nGnsManual | 手动模式参数,作用和自动一致 | ||
m_nRbnsManual | 手动模式参数,作用和自动一致 | ||
m_nL0Manual | 手动模式参数,作用和自动一致 | ||
m_nL1Manual | 手动模式参数,作用和自动一致 | ||
m_nL2Manual | 手动模式参数,作用和自动一致 | ||
m_nL3Manual | 手动模式参数,作用和自动一致 |
CAFMFirmwareFilter 参数说明
CAFMFirmwareFilter 模块用于自动对焦统计模块。
AFM 使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | AFM使能0: 关闭自动对焦统计模块 1: 打开自动对焦统计模块 | 用户设置 |
AFM 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nAFStatMode | AF统计模块模式:0:经过白平衡 1:不经过白平衡 | 否 | |
m_nWinStartXPermil | AFM水平方向起始点坐标千分比 | 用户设置 | |
m_nWinStartYPermil | AFM垂直方向起始点坐标千分比 | 用户设置 | |
m_nWinEndXPermil | AFM水平方向结束点坐标千分比 | 用户设置 | |
m_nWinEndYPermil | AFM垂直方向结束点坐标千分比 | 用户设置 | |
m_nMinWidthPermil | AFM最小宽度千分比 | 用户设置 | |
m_nMinHeightPermil | AFM最小高度千分比 | 用户设置 | |
m_bConfigDone | FW控制参数,AF窗口设置完成时设1 | 否 | |
m_pFVList | 各对焦窗口Focus value值 | - | 只读 |
m_nFVAvg | Focus value平均值 | - | 只读 |
m_nWinStartX | AFM水平方向起始点坐标 | - | 只读 |
m_nWinStartY | AFM垂直方向起始点坐标 | - | 只读 |
m_nWinWidth | AFM宽度 | - | 只读 |
m_nWinHeight | AFM高度 | - | 只读 |
CPDCFirmwareFilter 参数说明
CPDCFirmwareFilter 模块用于将 PD 像素或 shadow 像素补偿至正常亮度供 PDAF 算法使用。
PDC 使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | PDC使能:0: 关闭PDC模块 1: 打开PDC模块 | 用户设置 |
PDC 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bOut | PD dump使能0: 关闭dump窗口内所有PD点 1: 打开dump窗口内所有PD点 | 否 | |
m_nHOffset | 水平方向ISP处理图像相对于sensor输出图像宽度的偏移量(见窗口示意图m_nHOft) | 是 | |
m_nVOffset | 垂直方向ISP处理图像相对于sensor输出图像高度的偏移量(见窗口示意图m_nVOft) | 是 | |
m_bLRAdjust | 方向控制:0: 关闭镜像 1: 打开镜像 | 是 | |
m_bTBAdjust | 方向控制:0: 关闭翻转 1: 打开翻转 | 是 | |
m_nFullWidth | sensor输出图像宽度 | 是 | |
m_nFullHeight | sensor输出图像高度 | 是 | |
m_nWindowMode | 窗口模式:0: 自动计算PD dump区域;1: 通过m_nWinStartXPermil,m_nWinStartYPermil, m_nWinEndXPermil 和EndYPermil计算PD dump区域; | 否 | |
m_nWindowScaleFactor | PDC统计窗相对于AFM统计窗的缩放比例 | 用户设置 | |
m_nMinWidthPermil | PDC统计窗最小宽度千分比 | 用户设置 | |
m_nMinHeightPermil | PDC统计窗最小高度千分比 | 用户设置 | |
m_pPDFirstX | 水平方向PD区域相对于sensor输出图像宽度的偏移量(见窗口示意图) | 是 | |
m_pPDFirstY | 垂直方向PD区域相对于sensor输出图像高度的偏移量(见窗口示意图) | 是 | |
m_pRatioA | 四通道全局调节比例 | 是 | |
m_pPixelMask | 32x32的区域内PD点的分布 | 是 | |
m_pPixelTypeMask | 32x32的区域内PD点类型的分布PD点类型分为遮蔽上下左右四种 | 是 | |
m_pRatioBMap | 四通道PD点补偿系数 | 是 | |
m_bSoftCompEnable | 软件补偿PD亮度差异开关:0:使用硬件PDC补偿 1:软件补偿(sensor抽出PD像素) | ||
m_nWinStartXPermil | 水平方向PD dump区域左上角坐标千分比 | - | 只读 |
m_nWinStartYPermil | 垂直方向PD dump区域左上角坐标千分比 | - | 只读 |
m_nWinEndXPermil | 水平方向PD dump区域右下角坐标千分比 | - | 只读 |
m_nWinEndYPermil | 垂直方向PD dump区域右下角坐标千分比 | - | 只读 |
m_nWinStartX | PDC统计窗水平方向起始点坐标 | - | 只读 |
m_nWinStartY | PDC统计窗垂直方向起始点坐标 | - | 只读 |
m_nWinWidth | PDC统计窗宽度 | - | 只读 |
m_nWinHeight | PDC统计窗高度 | - | 只读 |

窗口示意图
CPDFFirmwareFilter 参数说明
CPDFFirmwareFilter 模块用于将 PD 像素矫正到正常像素值。
PDF 使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | PDF使能0: 关闭相位对焦像素矫正 1: 打开相位对焦像素矫正 | 用户设置 |
PDF 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nExtPRm | PD像素奇异点矫正使能0: 关闭PD像素奇异点矫正 1: 打开PD像素奇异点矫正 | 用户设置 | |
m_nWA | 中心块权重8为50%权重,一般中心点本身是被补偿的PD点,故权重一般设小一些。 | 否 | |
m_nWB | 对角块权重8为50%权重,一般设为50% | 否 | |
m_nFullWidth | sensor输出图像宽度 | 是 | |
m_nFullHeight | sensor输出图像高度 | 是 | |
m_nHOffset | 水平方向ISP处理图像相对于sensor输出图像宽度的偏移量(见窗口示意图m_nHOft) | 是 | |
m_nVOffset | 垂直方向ISP处理图像相对于sensor输出图像高度的偏移量(见窗口示意图m_nVOft) | 是 | |
m_bLRAdjust | 方向控制:0: 关闭镜像 1: 打开镜像 | 是 | |
m_bTBAdjust | 方向控制:0: 关闭翻转 1: 打开翻转 | 是 | |
m_bRefRB | 0: 绿色通道矫正不参考RB通道 1: 绿色通道矫正参考RB通道 | 否 | |
m_bRefCnr | 0: 绿色通道矫正不参考角点信息 1: 绿色通道矫正参考角点信息 | 否 | |
m_nRefNoiseL | 用于判断边缘方向的当前噪声水平 | 否 | |
m_nExtPThre | PD像素奇异点的门限 | 否 | |
m_nExtPSft | PD像素奇异点的软阈值 | 否 | |
m_nExtPOpt | PD像素奇异点矫正选择 | 否 | |
m_pPDFirstX | 水平方向PD区域相对于sensor输出图像宽度的偏移量(见窗口示意图) | 是 | |
m_pPDFirstY | 垂直方向PD区域相对于sensor输出图像高 度的偏移量(见窗口示意图) | 是 | |
m_pPixelMask | 32x32的区域内PD点的分布 | 是 | |
m_pPDResult | 四方向 PD shift 与 confidence | 只读 |
CPDAFFirmwareFilter 参数说明
CPDAFFirmwareFilter 模块用于相位对焦。
PDAF 查找表
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bMirrorShift | 输出相位差取反 | 用户设置 | |
m_bShiftLutEn | 查找表使能 | 用户设置 | |
m_pShiftLut | 输出相位差查找表 | 否 |
PDAF 误差控制
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nErrorDistWeight | 误差来源的权重(见相关性拟合曲线示意图)0 表示shape的权重为1;128 表示 shape和distance各占一半;256 表示distance的权重为1; | 否 | |
m_nErrorDistCoef | distance(相关性拟合曲线距离)调节系数 | 否 | |
m_nErrorShpCoef | shape(相关性拟合曲线形状)调节系数 | 否 |

相关性拟合曲线示意图
PDAF 动态控制参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_pLumThre | 不同gain下的亮度阈值,(见图LumThre-gain控制曲线)当前亮度低于阈值时,置信度会降低 | 是 | 依据gain调整 |
m_pGainThre | 划分不同gain的区间的依据,用于依据Gain控制LumThre和SwingThre | 否 | |
m_pSwingThre | 不同Gain下的幅度门限,(见图SwingThre-gain控制曲线)当前幅度值低于此门限时,置信度会降低 | 是 | 依据gain调整 |

图 LumThre-Gain 控制曲线

图 SwingThre-Gain 控制曲线
PDAF 置信度控制参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bConfAdjust | 置信度适配开关:1 :当前幅度值高于此门限时,置信度增大0 :当前幅度值高于此门限时,置信度不变 | 否 | |
m_nConfOff | 置信度offset,用于调整最终置信度 | 否 | |
m_nConfLimit | 最大置信度(见图Error-Confidence转换曲线) | 否 | |
m_nErrorThre1 | 误差转为置信度的error门限(见图Error-Confidence转换曲线) | 是 | |
m_nErrorThre2 | 误差转为置信度的confidence门限(见图Error-Confidence转换曲线) | 是 | |
m_nSearchRange | PD shift搜索范围,PD像素密度越大,该值越大。一般密度shield pixel设0,Dual PD设3, | 是 |

图 Error-Confidence 转换曲线
CWbFirmwareFilter 参数说明
CWbFirmwareFilter 模块用于白平衡。
WB 使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | WB使能0: 关闭白平衡统计模块 1: 打开白平衡统计模块 | 否 |
WB 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bSyncWB | HDR模式白平衡同步方式选择:0:AWB单独计算 1:使用长曝光作为AWB计算源 | 否 | |
m_bAutoWindow | 窗口调整方式:0:固定窗口大小 1:依据zoom系数自动计算窗口大小 | 否 | |
m_nMode | 白平衡模式选择:0: auto mode 1:custom 2:D75 3:D65 4:D50 5:CWF 6:TL84 7:A 8:H 9:lock | 否 | |
m_nInitMode | 白平衡初始化模式:0:custom 1:D75 2:D65 3:D50 4:CWF 5:TL84 6:A 7:H | 是 | |
m_pManualGain | 手动WB gain:0-7 对应 custom/D75/D65/D50/CWF/TL84/A/H | 是 | |
m_nAWBStableRange | AWB 进入稳定状态的门限:值越小,越不容易判定为AWB稳定 | 是 | |
m_nAWBStableFrameNum | AWB 进入稳定状态的参考帧数:稳定帧数大于改值,判定为AWB稳定 | 是 | |
m_nAWBUnStableRange | AWB 进入不稳定状态的门限:值越小,越容易判定为AWB不稳定 | 是 | |
m_nAWBUnStableFrameNum | AWB 进入不稳定状态的参考帧数:不稳定帧数大于改值,判定为AWB不稳定 | 是 | |
m_nAWBStep1 | AWB 收敛的相对步长按比例计算步长,值越大,调整的比例越大,收敛的越快,准确性越低 | 是 | |
m_nAWBStep2 | AWB 收敛的绝对步长值越大,步长越大,调整的越快,准确性越低 | 是 | |
m_nLowThr | 参与AWB统计的亮度下限值越大,越多偏暗的区域不进行AWB统计 | 是 | |
m_nHighThr | 参与AWB统计的亮度上限值越小,越多偏亮的区域不进行AWB统计 | 是 | |
m_nCorrelationCT | 当前色温 | - | 只读 |
m_nTint | 当前色调 | - | 只读 |
m_bAWBStableFlag | AWB当前状态 | - | 只读 |
m_nDistance | 当前应用的白平衡gain与target gain 差的绝对值之和 | - | 只读 |
CCTCalculatorFilter 参数说明
CCTCalculatorFilter 模块用于计算真实色温。
CCTCalculator 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nIterateNumber | 计算CT的迭代次数 | 否 | |
m_nColorTemperatureLow | 低色温矩阵对应色温 | ||
m_nColorTemperatureHigh | 高色温矩阵对应色温 | ||
m_pCTMatrixLow | 低色温矩阵 | 定标结果 | |
m_pCTMatrixHigh | 高色温矩阵 | 定标结果 |
CRGB2YUVFirmwareFilter 参数说明
CRGB2YUVFirmwareFilter 模块用于 RGB 转 YUV。
RGB2YUV 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nOutputColorSpace | 输出色彩空间选择:0:Rec.601, 1:Rec.709 | 用户设置 | |
m_nGlobalSaturation | 全局饱和度系数,Q7精度 | 是 | |
m_pSaturationCP | 饱和度随gain控制参数(示例见图sat_CP-gain控制曲线) | 是 | 可随gain变化 |
RGB2YUV Manual 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bManualMode | 手动模式使能:0:自动模式,饱和度可随gain变化 1:手动模式,饱和度固定为manual所设系数 | Debug参数 | |
m_nSaturationManual | 手动饱和度系数,Q7精度 | Debug参数 |

图 sat_CP-gain 控制曲线
CSpecialEffectFirmwareFilter 参数说明
CSpecialEffectFirmwareFilter 模块用于特殊效果调试。
SE 使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | Special effect使能0: 关闭特殊效果 1: 打开特殊效果共6个控制区域,区域0-5优先级逐渐降低 | 用户设置 |
SE 参数
参数分为区域 0-5,共 6 组,每组含义一样,针对 6 个控制区域,区域 0-5 优先级逐渐降低。
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bZoneEb_0 | 区域0 特效使能 | 用户设置 | |
m_pRyTable_0 | 亮度旋转参数,定标参数 | 定标结果参数 | |
m_nSyTable_0 | 亮度平移参数,定标参数 | 定标结果参数 | |
m_pRuvTable_0 | UV旋转参数,定标参数 | 定标结果参数 | |
m_pSuvTable_0 | UV平移参数,定标参数 | 定标结果参数 | |
m_pMargin_0 | 渐变过渡带[Lum_min - Margin_0[0],Lum_max + Margin_0[1] 是平滑区间; [Hue_min - Margin_0[2],Hue_max + Margin_0[3] 是平滑区间; [Sat_min - Margin_0[4],Sat_max + Margin_0[5] 是平滑区间; | 是 | |
m_pYTable_0 | 目标调整区域的Lum范围 | 是 | |
m_pHTable_0 | 目标调整区域的Hue范围 | 是 | |
m_pSTable_0 | 目标调整区域的Saturation范围 | 是 |
SE 动态控制参数
GainWeight_0-5 共用一组 GainLut,用于针对不同亮度区间设置不同的强度。
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nGainLut | GainWeight分段点,对应实际场景的值为exposure_time(us)*total_gain(Q8)>>8 | ||
m_pGainWeight_0 | 特殊效果的强度,(见图GainWeight-GainLut控制曲线)值越大,特殊效果越强 | 是 | 可依据Gainlut变化 |

SE Manual 参数
参数分为区域 0-5,共 6 组,每组含义一样
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bManualMode_0 | 区域0 手动模式使能 | - | Debug参数 |
m_nManualGainWeight_0 | 手动模式下特殊效果的强度 | - | Debug参数 |
CCurveFirmwareFilter 参数说明
CCurveFirmwareFilter 模块用于伽马曲线。
Curve 使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | Curve使能0: 关闭伽马曲线 1: 打开伽马曲线 | 用户设置 |
Curve 控制参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEbGtmAfterLinearcurve | GTM随线性曲线改变使能:0:gtm1 curve不变, 1:gtm1 curve 随线性曲线改变 | 否 | |
m_nCurveSelectOption | Curve使用选择:0: 基于gain自动计算, 1:使用GTMcurve0, 2:使用GTMcurve1, 3:使用 GTMcurve2 4:使用A-Log curve | 否 | |
m_nBacklightStrengthManual | 低亮区域亮度调节参数:值越大,低亮区域的亮度提供的越多,0表示不增强低亮区域,此时BacklightCurveManu al不作用于最终的曲线 | 用户设置 | |
m_nContrastStrengthManual | 对比度调节参数:值越大,对比度越高,128表示不调节对比度,此时ContrastsCurveManual不作用于最终的曲线 | 用户设置 | |
m_nBrightnessStrengthManual | 亮度调节参数:值越大,整体亮度越高,4096表示一倍 | 用户设置 | |
m_nAlpha | 前后帧GTM曲线融合的迭代速度。m_nAlpha值越大,越快收敛到当前帧计算得到的GTM曲线,255表示立即收敛到当前帧曲线。 | 是 | |
m_pBacklightCurveManual | 用于调节低亮区域的曲线 | 否 | |
m_pContrastsCurveManual | 用于调节对比度的曲线 | 否 | |
m_pGainIndex | Gain分段控制点(见Curve-Gain控制曲线示意图) 色温分段控制点。(见Curve-Gain控制曲线示意图)gain位于[128,GainIndex[0]]区间,使用GTMCurve0的曲线;gain位于[GainIndex[0],GainIndex[1]]区间,使用GTMCurve0与GTMCurve1插值的曲线; gain位于GainIndex[2],使用GTMCurve1的曲线;gain位于[GainIndex[1],GainIndex[2]]区间,使用GTMCurve1与GTMCurve2插值的曲线;gain位于[GainIndex[2],2048]区间,使用GTMCurve2的曲线; | 是 | |
m_pGTMCurve0 | 曲线0 | 是 | 可依据Gain调用 |
m_pGTMCurve1 | 曲线1 | 是 | 可依据Gain调用 |
m_pGTMCurve2 | 曲线2 | 是 | 可依据Gain调用 |

Curve-Gain 控制曲线示意图
CLTMFirmwareFilter 参数说明
CLTMFirmwareFilter 模块用于局部色调映射。
LTM 使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | LTM使能:0: 关闭局部色调映射 1: 打开局部色调映射 | 用户设置 | |
m_bHistEnable | LTM 直方图使能:0: 关闭LTM 直方图 1: 打开LTM 直方图 | 否 | |
m_nOffsetY | 图像水平方向偏移,由输入图像大小确定 | 用户设置 | |
m_nOffsetX | 图像垂直方向偏移,由输入图像大小确定 | 用户设置 |
LTM 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nLtmStrength | Ltm强度,值越大,Ltm效果越强 | 是 | |
m_nCurveAlpha | 当前帧计算得到的曲线与历史保存曲线进行融合的收敛速度,值越小,收敛越快 | 是 | |
m_nSlopeThr | DrcDrcDark < Thr,等效于GTM;DrcDrcDark >= Thr,每个块单独计算LTM强度 | 否 | |
m_nPhicBeta | LTM曲线衰减控制点,值越小,曲线越早衰减,越多中高亮的块不会提亮(PhicBeta示意图) | 否 | |
m_nBlendCurveFP | 根据DRCGain和DrcGainDark计算gtm曲线,BlendCurveFP和BlendCurveSP为两个控制节点,BlendCurveFP<=BlendCurveSP。第一个节点FP之前,tone mapping强度与 DRCGain*DrcGainDark有关。BlendCurveFP越大,暗区提亮范围越大。 | 否 | |
m_nBlendCurveSP | 第二个节点SP之后,tone mapping强度与DRCGain有关,两个节点之间平滑过渡。BlendCurveSP越小,亮度提升范围越小。 | 否 | |
m_nSubDarkPercThrLow | 次暗区提亮调整参数,值越小,次暗区提亮强度越大。 | 否 | |
m_nSubDarkPercThrHigh | 次暗区提亮调整参数,值越小,次暗区提亮强度越大。SubDarkPercThrLow < SubDarkPercThrHigh | 否 | |
m_nSubDarkAdjMeanThr | 次暗区提亮调整参数,SubDarkPercThrLow,SubDarkPercHigh和SubDarkAdjMeanThr与块的次暗区的点占所有点的百分比,控制次暗区LTM强度。如果当前块均值大于SubDarkAdjMeanThr并且当前块次暗区百分比大于SubDarkPercThrLow,则会提高次暗区LTM强度。当次暗区百分比达到SubDarkPercThrHigh,次暗区LTM强度最大。 | 否 | |
m_nDarkPercThrLow | 暗区提亮调整参数,值越小,暗区LTM强度越大。 | 否 | |
m_nDarkPercThrHigh | 暗区提亮调整参数,值越小,暗区LTM强度越大。DarkPercThrLow < DarkPercThrHigh。 | 否 | |
m_nPhCDarkMaxExtraRatio | 暗区提亮调整参数,DarkPercThrLow,DarkPercThrHigh和PhCDarkMaxExtraRatio与block的最暗区占所有点的百分比,控制暗区LTM强度。当前块暗区百分比大于DarkPercThrLow,则会提高暗区LTM强度,当最暗区百分比达到DarkPercThrHigh,暗区LTM强度最大。PhCDarkMaxExtraRatio越大,暗区LTM强度越大。 | 否 | |
m_pDstAlphaGainIndex | LTM强度gain控制节点 | 否 | |
m_pDstAlphaIndex | 依据DstAlphaGainIndex控制节点调整LTM强度:值越大,LTM强度越大 | 是 |

PhicBeta 示意图
CUVDenoiseFirmwareFilter 参数说明
CUVDenoiseFirmwareFilter 模块用于去除颜色噪声。
UVDenoise 使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | UVDenoise使能 | 否 | 建议使用CPP去噪 |
CEELiteFirmwareFilter 参数说明
CEELiteFirmwareFilter 模块用于控制边缘增强。
EE 使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | EE使能 | 用户设置 |
CEELite 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_pCurveLumaP | 正边基于亮度自适应增强,值越大边越强 | 是 | |
m_pCurveLumaN | 负边基于亮度自适应增强,值越大边越强 | 是 | |
m_pCurveFreqTxP | 正边基于频率自适应增强,值越大纹理越多 | 是 | |
m_pCurveFreqTxN | 负边基于频率自适应增强,值越大纹理越多 | 是 | |
m_nNodeFreq | 频率调节节点 | ||
m_pGlobal_SharpenStrengthP | 正边全局增强,值越大边越强 | 是 | |
m_pGlobal_SharpenStrengthN | 负边全局增强,值越大边越强 | 是 | |
m_pGlobal_SharpenStrengthPCapture | 拍照参数,正边全局增强,值越大边越强 | 是 | |
m_pGlobal_SharpenStrengthNCapture | 拍照参数,负边全局增强,值越大边越强 | 是 | |
m_pLPF1 | USMFilter滤波器参数 | 否 | |
m_pLPF2 | USMFilter滤波器参数USMFilter = conv([(flt1[0]-flt2[0]) (flt1[1]-flt2[1]) 2*(flt2[0]+flt2[1] - flt1[0]-flt1[1]) (flt1[1]-flt2[1]) (flt1[0]-flt2[0])]) | 否 | |
m_pLPF1Capture | 拍照参数,USMFilter滤波器参数 | 否 | |
m_pLPF2Capture | 拍照参数,USMFilter滤波器参数USMFilter = conv([(flt1[0]-flt2[0]) (flt1[1]-flt2[1]) 2*(flt2[0]+flt2[1] - flt1[0]-flt1[1]) (flt1[1]-flt2[1]) (flt1[0]-flt2[0])]) | 否 | |
m_pFreqExpLevel1 | 低频区间频率分段控制,值越大,分段越密 | 否 | |
m_pFreqExpLevel2 | 高频区间频率分段控制,值越大,分段越密 | 否 | |
m_pFreqOffsetTx | 频率软阈值,值越大,抗噪水平越强 | 是 | |
m_pTxClipP | 纹理区域正边锐化截断处理,值越大,锐化越强 | 是 | |
m_pTxClipN | 纹理区域负边锐化截断处理,值越大,锐化越强 | 是 | |
m_pTxThrdP | 纹理区域正边锐化门限,值越小,锐化越强 | 是 | |
m_pTxThrdN | 纹理区域负边锐化门限,值越小,锐化越强 | 是 | |
m_pClipPos | 正边锐化截断处理,值越大,锐化越强 | 是 | |
m_pClipNeg | 负边锐化截断处理,值越大,锐化越强 | 是 | |
m_pHCStrength | 边沿halo强度控制,值越小,halo抑制越强 | 是 | |
m_pCoffW | Halo区域判定参数 | 否 | |
m_pGainIndex | 增益控制节点(Q4) | 否 |
EE Manual 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bManualMode | 手动模式使能 | - | Debug参数 |
Manual结尾参数 | 手动模式参数,与自动一致 | - | Debug参数 |
CBitDepthCompressionFirmwareFilter 参数说明
CBitDepthCompressionFirmwareFilter 模块用于降位深压缩。
Dithering 使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnableDithering | Dithering使能0: 关闭Dithering 1: 打开Dithering | 否 |
CFormatterFirmwareFilter 参数说明
CFormatterFirmwareFilter 模块用于输出格式控制。
Formatter 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nOutputFormat | 输出格式:0: NV12 1: P010 2:RGB888 | 否 | |
m_nSwingOption | 0: full swing, 1: studio swing | 否 | |
m_bConvertDitheringEnable | 0: rgb2yuv dithering disable, 1: rgb2yuv dithering enable | 否 | |
m_bCompressDitheringEnable | 0: full swing to studio swing dithering disable, 1: full swing to studio swing dithering enable | 否 |
CEISFirmwareFilter 参数说明
CEISFirmwareFilter 模块用于电子防抖。
EIS 使能
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bEnable | EIS使能0: 关闭EIS计 1: 打开EIS | 用户设置 |
EIS 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bCalcEnable | Firmware计算使能0: 关闭 1: 打开 | 用户设置 | |
m_bFilterEnable | 运动平滑滤波使能0: 关闭运动平滑滤波(一般设备与场景相对运动较少时关闭) 1: 打开运动平滑滤波 | 是 | |
m_nRangeX | X方向检测移动的范围(单位为像素) | 否 | |
m_nRangeY | Y方向检测移动的范围(单位为像素) | 否 | |
m_nMarginX | LDC crop窗口的offset X | 否 | |
m_nMarginY | LDC crop窗口的offset Y | 否 | |
m_pFilterWeight | 运动平滑滤波权重 | 是 | |
m_pPeakConfLevel | 置信度等级 | 是 | |
m_pPeakErrorThre | 置信度等级对应误差容忍门限 | 是 | |
m_bReverseDirectionX | 水平方向反转控制 | 是 | |
m_bReverseDirectionY | 垂直方向反转控制 | 是 | |
m_nCenterStatRatio | 中心统计比例,256为100% | 是 |
CAECFilter 参数说明
CAECFilter(AEC)模块用于自动曝光控制。
AE 基础参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bManualAEEnable | AEC模式选择:0:自动模式1:手动模式,此时曝光值使用manual参数2:锁定模式,此时曝光值锁定,不受AEC调节3:手动曝光index,此时曝光锁定为m_pExpIndexManual | 用户设置 | |
m_pMinExpTime | 最小曝光时间(参数注释包含short部分均为reserverd,以下AE参数适用此规则) | 是 | |
m_pMaxExpTime | 最大曝光时间 | 是 | |
m_pMinAnaGain | 最小模拟增益 | 是 | |
m_pMaxAnaGain | 最大模拟增益 | 是 | |
m_pMinSnsDGain | 最小sensor数字增益 | 是 | |
m_pMaxSnsDGain | 最大sensor数字增益 | 是 | |
m_pMinTotalGain | 最小总体增益 | 是 | |
m_pMaxTotalGain | 最大总体增益 | 是 | |
m_pRouteNode50Hz | 50Hz曝光表,第一列为曝光时间,第二列为总体增益,第三列为精确增益控制(reserverd) | 是 | |
m_pRouteNode60Hz | 60Hz曝光表,第一列为曝光时间,第二列为总体增益,第三列为精确增益控制(reserverd) | 是 | |
m_pMeteringMatrix | 16x12测光权重表 | 用户设置 | |
m_bLumaCalcMode | Luma计算方式 0:RGB max 1:Y average | 用户设置 | |
m_bQuickResponseEnable | AE快速响应开关,使能时立刻调节AE | 用户设置 |
AE 目标亮度控制
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bAdvancedAECEnable | 目标亮度控制参数0:使用m_pTargetRange[1]作为目标亮度1:动态计算目标亮度,目标亮度区间[m_pTargetRange[0], m_pTargetRange[1]] | 用户设置 | |
m_nCompensation | 目标亮度补偿系数,100为一倍 | 是 | |
m_nSensitivityRatio | 拍照与预览感光度比,256为一倍 | 用户设置 | |
m_pSatRefBin | 饱和点参考值,Target约束为直方图[m_pSatRefBin[0],255]之间的像素占比落入[m_pSatRefPerThr [0][0]/10000)%, m_ pSatRefPerThr [0][1]/10000)%] | 是 | |
m_pSatRefPerThr | 饱和点占比上下限 | 是 | |
m_pExpIndexThre | 曝光门限,与四组m_pLumaBlockWeight对应,用于选择哪组m_pLumaBlockWeight参与计算权重,(见Exp_index-luma_weight示意图) | 用户设置 | |
m_pLumaBlockWeight | 四组亮度块权重表,每组中Weight[i][0]对应low_luma; Weight[i][1]对应mid_luma;Weight[i][2]对应high_luma; (见Exp_index-luma_weight示意图/Luma-Weight示意图) | 用户设置 | |
m_pLumaBlockThre | 亮度块门限,用于控制亮度块的权重曲线(Luma-Weight示意图) | 用户设置 | |
m_pLuma7ZoneWeight | 统计窗口与 6个sub ROI权重表 | 用户设置 | |
m_pTargetRange | 目标亮度门限 | 是 | |
m_pTargetDeclineRatio | 目标亮度随gain调整参数,gain的节点为2的N次方 | 是 | 可随Gain变化 |

Exp_index – luma_weight 示意图

Luma – weight 示意图
AE 模式控制
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bLumaSelectOption | 0:亮度计算不参考AEM中的6个sub ROI1:亮度计算参考AEM中的6个sub ROI | ||
m_nStrategyMode | AE调整策略选择:0:自动模式1:高光优先,即优先保证高亮部分曝光适合2:低光优先,即优先保证低亮部分曝光适合 | ||
m_bAntiFlickerEnable | 去抖使能:0:关闭去抖动,此时曝光时间不受灯光闪烁限制1:使能去抖动,此时曝光时间限制为灯光闪烁周期的整数倍 | ||
m_nAntiFlickerFreq | 去抖频率选择:0:50Hz 1:60Hz |
AE 收敛控制
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nTolerance | 目标亮度误差容忍度,统计亮度处于[target±m_nTolerance]时AE将不做调整 | 是 | |
m_nStableRange | 稳定亮度区间:当AE收敛时,若统计亮度(mean)与目标亮度(target)的差值大于m_nStableRange,则调整模拟增益用于补偿 | 是 | |
m_nSmoothness | AE收敛平滑度调节,值越小,收敛越平滑 | 是 | |
m_pStableRefFrame | 稳定参考帧数,当稳定帧数大于m_pStableRefFrame,AE认为当前场景AE稳定 | 是 | |
m_pUnStableRefFrame | 不稳定参考帧数,当不稳定帧数大于m_pUnStableRefFrame,AE认为当前场景AE不稳定 | 是 | |
m_nDualTargetBlendWeight | 上一次目标亮度与当前目标亮度融合比例,8为1:1;16表示全用当前目标亮度 | 是 | |
m_pFastStep | 大步长调整折扣比例, m_pFastStep=256(且不受MaxFastRatio钳制时)表示一步调整到target(见step-target示意图) | 是 | |
m_pFastStepRangePer | 大步长门限,满足下述条件使用大步长 | current_luma – target_luma | > m_nFastStepRangePer*target_luma |
m_pFastStepMinRange | 大步长门限下限值 | 是 | |
m_pSlowStep | 小步长调整折扣比例,(同m_pFastStep,见step-target示意图) | 是 | |
m_pSlowStepRangePer | 小步长门限,满足下述条件使用小步长m_nSlowStepRangePer*target < | current_luma – target | < m_nFastStepRangePer*target |
m_pSlowStepMinRange | 小步长门限下限值 | 是 | |
m_pFineStep | 细步长调整折扣比例,(同m_pFastStep,见step-target示意图) | 是 | |
m_pMaxFastRatio | 最大大步调整比例(Q8):增曝光时,最大大步调整比例为m_pMaxFastRatio;减曝光时,最大大步调整比例为65536/m_nMaxFastRatio; | 是 | |
m_pMaxSlowRatio | 最大小步调节比例(Q8):增曝光时,小步调节比例限制区间[256 + m_nMaxFineRatio, 256 + m_nMaxSlowRatio];减曝光时,小步调节比例限制区间[256 - m_nMaxSlowRatio, 256 - m_nMaxFineRatio]; | 是 | |
m_pMaxFineRatio | 最大细步调节比例(Q8) | 否 | |
m_pMinFineRatio | 最小细步调节比例增曝光时,小步调节比例限制区间[256 + m_nMinFineRatio, 256 + m_nMaxFineRatio];减曝光时,小步调节比例限制区间[256 - m_nMaxFineRatio, 256 - m_nMinFineRatio]; | 否 | |
m_pAjustSplitFrameNum | 单步调整所需次数(第1列reserved) | 否 | |
m_pSingleStepAdjustLumaThr | 单次调节亮度阈值(第1列reserved),与m_pAjustSplitFrameNum共同决定单次调节最大luma值Single_luma_max = max((target - mean)/AjustSplitFrameNum,SingleStepAdjustLumaThr)(增曝光时,若依据adjustRatio调整的luma超过Single_luma_max,则adjustRatio= 256 + Single_luma_max 256 / mean )(减曝光时,若依据adjustRatio调整的luma超过Single_luma_max,则adjustRatio= 256 - Single_luma_max 256 / mean ) | 否 | |
m_pFaceAjustSplitFrameNum | 参数含义同m_pAjustSplitFrameNum,face AE模式下有效 | 否 | |
m_pFaceSingleStepAdjustLumaThr | 参数含义同m_pSingleStepAdjustLumaThr,face AE模式下有效 | 否 |

Step – target 示意图

Luma – stpe 示意图
自动动态范围补偿增益计算
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nDarkRefBin | 暗区像素亮度上限参考值,计算暗区亮度时,统计范围不会超过该值 | 是 | |
m_bLumaPredict | DRCgain计算亮度预测:0:计算DRCgain时不修正(当帧统计当帧apply LTM时)1:计算DRCgain时修正(当帧统计下帧apply LTM时) | ||
m_nDarkPerThrL | 暗区像素亮度百分比下限,暗区像素数目百分比低于该值时,DRCGainDark为1,(见图示pixelNumPercent-DRCGainDark示意图) | ||
m_nDarkPerThrH | 暗区像素亮度百分比上限,暗区像素数目百分比高于该值时,暗区像素全部参与计算DRCGainDark,(见图示pixelNumPercent-DRCGainDark示意图) | ||
m_nDarkTarget | 暗区期望达到的亮度值,值越大 ,最终计算出的DRCGainDark越大 | ||
m_nMaxDRCGain | 最大DRC增益 | 是 | |
m_nMaxDRCGainDark | 最大DRC Dark增益 | 是 |

PixelNumPercent - DRCGainDark 示意图
Lux 定标
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nCalibExposureIndex | 亮度定标的曝光索引 | 是 | |
m_nCalibSceneLum | 亮度定标的场景亮度 | 是 | |
m_nCalibSceneLux | 定标场景对应的实际照度 | 是 |
AEC manual 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_pExpTimeManual | 手动曝光时间,AEC处于手动模式时生效 | ||
m_pAnaGainManual | 手动模拟增益,AEC处于手动模式时生效 | ||
m_pSnsDGainManual | 手动sensor数字增益,AEC处于手动模式时生效 | ||
m_pTotalGainManual | 手动总体增益,AEC处于手动模式时生效 | ||
m_pExpIndexManual | 手动曝光index,AEC处于手动模式时生效 |
AEC frameinfo
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nFrameCounter | AE帧计数 | - | 只读 |
m_pExpTimeLong | 曝光时间(us) | - | 只读 |
m_pAnaGainLong | 模拟增益(Q8) | - | 只读 |
m_pSnsDGainLong | sensor数字增益(Q12) | - | 只读 |
m_pIspDGainLong | ISP数字增益(Q12) | - | 只读 |
m_pTotalGainLong | 总增益(Q8) | - | 只读 |
m_pExpIndexLong | 曝光索引(曝光时间 * 总增益 / 256) | - | 只读 |
m_pTotalGainDBLong | 总增益(db) | - | 只读 |
m_pExpTimeShort | Reserved | - | 只读 |
m_pAnaGainShort | Reserved | - | 只读 |
m_pSnsDGainShort | Reserved | - | 只读 |
m_pIspDGainShort | Reserved | - | 只读 |
m_pTotalGainShort | Reserved | - | 只读 |
m_pExpIndexShort | Reserved | - | 只读 |
m_pTotalGainDBShort | Reserved | - | 只读 |
m_nCurHdrRatio | Reserved | - | 只读 |
m_nHistPixelNum | 参与直方图统计的像素数 | - | 只读 |
m_pMeanLuma | AE计算亮度,[0]:long, [1]: Reserved | - | 只读 |
m_pTargetLuma | AE目标亮度,[0]:long, [1]: Reserved | - | 只读 |
m_pLuma7Zone | AE主窗口及6个副窗口luma | - | 只读 |
m_pAERouteNum | AE曝光节点,[0]:long, [1]: Reserved | - | 只读 |
m_pRouteNodeLong | 长帧曝光表 | - | 只读 |
m_pADNodeLong | Sensor again与dgain分配表 | - | 只读 |
m_pLumaMatrixLong | 亮度缩略图 | - | 只读 |
m_pHistLong | 直方图 | - | 只读 |
m_pRouteNodeShort | Reserved | - | 只读 |
m_pADNodeShort | Reserved | - | 只读 |
m_pLumaMatrixShort | Reserved | - | 只读 |
m_pHistShort | Reserved | - | 只读 |
m_pRefSaturateNum | 参考过曝像素数,[0]:long, [1]: Reserved | - | 只读 |
m_pCurSaturateNum | 当前过曝像素数,[0]:long, [1]: Reserved | - | 只读 |
m_pEstSaturateNum | 预估过曝像素数,预估当统计亮度达到目标亮度上限时过曝像素数,[0]:long, [1]:Reserved | - | 只读 |
m_pAdjustRatio | AE调节比例 | - | 只读 |
m_pStableFlag | AE稳定标志,[0]:long, [1]: Reserved | - | 只读 |
m_pStableFlagBuf | AE帧序列稳定标志,[0]:long, [1]: Reserved | - | 只读 |
m_pUnStableFlagBuf | AE帧序列不稳定标志,[0]:long, [1]: Reserved | - | 只读 |
m_nDRCGain | DRCGain当前帧AE计算结果 | - | 只读 |
m_nDRCGainDark | DRCGainDark当前帧AE计算结果 | - | 只读 |
CAFFilter 参数说明
CAFFilter 模块用于自动对焦控制。
AF 参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nAFMode | 对焦模式:0:SAF 单次聚集 1:CAF 连续聚焦 | 用户设置 | |
m_bHybridAFEnable | CDAF与PDAF混合对焦模式使能:0:关闭 1:开启 | 用户设置 | |
m_bAFTrigger | 自动对焦触发,CAF时需要使能 | 用户设置 | |
m_bMotorManualTrigger | 手动对焦触发,配合ManualMotorPosition使用 | 用户设置 | |
m_nManualMotorPosition | 手动电机位置 | 用户设置 | |
m_nFrameRate | 当前sensor帧率,用于计算AF跳帧数,建议由软件更新 | 用户设置 | |
m_nMaxSkipFrame | 最大跳过帧数 | 否 |
电机属性参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nMinMotorPosition | 最小电机位置 | 是 | |
m_nMaxMotorPosition | 最大电机位置 | 是 | |
m_nMotorResponseTime | 电机走一步的响应时间(ms),用于计算AF跳帧数,值越大,跳帧数越多 | 是 | |
m_nHyperFocalMotorPosition | 超焦距位置 | 是 |
电机运动控制参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nFirstStepDirectionJu dgeRatio | 首步方向判断百分比。AF算法运行在CDAF时,判断电机走第一步的方向所需的百分比。当电机初始位置位于整个电机范围的前百分比之内时,方向为从最小电机位置到最大电机位置;当电机初始位置位于整个电机范围的后(100%-百分比)之内时,方向为从最大电机位置到最小电机位置 | 用户设置 | |
m_bPreMoveMode | 预运动模式。AF算法运行在CDAF时,电机走第一步时0:保持初始位置 1:走到最小电机位置或者最大电机位置,具体根据初始位置与首步方向判断百分比而定 | 用户设置 | |
m_bPreMoveToInfMode | 预运动模式,运动最小电机位置。AF算法运行在CDAF时,电机走第一步时0:保持初始位置 1:走到最小电机位置 | 用户设置 | |
m_bStartFromTrueCurrent | 从当前实际位置开始使能。AF算法运行在CDAF时,电机走第一步时0:走到距离初始位置最近的微距位置 1:保持初始位置 | 用户设置 | |
m_nBackTimeRatio | 电机运动时跳帧比例,值越大,电机走一步花费的帧数越多。与m_nBackTimeDivisor共同控制电机跳帧 | 用户设置 | |
m_nBackTimeDivisor | 电机运动时跳帧控制参数,值越小,电机走一步花费的帧数越多。与m_nBackTimeRatio共同控制电机跳帧 | 用户设置 | |
m_nPreMoveTimeRatio | 预运动模式下的电机跳帧比例 | 用户设置 | |
m_nFailMotorPositionOpt ion | 聚焦失败后最终位置选择:0:算法自动选择(需正确填写超焦距马达位置) 1:最清晰 2:无穷远 3:超焦距 4:微距 5:当前位置 | 用户 设置 |
电机步长控制参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nMinMacroReverseStepNum | 当电机由最大电机位置到最小电机位置运动,检测到FV下降需要反向时,电机必须走过的步数 | 是 | |
m_nMinReverseStepNum | 当电机由最小电机位置到最大电机位置运动,检测到FV下降需要反向时,电机必须走过的步数 | 是 | |
m_nFineStepSearchNum | 细步长搜索的步数 | 是 | |
m_nCoarseStep | CDAF下粗步长 | 是 | |
m_nFineStep | CDAF下细步长 | 是 |
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nSoftwareMotorCtrlMod e | 从当前位置到目标位置的电机运动模式:(一般应用于第一步预移动到最大/最小位置;手动电机位置;开始走小步;聚焦失败时等情况 )0:软着陆模式 1:固定步长模式 2:直达模式 | 用户设置 | 见图1 |
m_nMinSafePosition | 在软着陆模式下,电机由最大电机位置到最小电机位置移动时的最小安全位置 | 用户设置 | 见图2 |
m_nMinStepRatio | 在软着陆模式下,电机由最大电机位置到最小电机位置移动的最小步长比例 | 用户设置 | 见图2 |
m_nMaxSafeStep | 在软着陆模式下,电机由最大电机位置到最小电机位置移动的最大安全步长 | 用户设置 | 见图2 |
m_nMinSafePositionMacro | 在软着陆模式下,电机由最小电机位置到最大电机位置移动时的最小安全位置 | 用户设置 | 见图2 |
m_nMinStepRatioMacro | 在软着陆模式下,电机由最小电机位置到最大电机位置移动的最小步长比例 | 用户设置 | 见图2 |
m_nMaxSafeStepMacro | 在软着陆模式下,电机由最小电机位置到最大电机位置移动的最大安全步长 | 用户设置 | 见图2 |

图 1
(每组 Conditions 条件描述-Graphic 图形演示-Output 输出为一种情况)







图 2
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bAdaptiveStep | 可变步长模式,0:不使能 1:使能 | 用户设置 | |
m_nVCMStep1Ratio | 电机步长比例1,在可变步长模式下,将电机范围划分为多个区间 | 用户设置 | 见图3 |
m_nVCMStep2Ratio | 电机步长比例2,在可变步长模式下,将电机范围划分位多个区间 | 用户设置 | 见图3 |
m_nVCMCoarseStep1 | 电机粗步长1,在可变步长模式下,根据当前电机位置在不同区间计算实际步长 | 用户设置 | 见图3 |
m_nVCMCoarseStep2 | 电机粗步长2,在可变步长模式下,根据当前电机位置在不同区间计算实际步长 | 用户设置 | 见图3 |
m_nVCMFineStep1 | 电机细步长1,在可变步长模式下,根据当前电机位置在不同区间计算实际步长 | 用户设置 | 见图3 |
m_nVCMFineStep2 | 电机细步长2,在可变步长模式下,根据当前电机位置在不同区间计算实际步长 | 用户设置 | 见图3 |
- MotorMoveStep 表示实时的步长,它根据当前电机运动方向、当前处于粗步长还是细步长模式改变,是一个变量,符号可为正,可为负,可为较大 值,可为较小值

图 3
(每组 Conditions 条件描述-Graphic 图形演示-Output 输出为一种情况)


Focus Value 判定参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_pFVDropPercentage | 预运动模式下,判定FV曲线下降的百分比。6种类型的FV各自根据增益计算 | 否 | |
m_pCurrentStartFVDropPercentage | 非预运动模式下,判定FV曲线下降的百分比。6种类型的FV各自根据增益计算 | 否 | |
m_pFVFailPercentage | 预运动模式下,判定FV曲线无效的最大FV值与最小FV值的差异百分比。若最大FV值与最小FV值差异小于阈值,则认为FV曲线过于平滑而无效。6种类型的FV各自根据增益计算。是判定聚焦失败的第一种条件。 | 否 | |
m_pCurrentStartFVFailPe rcentage | 非预运动模式下,判定FV曲线无效的最大FV值与最小FV值的差异百分比 。若最大FV值与最小FV值差异小于阈值,则认为FV曲线过于平滑而无效。6种类型的FV各自根据增益计算。是判定聚焦失败的第一种条件。 | 否 | |
m_pLastStepChangePercentage | FV曲线一直上升或一直下降判定为失效的百分比,6种类型的FV各自根据增益计算 | 否 | |
m_pWindowWeightMatrix | 5x5统计窗的FV的权重 | 否 |
PDAF 控制参数
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bPDReverseDirectionFlag | PDShift计算的步长反向标志0:不反向 1:反向 | 是 | |
m_nPDDirectConfThrRatio | PD阈值百分比,当置信度大于阈值的m_nPDDirectConfThrRatio%时,直接走出PD计算的步长 | 否 | |
m_nPDTryStepRatio | AF算法运行在混合对焦模式时,首先尝试走出的一步相对于CDAF大步的比例 | 否 | |
m_nPDCoarseStep | PDAF粗步长 | 是 | |
m_nPDFineStep | PDAF细步长 | 是 | |
m_nPDStepDiscountRatio | PDAF对由PDShift计算出的步长的打折比例 | 否 | |
m_pPDConfThr | PD信息置信度阈值 | 是 | |
m_pPDFVIncreaseRatio | AF算法运行在混合对焦模式时,FV上升的比例,用于判定尝试的一步走出后FV值是否上升,从而判定PD信息是否可信 | 否 | |
m_pPDFVDropPercentage | FV值下降的判定百分比,当AF运行在PDAF下 | 否 | |
m_pPDShiftPositionLUT_0_0m_pPDShiftPositionLUT_4_4 | 5x5窗口,PD Shift – step 查找表 | PDAF插件标定 |
连续聚焦控制
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bCAFHold | 在连续聚焦模式下,保持当前状态不变 | 用户设置 | |
m_bCAFForce | 在连续聚焦模式下,强制触发一次单次聚焦 | 用户设置 | |
m_nCAFHoldPDShiftThr | 连续聚焦模式下,判断场景稳定的PD shift门限,值越大,越容易判断为稳定 | 是 | |
m_nCAFHoldPDConfThr | 连续聚焦模式下,判断场景稳定的PD confidence门限,值越小,越容易判断为稳定 | 是 | |
m_nPreFocusMode | 在连续聚焦模式下,追焦模式使能:0:不追焦 1:半追焦(基于PD shift先尝试一次对焦) | 用户设置 | |
m_nPFPDStepDiscountRatio | Prefocus步长折扣比 | 是 | |
m_nLumaCalcOpt | Luma计算方式0:三通道分别计算 1:计算RGB最大值 2:计算加权的Y均值 | 否 | |
m_bReFocusEnable | 连续聚焦模式下,refocus使能 | 用户设置 | |
m_pRefocusLumaSADThr | CAF触发SAF时,决定是否触发的SAD门限 | 是 | |
m_nFlatSceneVarThr | 连续聚焦模式下,判断是否为平坦场景的缩略图的方差门限 | 是 | |
m_nFlatSceneLumaThr | 连续聚焦模式下,判断是否为平坦场景的亮度门限 | 是 | |
m_bStableJudgeOpt | 连续聚焦 模式下,判断场景稳定的条件:0:FV或luma满足其一 1:FV与luma均满足 | 用户设置 | |
m_nRefStableFrameNum | 在连续聚焦模式下,参考态中判定场景已经稳定的帧数 | 用户设置 | |
m_nDetStableFrameNum | 在连续聚焦模式下,检测态中判定场景已经稳定的帧数 | 用户设置 | |
m_pStableExpIndexPercentage | 在连续聚焦模式下,判定当前帧稳定的曝光量变化百分比 | 是 | |
m_pStableFVSADPercentage | 在连续聚焦模式下,判定当前帧稳定的FV的SAD百分比 | 是 | |
m_pStableLumaSADThr | 在连续聚焦模式下,判定当前帧稳定的亮度的SAD百分比 | 是 | |
m_bChangeJudgeOpt | 连续聚焦模式下,判断场景变化的条件:0:FV或luma满足其一 1:FV与luma均满足 | 否 | |
m_nChangeFrameNum | 连续聚焦模式下,判断场景变化的帧数 | 是 | |
m_nChangeStatAreaPercentage | 连续聚焦模式下,判断场景变化的AF统计窗口面积改变门限百分比,超出此门限认为场景发生改变,人脸模式有效 | 否 | |
m_nChangeStatCenterPercentage | 连续聚焦模式下,判断场景变化的AF统计窗口位置改变门限百分比,超出此门限认为场景发生改变,人脸模式有效 | 否 | |
m_pChangeExpIndexPercentage | 连续聚焦模式下,判断场景变化的曝光量变化百分比 | 是 | |
m_pChangeFVSADPercentage | 在连续聚焦模式下,判定当前帧变化的FV的SAD百分比 | 是 | |
m_pChangeLumaSADThr | 在连续聚焦模式下,判定当前帧变化的亮度的SAD百分比 | 是 | |
m_pChangePDShiftThr | 在连续聚焦模式下,判定当前帧变化的PDShift的百分比 | 否 |
前景追踪模式
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bForeGroundTrackInCoarse | 粗步长调节时前景追踪模式使能:0:不使能前景追踪 1:使能前景追踪 | 用户设置 | |
m_bForeGroundTrackInFine | 细步长调节时前景追踪模式使能:0:不使能前景追踪 1:使能前景追踪 | 用户设置 | |
m_nForeGroundTrackWindow | 前景追踪窗口:3:3x3 4:4x4 5:5x5 | 用户设置 | |
m_bForeGroundTrack | 前景追踪模式使能:0:不使能前景追踪 1:使能前景追踪 | 用户设置 | |
m_pFVBlkDropPercentage | 前景追踪模式使能下的FV值下降的判定百分比 | 否 | |
m_pFVBlkIncreasePercentage | 前景追踪模式使能下的FV值上升的判定百分比 | 否 | |
m_pFineStepStartPosSelectConf | 前景追踪模式使能下,开始走细步长时的起始位置的置信度阈值 | 否 | |
m_pFineStepEndPosSelectConf | 前景追踪模式使能下,细步长走完后最终位置的置信度阈值 | 否 |
AF frameinfo
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_nGain | 当前系统增益 ,Q4 format | - | 只读 |
m_nPDShift | PD偏移 | - | 只读 |
m_nPDConf | PD置信度 | - | 只读 |
m_nCurrentPosition | 当前电机位置 | - | 只读 |
m_nFSMStatus | AF状态机 | - | 只读 |
m_nFocusStatFlag | 聚焦状态标志0:初始 1:成功 2:失败 | - | 只读 |
m_nFocusFrameCost | 一次单次聚焦完成所花费的帧数 | - | 只读 |
m_nMotorMoveStep | 实时电机步长 | - | 只读 |
m_bCoarseFineStepFlag | 实时处于粗/细步长标志0:当前处于细步长 1:当前处于粗步长 | - | 只读 |
m_nMotorMoveSkipFrameNum | 电机每次移动跳过的帧数 | - | 只读 |
m_bStartFromMinFlag | 实时电机运动方向0:从最大电机位置到最小电机位置 1:从最小电机位置到最大电机位置 | - | 只读 |
m_bStartFromCurrentFlag | 电机初始从当前位置开始运动的标志0:从预运动位置出发 1:从初始位置出发 | - | 只读 |
m_bSoftwareMotorCtrlFlag | 从当前位置向目标位置运动过程中受到软件控制改变的标志 | - | 只读 |
m_nPositionScanNum | 电机扫描过的方向计数 | - | 只读 |
m_nPositionAdjustNum | 电机走过的位置计数 | - | 只读 |
m_pRTFVList | 实时FV值 | - | 只读 |
m_pMinFVList | 单次聚焦过程中的最小FV值 | - | 只读 |
m_pMaxFVList | 单次聚焦过程中的最大FV值 | - | 只读 |
m_pMaxFVPositionList | 单次聚焦城中的最大FV值所在的位置 | - | 只读 |
m_pFVUnchangeFlag | FV曲线过于平滑而失效的标志0:FV曲线可信 1:FV曲线失效 | - | 只读 |
m_pFailCondition | 判定本地聚焦失败的三个条件的状态0:当前条件判定聚焦成功 1:当前条件判定聚焦失败 | - | 只读 |
m_pFSMPosSingleFocus | 单次聚焦过程中,帧号-电机位置-状态机信息记录 | - | 只读 |
m_pPosFvSingleFocus | 单次聚焦过程中,帧号-6种类型FV值信息记录 | - | 只读 |
m_pRefFV | 连续聚焦模式下,记录的FV参考值 | - | 只读 |
m_pSeqFV | 连续聚焦模式下,实时FV值序列 | - | 只读 |
m_pRefLumaR | 连续聚焦模式下,记录的R通道缩略图参考值 | - | 只读 |
m_pRefLumaG | 连续聚焦模式下,记录的G通道缩略图参考值 | - | 只读 |
m_pRefLumaB | 连续聚焦模式下,记录的B通道缩略图参考值 | - | 只读 |
m_pSeqLumaR | 连续聚焦模式下,实时R通道缩略图 | - | 只读 |
m_pSeqLumaG | 连续聚焦模式下,实时G通道缩略图 | - | 只读 |
m_pSeqLumaB | 连续聚焦模式下,实时B通道缩略图 | - | 只读 |
m_nRefExpIndex | 连续聚焦模式下,参考曝光index | - | 只读 |
m_nRTExpIndex | 连续聚焦模式下,实时曝光index | - | 只读 |
m_bPDInfoDisable | 连续聚焦模式下,使用PD信息标志位 | - | 只读 |
m_nLumaAverage | 亮度均值 | - | 只读 |
m_nSceneVariance | 缩略图实时方差 | - | 只读 |
m_bSceneFlatFlag | 场景平坦标志位 | - | 只读 |
m_nChangeExpIndex | 连续聚焦模式下,当前曝光index与参考曝光index的差 | - | 只读 |
m_nChangeExpIndexThr | 连续聚焦模式下,判断场景变化的曝光index门限 | - | 只读 |
m_nChangeFVSAD | 连续聚焦模式下,实时FV与参考FV之间的SAD差 | - | 只读 |
m_nChangeFVSADThr | 连续聚焦模式下,判断场景变化的SAD门限 | - | 只读 |
m_nChangeLumaSAD | 连续聚焦模式下,实时亮度 SAD值 | - | 只读 |
m_nChangeLumaSADThr | 连续聚焦模式下,实时亮度 SAD门限 | - | 只读 |
m_nRefocusLumaSAD | CAF触发SAF时,前帧亮度SAD | - | 只读 |
m_nRefocusLumaSADThr | CAF触发SAF时,决定是否触发的SAD门限 | - | 只读 |
m_bStableExpIndexFlag | AE曝光表稳定标志位 | - | 只读 |
m_bStableFVFlag | FV稳定标志位 | - | 只读 |
m_bStableAFLumaFlag | AFM luma稳定标志位 | - | 只读 |
m_bStableAELumaFlag | AEM luma稳定标志位 | - | 只读 |
m_bPDTriggerCAF | PD触发AF标志位 | - | 只读 |
m_bFVTriggerCAF | FV触发AF标志位 | - | 只读 |
m_bLumaTriggerCAF | Luma触发AF标志位 | - | 只读 |
m_bExpIndexTriggerCAF | ExpIndex触发AF标志位 | - | 只读 |
m_bRefocusTriggerCAF | CFA触发SAF标志位 | - | 只读 |
CAWBFilter 参数说明
CAWBFilter(AWB)模块用于自动白平衡控制。
灰度世界
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bGrayWorldEn | 灰度世界模式使能:0:关闭灰度世界1:使能灰度世界,此时由灰度世界算法计算白平衡增益 | 用户设置 |
ROI 控制
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_pRoiBound | 16个ROI区域控制 | 是 | |
m_pRoiLumLutHigh | 统计块亮度上限 | 否 | |
m_pRoiLumLutLow | 统计块亮度下限 | 否 | |
m_pRoiEn | ROI使能 | 是 | |
m_pRoiWeightLut | 不同亮度索引对应的权重 | 是 | |
m_pRoiLumThre | 亮度lux索引门限 | 是 | |
m_bRoiLimitManual | 固定ROI使能:0:依据自动白点ROI及低色温统计块占比计算白点限制区域 1:白点限制区域固定为RoiCtHigh,RoiCtLow,RoiXMax,RoiXMin | ||
m_nRoiCtHigh | 白点ROI 纵坐标Y上限,在ROI区域以外的block计算白平衡时权重为0(CT(color temperature)为BlockBlue_sum(8bit) / BlockRed_sum * 1024) | 是 | |
m_nRoiCtLow | 白点ROI 纵坐标Y下限 | 是 | |
m_nRoiXMax | 白点ROI 横坐标X上限(X为BlockBlue_sum BlockRed_sum / BlockGreen_sum / BlockGreen_sum 1024) | 是 | |
m_nRoiXMin | 白点ROI 横坐标X下限 | 是 | |
m_pRoiCtHighAuto | 不同亮度下白点ROI 纵坐标Y上限 | 是 | |
m_nRoiCtLowAuto | 不同亮度下自动白点ROI 纵坐标Y下限 | 是 | |
m_nRoiXMaxAuto | 不同亮度下自动白点ROI 横坐标X上限 | 是 | |
m_nRoiXMinAuto | 不同亮度下自动白点ROI 横坐标X下限 | 是 | |
m_nValidNum | 每个ROI生效的最小块数,处于统计亮度区间的块的数目小于该值时,该ROI不参与白平衡计算 | 否 | |
m_bWeightOnSum | Block权重计算方式:0:以block的和计算 1:以block的rgb gain计算 | 否 |
白平衡 Gain 控制
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_pAWBGainLimit | 最终WB gain限制区域 | 是 | |
m_nAWBCTShift | WB Gain向上偏移距离,用于将低色温场景往暖色调偏移 | 是 | |
m_pAWBCTShiftThr | WB Gain偏移Y门限:Y<AWBCTShiftThr[0]时WB Gain向上偏移m_nAWBCTShift,Y>AWBCTShiftThr[1]时WB Gain不偏移,中间为插值区域 | 是 |
混光场景降高色温权重
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_sRoiBoundDayLight | 高低色温混合场景,高色温统计块框选区域,落入该区域的统计块为高色温统计块 | 是 | |
m_pLowCtNumThr | 低色温统计块所占千分比门限,(见图示lowCtLightPermillage-ratio)低色温统计块所占千分比>LowCtNumThr[0]时,高色温统计块权重开始降低;低色温统计块所占千分比≥LowCtNumThr[1]时,高色温统计块权重降到最低。 | 是 | |
m_pDayLightNumThr | 高色温统计块所占千分比门限,(见图示dayLightPermillage-ratio)高色温统计块所占千分比<DayLightNumThr[1]时, 高色温统计块权重开始降低;高色温统计块所占千分比≤DayLightNumThr[0]时,高色温统计块权重不再降低,与m_pLowCtNumThr共同作用决定高色温统计块权重降低的基础强度baseRatio。 | 是 | |
m_pLowCtThr | 高低色温混合场景,降高色温统计块权重的Y门限(见图示CtThr – ProtectRatio )Y<m_pLowCtThr[1]的统计块为低色温统计块 | 是 | |
m_pLowCtProtectRatio | 降高色温统计块权重系数,值越小,高色温统计块权重越低,与baseRatio共同决定统计块的权重(见图示CtThr – ProtectRatio ) | 是 | 随CtThr变化 |
m_nLog2CwtOverA | CWF与A光权重比 | 否 |

CtThr – ProtectRatio 示意图

lowCtLightPermillage-ratio 示意图

dayLightPermillage-ratio 示意图
绿区控制
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_pRoiBoundG | 绿区ROI控制 | 是 | |
m_pRoiLumLutHighG | 绿区统计块亮度上限 | 是 | |
m_pRoiLumLutLowG | 绿区统计块亮度下限 | 是 | |
m_bGreenShiftEn | 绿区ROI使能 | 用户设置 | |
m_pGreenLumThre | 绿区不同亮度索引下的权重表 | 是 | |
m_nGreenShiftMax | 绿区权重上限:与exposure shift相乘得到最终的shift权重,最大32,完全偏向outdoor gain | 是 | |
m_pGreenNumThre | 绿区统计块门限, 落在绿区的统计块的数目在此区间则进入green shift | 是 | |
m_pOutdoorGain | 绿区白平衡目标增益 | 是 |
AWB frameinfo
参数名 | 说明 | 建议调试 | 特殊性 |
---|---|---|---|
m_bAwbCalStatus | AWB计算状态 | - | 只读 |
CurrentResult | 当前应用白平衡增 益 | - | 只读 |
CurrentTarget | AWB计算得到的目标白平衡增益 | - | 只读 |
m_nSceneLux | AWB debug参数,当前AE计算得到的场景照度 | - | 只读 |
m_nValidBlkNum | 有效统计块数 | - | 只读 |
m_nLowCtBlkRatio | 低色温统计块占千分比 | - | 只读 |
m_pCtLimit | 当前ROI范围(X_Max,X_Min,CT_High,CT_Low) | - | 只读 |
m_nDayLightBlkRatio | D光统计块占千分比 | - | 只读 |
m_nGreenShiftWeight | 绿区偏移权重 | - | 只读 |
m_pStatBlkR | R通道统计值 | - | 只读 |
m_pStatBlkG | G通道统计值 | - | 只读 |
m_pStatBlkB | B通道统计值 | - | 只读 |
m_pBlkCtX | 统计块横坐标X | - | 只读 |
m_pBlkCtY | 统计块纵坐标Y | - | 只读 |
m_pBlkRoiId | 统计块所处ROI | - | 只读 |
m_pBlkWeight | 统计块参与白平衡计算的权重 | - | 只读 |
m_pDebugBlcokData[23][31] | AWB统计块的RGB值 | - | 只读 |
C3DNRFirmwareFilter 调试说明
C3DNRFirmwareFilter(NR)模块用于 2D 与 3D 去噪。
NR 使能
参数名 | 说明 | 建议修改 | 特殊性 |
---|---|---|---|
m_nTnrEb | 3DNR使能,仅用于控制3DNR | 用户设置 | |
m_pTnr3dYEb | 3DNR 亮度去噪开关 | 是 | 可随Gain/Layer变化 |
m_pTnr3dUVEb | 3DNR 颜色去噪开关 | 是 | 可随Gain/Layer变化 |
m_pTnr2dYEb | 2DNR 亮度去噪开关 | 是 | 可随Gain/Layer变化 |
2D NR 基础控制参数
参数名 | 说明 | 建议修改 | 特殊性 |
---|---|---|---|
m_pMax_diff_thr | 最大亮度参考门限,Dynamic使能时有效 | 否 | |
m_pSig_gain | 亮度参考门限,值越小,越多区域被去噪 | 是 | 可随Gain/Layer变化 |
m_pAback_alpha | 亮度噪声回加,值越大,回加的亮度噪声的越多 | 是 | 可随Gain/Layer变化 |
m_pCnrSig_y | CNR参考Y门限,值越大,越多区域被去噪 | 是 | 可随Gain/Layer变化 |
m_pCnrSig_uv | CNR参考UV门限,值越大,越多区域被去噪 | 是 | 可随Gain/Layer变化 |
m_pCnrAback_alpha | 颜色噪声回加,值越大,回加的颜色噪声的越多 | 是 | 可随Gain/Layer变化 |
m_pCnrSig_uv_shift | CNR门限左移系数,(1表示门限左移一位,即乘2) | 是 | 可随Gain/Layer变化 |
m_pGainIndex | 增益索引,建议保持缺省值 | 否 | |
m_bDynamic_en | 去噪门限自适应使能,打开时亮度去噪门限的ratio依据图像内容动态计算 | 否 | |
m_nGlobalYnrStrength | 全局亮度噪声去噪强度 | 是 | 可随Gain/Layer变化 |
m_nGlobalCnrStrength | 全局颜色噪声去噪强度 | 是 | 可随Gain/Layer变化 |
部分参数可随 Gain/Layer 调整,以 m_pCnrSig_y 为例:
Column 表示 Gain 的档位,Column[0]表示 1 倍 gain;Column[11]表示 2048 倍 gain; Row 表示不同 layer 的参数,Row[0]表示 layer 0 的参数;Row[4]表示 layer 4 的参数;
(layer 越高,对应处理图像越高频的区域)

2D NR 亮度控制参数
参数名 | 说明 | 建议修改 | 特殊性 |
---|---|---|---|
m_bLuma_en | YNR随亮度变化使能 | 用户设置 | |
m_pLuma_sig | 随亮度变化, 2D YNR强度,level 0-16 对应亮度0-255, 16等分 | 是 | 可随Gain/Luma变化 |
m_bCnrLuma_en | CNR强度随亮度控制使能 | 用户设置 | |
m_pCnrLuma_sig | 随亮度变化, 2D CNR强度,level 0-16 对应亮度0-255, 16等分 | 是 | 可随Gain/Luma变化 |