KSJ_WB_CALLBACK.
typedef void(__stdcall * KSJ_WB_CALLBACK_EX )(float fMatrixR, float fMatrixG, float fMatrixB, void *lpContext)
 The nPhi decide auto calculate Matrix.

枚举

enum  KSJ_WB_MODE {
  KSJ_WB_DISABLE, KSJ_SWB_PRESETTINGS, KSJ_SWB_AUTO_ONCE, KSJ_SWB_AUTO_CONITNUOUS,
  KSJ_SWB_MANUAL, KSJ_HWB_PRESETTINGS, KSJ_HWB_AUTO_ONCE, KSJ_HWB_AUTO_CONITNUOUS,
  KSJ_HWB_MANUAL
}
 

白平衡模式枚举类型

更多...
enum  KSJ_COLOR_TEMPRATURE { KSJ_CT_5000K, KSJ_CT_6500K, KSJ_CT_2800K }
 

色温枚举

更多...
enum  KSJ_CCM_MODE {
  KSJ_CCM_DISABLE, KSJ_SCCM_PRESETTINGS, KSJ_SCCM_MANUAL, KSJ_HCCM_PRESETTINGS,
  KSJ_HCCM_MANUAL
}
 

颜色校正矩阵枚举

更多...

函数

KSJ_API int __stdcall KSJ_WhiteBalanceSet (int nIndex, KSJ_WB_MODE WbMode)
 KSJ_WhiteBalanceSet.
KSJ_API int __stdcall KSJ_WhiteBalanceGet (int nIndex, KSJ_WB_MODE *pWbMode)
 KSJ_WhiteBalanceGet.
KSJ_API int __stdcall KSJ_WhiteBalanceMatrixSet (int nIndex, float fMatrix[3])
 KSJ_WhiteBalanceMatrixSet.
KSJ_API int __stdcall KSJ_WhiteBalanceMatrixGet (int nIndex, float fMatrix[3])
 KSJ_WhiteBalanceMatrixGet.
KSJ_API int __stdcall KSJ_WhiteBalanceAutoSetCallBack (int nIndex, KSJ_WB_CALLBACK pfCallBack, void *lpContext)
 KSJ_WhiteBalanceAutoSetCallBack.
KSJ_API int __stdcall KSJ_WhiteBalanceAutoSetCallBackEx (int nIndex, KSJ_WB_CALLBACK_EX pfCallBackEx, void *lpContext)
 KSJ_WhiteBalanceAutoSetCallBackEx.
KSJ_API int __stdcall KSJ_WhiteBalanceAutoSet (int nIndex, int nPhi)
 KSJ_WhiteBalanceAutoSet.
KSJ_API int __stdcall KSJ_WhiteBalanceAutoGet (int nIndex, int *pnPhi)
 KSJ_WhiteBalanceAutoGet.
KSJ_API int __stdcall KSJ_WhiteBalancePresettingSet (int nIndex, KSJ_COLOR_TEMPRATURE WbPresetting)
 KSJ_WhiteBalancePresettingSet.
KSJ_API int __stdcall KSJ_WhiteBalancePresettingGet (int nIndex, KSJ_COLOR_TEMPRATURE *pWbPresetting)
 KSJ_WhiteBalancePresettingGet.
KSJ_API int __stdcall KSJ_ColorCorrectionSet (int nIndex, KSJ_CCM_MODE CcmMode)
 KSJ_ColorCorrectionSet.
KSJ_API int __stdcall KSJ_ColorCorrectionGet (int nIndex, KSJ_CCM_MODE *pCcmMode)
 KSJ_ColorCorrectionGet.
KSJ_API int __stdcall KSJ_ColorCorrectionMatrixSet (int nIndex, float fMatrix[3][3])
 KSJ_ColorCorrectionMatrixSet.
KSJ_API int __stdcall KSJ_ColorCorrectionMatrixGet (int nIndex, float fMatrix[3][3])
 KSJ_ColorCorrectionMatrixGet.
KSJ_API int __stdcall KSJ_ColorCorrectionPresettingSet (int nIndex, KSJ_COLOR_TEMPRATURE CcmPresetting)
 KSJ_ColorCorrectionPresettingSet.
KSJ_API int __stdcall KSJ_ColorCorrectionPresettingGet (int nIndex, KSJ_COLOR_TEMPRATURE *pCcmPresetting)
 KSJ_ColorCorrectionPresettingGet.

类型定义文档

typedef void(__stdcall * KSJ_WB_CALLBACK)(float fMatrix[3], void *lpContext)

KSJ_WB_CALLBACK.

-----------------------------------------------------------------------------

白平衡回调函数类型定义

参数:
fMatrix [out] 回传给用户的白平衡校正矩阵
lpContext [out] 用户调用KSJ_WhiteBalanceAutoSetCallBack时传入的上下文指针
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 非手动白平衡模式时，回调返回当前的白平衡校正矩阵
-----------------------------------------------------------------------------
typedef void(__stdcall * KSJ_WB_CALLBACK_EX)(float fMatrixR, float fMatrixG, float fMatrixB, void *lpContext)

The nPhi decide auto calculate Matrix.

-----------------------------------------------------------------------------

KSJ_WB_CALLBACK_EX 白平衡回调函数类型定义

参数:
fMatrixR [out] 回传给用户的白平衡红色校正值
fMatrixG [out] 回传给用户的白平衡绿色校正值
fMatrixB [out] 回传给用户的白平衡蓝色校正值
lpContext [out] 用户调用KSJ_WhiteBalanceAutoSetCallBack时传入的上下文指针
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 非手动白平衡模式时，回调返回当前的白平衡校正矩阵
-----------------------------------------------------------------------------

枚举类型文档

enum KSJ_WB_MODE

白平衡模式枚举类型

枚举值:
KSJ_WB_DISABLE 

关闭白平衡

KSJ_SWB_PRESETTINGS 

软件预设白平衡

KSJ_SWB_AUTO_ONCE 

软件一次白平衡

KSJ_SWB_AUTO_CONITNUOUS 

软件连续白平衡

KSJ_SWB_MANUAL 

软件手动白平衡

KSJ_HWB_PRESETTINGS 

硬件预设白平衡

KSJ_HWB_AUTO_ONCE 

硬件一次白平衡

KSJ_HWB_AUTO_CONITNUOUS 

硬件连续白平衡

KSJ_HWB_MANUAL 

硬件手动白平衡

enum KSJ_COLOR_TEMPRATURE

色温枚举

枚举值:
KSJ_CT_5000K 

5000K色温

KSJ_CT_6500K 

6500K色温

KSJ_CT_2800K 

2800K色温

enum KSJ_CCM_MODE

颜色校正矩阵枚举

枚举值:
KSJ_CCM_DISABLE 

不进行颜色校正操作

KSJ_SCCM_PRESETTINGS 

软件预设值校正

KSJ_SCCM_MANUAL 

软件手工输入矩阵值校正

KSJ_HCCM_PRESETTINGS 

硬件预设值校正

KSJ_HCCM_MANUAL 

软件手工输入矩阵值校正

函数文档

KSJ_API int __stdcall KSJ_WhiteBalanceSet ( int  nIndex,
KSJ_WB_MODE  WbMode 
)

KSJ_WhiteBalanceSet.

-----------------------------------------------------------------------------

设置白平衡模式

参数:
nIndex [in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
WbMode [in] 设置的白平衡模式
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_WhiteBalanceGet ( int  nIndex,
KSJ_WB_MODE *  pWbMode 
)

KSJ_WhiteBalanceGet.

-----------------------------------------------------------------------------

获取当前的白平衡模式

参数:
nIndex [in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
pWbMode [out] 返回相机白平衡模式
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_WhiteBalanceMatrixSet ( int  nIndex,
float  fMatrix[3] 
)

KSJ_WhiteBalanceMatrixSet.

-----------------------------------------------------------------------------

手动设置白平衡校正矩阵

参数:
nIndex [in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
fMatrix [in] 用于设置白平衡校正矩阵，校正矩阵为1x3的数组，其中中R、G、B三个分量的系数分别为fMatrix [0] 、fMatrix [1] 、fMatrix [2]
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 白平衡计算公式：Rw = fMatrix[0] * R, Gw = fMatrix[1] * G, Bw = fMatrix[1] * B
  • 三个分量的取值范围为： 0 - 5
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_WhiteBalanceMatrixGet ( int  nIndex,
float  fMatrix[3] 
)

KSJ_WhiteBalanceMatrixGet.

-----------------------------------------------------------------------------

获取当前的白平衡校正矩阵

参数:
nIndex [in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
fMatrix [out] 返回获取的白平衡调整系数，数组中R、G、B三个分量的系数分别为fMatrix [0] 、fMatrix [1] 、fMatrix [2]
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_WhiteBalanceAutoSetCallBack ( int  nIndex,
KSJ_WB_CALLBACK  pfCallBack,
void *  lpContext 
)

KSJ_WhiteBalanceAutoSetCallBack.

-----------------------------------------------------------------------------

白平衡回调函数类型定义

参数:
nIndex [in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
pfCallBack [in] 自动白平衡回调函数指针
lpContext [in] 上下文指针
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_WhiteBalanceAutoSetCallBackEx ( int  nIndex,
KSJ_WB_CALLBACK_EX  pfCallBackEx,
void *  lpContext 
)

KSJ_WhiteBalanceAutoSetCallBackEx.

-----------------------------------------------------------------------------

设置白平衡回调函数

参数:
nIndex [in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
pfCallBackEx [in] 自动白平衡回调函数指针
lpContext [in] 上下文指针
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 注意前面KSJ_WhiteBalanceAutoSetCallBack设置的回调函数优先级高于这个函数设置，如果KSJ_WhiteBalanceAutoSetCallBack非空，那么这个函数设置的回调函数将不会被执行。
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_WhiteBalanceAutoSet ( int  nIndex,
int  nPhi 
)

KSJ_WhiteBalanceAutoSet.

-----------------------------------------------------------------------------

设置软件自动白平衡的参考像素，是一个阈值

参数:
nIndex [in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
nPhi [in] 默认值为0，用户无需改动
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 该阈值只有在软件白平衡的时候生效
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_WhiteBalanceAutoGet ( int  nIndex,
int *  pnPhi 
)

KSJ_WhiteBalanceAutoGet.

-----------------------------------------------------------------------------

获取自动白平衡的阈值

参数:
nIndex [in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
pnPhi [out] 返回当前的阈值参数
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_WhiteBalancePresettingSet ( int  nIndex,
KSJ_COLOR_TEMPRATURE  WbPresetting 
)

KSJ_WhiteBalancePresettingSet.

-----------------------------------------------------------------------------

选择白平衡预设组值

参数:
nIndex [in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
WbPresetting [in] 预设色温白平衡。
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 凯视佳工业相机预设三种色温下的白平衡，在选择软件预设白平衡或者硬件预设白平衡的时候，可以选择不同的色温白平衡
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_WhiteBalancePresettingGet ( int  nIndex,
KSJ_COLOR_TEMPRATURE *  pWbPresetting 
)

KSJ_WhiteBalancePresettingGet.

-----------------------------------------------------------------------------

获取并返回相机当前使用的预设色温白平衡

参数:
nIndex [in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
pWbPresetting [out] 获取并返回相机当前使用的预设色温白平衡
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_ColorCorrectionSet ( int  nIndex,
KSJ_CCM_MODE  CcmMode 
)

KSJ_ColorCorrectionSet.

-----------------------------------------------------------------------------

设置颜色校正模式

参数:
nIndex [in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
CcmMode [in] 颜色校正模式
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_ColorCorrectionGet ( int  nIndex,
KSJ_CCM_MODE *  pCcmMode 
)

KSJ_ColorCorrectionGet.

-----------------------------------------------------------------------------

获取颜色校正模式

参数:
nIndex [in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
pCcmMode [out] 颜色校正模式
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_ColorCorrectionMatrixSet ( int  nIndex,
float  fMatrix[3][3] 
)

KSJ_ColorCorrectionMatrixSet.

-----------------------------------------------------------------------------

手动设置颜色校正矩阵

参数:
nIndex [in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
fMatrix [in] 颜色校正系数矩阵，为3x3 float型的矩阵
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 在软件/硬件手工输入矩阵值校正模式时生效，计算公式：
  • Bc = fMatrix[2][0] * Rw + fMatrix[2][1] * Gw + fMatrix[2][2] * Bw
  • Gc = fMatrix[1][0] * Rw + fMatrix[1][1] * Gw + fMatrix[1][2] * Bw
  • Rc = fMatrix[0][0] * Rw + fMatrix[0][1] * Gw + fMatrix[0][2] * Bw
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_ColorCorrectionMatrixGet ( int  nIndex,
float  fMatrix[3][3] 
)

KSJ_ColorCorrectionMatrixGet.

-----------------------------------------------------------------------------

获取当前的颜色校正矩阵

参数:
nIndex [in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
fMatrix [in] 颜色校正系数矩阵，为3x3 float型的矩阵
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_ColorCorrectionPresettingSet ( int  nIndex,
KSJ_COLOR_TEMPRATURE  CcmPresetting 
)

KSJ_ColorCorrectionPresettingSet.

-----------------------------------------------------------------------------

设置颜色校正的预设组值

参数:
nIndex [in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
CcmPresetting [in] 预设色温颜色校正，凯视佳工业相机预设三种色温下的颜色校正矩阵
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------

KSJ_API int __stdcall KSJ_ColorCorrectionPresettingGet ( int  nIndex,
KSJ_COLOR_TEMPRATURE *  pCcmPresetting 
)

KSJ_ColorCorrectionPresettingGet.

-----------------------------------------------------------------------------

获取当前选择的颜色校正预设组值

参数:
nIndex [in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
pCcmPresetting [out] 获取并返回相机当前使用的预设色温颜色校正
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

-----------------------------------------------------------------------------