10. RadialShading

10.1. 功能描述

以同心圆形式对镜头四周暗角进行矫正

10.2. API 参考

10.2.1. CVI_ISP_SetRadialShadingAttr

【描述】

设置Radial LSC 参数

【语法】

CVI_S32 CVI_ISP_SetRadialShadingAttr(VI_PIPE ViPipe, const ISP_RADIAL_SHADING_ATTR_S *pstRadialShadingAttr);

【参数】

参数名称

描述

输入/输出

ViPipe

VI_PIPE 号

输入

pstRadialShadingAttr

设置Radial LSC 参数

输入

【返回值】

返回值

描述

0

成功

非 0

失败，其值为 错误码。

【需求】

  • 头文件: cvi_isp.h, cvi_comm_isp.h

  • 库文件: libisp.so

【注意】

cv180x & cv181x不支持此功能

【举例】

无

【相关主题】

10.2.2. CVI_ISP_GetRadialShadingAttr

【描述】

获取Radial LSC 参数

【语法】

CVI_S32 CVI_ISP_GetRadialShadingAttr(VI_PIPE ViPipe, ISP_RADIAL_SHADING_ATTR_S *pstRadialShadingAttr);

【参数】

参数名称

描述

输入/输出

ViPipe

VI_PIPE 号

输入

pstRadialShadingAttr

Radial LSC 参数

输出

【返回值】

返回值

描述

0

成功

非 0

失败，其值为 错误码。

【需求】

  • 头文件: cvi_isp.h, cvi_comm_isp.h

  • 库文件: libisp.so

【注意】

cv180x & cv181x不支持此功能

【举例】

无

【相关主题】

10.2.3. CVI_ISP_SetRadialShadingGainLutAttr

【描述】

设置LSC Radius形式补偿增益表

【语法】

CVI_S32 CVI_ISP_SetRadialShadingGainLutAttr(VI_PIPE ViPipe, const ISP_RADIAL_SHADING_GAIN_LUT_ATTR_S *pstRadialShadingGainLutAttr);

【参数】

参数名称

描述

输入/输出

ViPipe

VI_PIPE 号

输入

pstRadialShadingGainLutAttr

LSC Radius形式补偿增益表

输入

【返回值】

返回值

描述

0

成功

非 0

失败，其值为 错误码。

【需求】

  • 头文件: cvi_isp.h, cvi_comm_isp.h

  • 库文件: libisp.so

【注意】

cv180x & cv181x不支持此功能

【举例】

无

【相关主题】

10.2.4. CVI_ISP_GetRadialShadingGainLutAttr

【描述】

获取LSC Radius形式补偿增益表

【语法】

CVI_S32 CVI_ISP_GetRadialShadingGainLutAttr(VI_PIPE ViPipe, const ISP_RADIAL_SHADING_GAIN_LUT_ATTR_S *pstRadialShadingGainLutAttr);

【参数】

参数名称

描述

输入/输出

ViPipe

VI_PIPE 号

输入

pstRadialShadingGainLutAttr

LSC Radius形式补偿增益表

输出

【返回值】

返回值

描述

0

成功

非 0

失败，其值为 错误码。

【需求】

  • 头文件: cvi_isp.h, cvi_comm_isp.h

  • 库文件: libisp.so

【注意】

cv180x & cv181x不支持此功能

【举例】

无

【相关主题】

10.3. 数据类型

10.3.1. ISP_RADIAL_SHADING_MANUAL_ATTR_S

【说明】

Radial LSC 手动参数

【定义】

typedef struct _ISP_RADIAL_SHADING_MANUAL_ATTR_S {
CVI_U16 RadiusStr;
CVI_U16 RadiusIRStr;
} ISP_RADIAL_SHADING_MANUAL_ATTR_S;

【成员】

成员名称

描述

RadiusStr

LSC 补偿强度

取值范围： [0x0, 0xfff]

数据类型： CVI_U16

RadiusIRStr

LSC IR补偿强度

取值范围： [0x0, 0xfff]

数据类型： CVI_U16

【注意事项】

无

【相关数据类型及接口】

10.3.2. ISP_RADIAL_SHADING_AUTO_ATTR_S

【说明】

Radial LSC 自动参数

【定义】

typedef struct _ISP_RADIAL_SHADING_AUTO_ATTR_S {
CVI_U16 RadiusStr[ISP_AUTO_ISO_STRENGTH_NUM];
CVI_U16 RadiusIRStr[ISP_AUTO_ISO_STRENGTH_NUM];
} ISP_RADIAL_SHADING_AUTO_ATTR_S;

【成员】

成员名称

描述

RadiusStr

LSC 补偿强度

取值范围： [0x0, 0xfff]

数据类型： CVI_U16

RadiusIRStr

LSC IR补偿强度

取值范围： [0x0, 0xfff]

数据类型： CVI_U16

【注意事项】

无

【相关数据类型及接口】

10.3.3. ISP_RADIAL_SHADING_ATTR_S

【说明】

Radial LSC 参数

【定义】

typedef struct _ISP_RADIAL_SHADING_ATTR_S {
   CVI_BOOL Enable;
   ISP_OP_TYPE_E enOpType;
   CVI_U8 UpdateInterval;
   CVI_U16 CenterX;
   CVI_U16 CenterY;
   CVI_U16 RadiusScaleRGB;
   CVI_U16 RadiusScaleIR;
   ISP_RADIAL_SHADING_MANUAL_ATTR_S stManual;
   ISP_RADIAL_SHADING_AUTO_ATTR_S stAuto;
} ISP_RADIAL_SHADING_ATTR_S;

【成员】

成员名称

描述

Enable

LSC 功能使能。

0: 关闭。

1: 使能。

取值范围：[0, 1]

数据类型：CVI_BOOL

enOpType

选择手动或自动模式

UpdateInterval

影响参数更新间隔,值越大画面变化越慢, 效能越好。

取值范围： [0x0, 0xff]

数据类型： CVI_U8

CenterX

图像传感器镜心X方向坐标

取值范围： [0x0, 0x1fff]

数据类型： CVI_U16

CenterY

图像传感器镜心Y方向坐标

取值范围： [0x0, 0x1fff]

数据类型： CVI_U16

RadiusScaleRGB

RGB Radius与补偿增益表标准化系数

取值范围： [0x0, 0x7fff]

数据类型： CVI_U16

RadiusScaleIR

IR Radius与补偿增益表标准化系数

取值范围： [0x0, 0x7fff]

数据类型： CVI_U16

stManual

手动参数

stAuto

自动参数

【注意事项】

无

【相关数据类型及接口】

10.3.4. ISP_RADIAL_SHADING_GAIN_LUT_S

【说明】

LSC Radius形式补偿增益表细项

【定义】

typedef struct _ISP_RADIAL_SHADING_GAIN_LUT_S {
   CVI_U16 ColorTemperature;
   CVI_U16 RGain[ISP_RLSC_WINDOW_SIZE];
   CVI_U16 GGain[ISP_RLSC_WINDOW_SIZE];
   CVI_U16 BGain[ISP_RLSC_WINDOW_SIZE];
   CVI_U16 IrGain[ISP_RLSC_WINDOW_SIZE];
} ISP_RADIAL_SHADING_GAIN_LUT_S;

【成员】

成员名称

描述

ColorTemperature

色温自适

应LSC补偿增益表所对应之色温，单位为 K

取值范围： [0x0, 0xffff]

数据类型： CVI_U16

RGain

LSC Radius形式红色通道增益

取值范围： [0x0, 0xfff]

数据类型： CVI_U16

GGain

LSC Radius形式绿色通道增益

取值范围： [0x0, 0xfff]

数据类型： CVI_U16

BGain

LSC Radius形式蓝色通道增益

取值范围： [0x0, 0xfff]

数据类型： CVI_U16

IrGain

LSC Radius形式IR色通道增益

取值范围： [0x0, 0xfff]

数据类型： CVI_U16

【注意事项】

无

【相关数据类型及接口】

10.3.5. ISP_RADIAL_SHADING_GAIN_LUT_ATTR_S

【说明】

LSC Radius形式补偿增益表

【定义】

typedef struct _ISP_RADIAL_SHADING_GAIN_LUT_ATTR_S {
   CVI_U8 Size;
   CVI_U16 ColorTemperature[ISP_RLSC_COLOR_TEMPERATURE_SIZE];
   ISP_RADIAL_SHADING_GAIN_LUT_S RLscGainLut[ISP_RLSC_COLOR_TEMPERATURE_SIZE];
} ISP_RADIAL_SHADING_GAIN_LUT_ATTR_S;

【成员】

成员名称

描述

Size

色温自适应LSC补偿增益表数量

取值范围： [0x1, 0x7]

数据类型： CVI_U8

ColorTemperature

色温自适

应LSC补偿增益表所对应之色温，单位为 K

取值范围： [0x0, 0xffff]

数据类型： CVI_U16

RLscGainLut

LSC Radius形式补偿增益表细项

取值范围： [0x0, 0xfff]

数据类型： CVI_U16

【注意事项】

无

【相关数据类型及接口】