typedef void(__stdcall * KSJ_AECALLBACK )(bool bSuccess, int nResult, void *lpContext)
 KSJ_AWBSetRegion.

枚举

enum  KSJ_AE_STATUS {
  KSJ_AE_ONCE_SUCCESS = 0, KSJ_AE_ONCE_FAIL_MAX_COUNT, KSJ_AE_ONCE_FAIL_WAVE, KSJ_AE_ONCE_FAIL_OVER_RANGE,
  KSJ_AE_DOING, KSJ_AE_CONTINUE_SUCCESS, KSJ_AE_CONTINUE_FAIL_WAVE, KSJ_AE_CONTINUE_FAIL_OVER_RANGE
}
 

自动曝光运算返回状态

更多...

函数

KSJ_API int __stdcall KSJ_AESetRegion (int nIndex, int nX, int nY, int nW, int nH)
 KSJ_AESetRegion.
KSJ_API int __stdcall KSJ_AEGetRegion (int nIndex, int *pnX, int *pnY, int *pnW, int *pnH, bool *pbShow)
 KSJ_AEGetRegion.
KSJ_API int __stdcall KSJ_AEShowRegion (int nIndex, bool bShow)
 KSJ_AEShowRegion.
KSJ_API int __stdcall KSJ_AESetPeakAveRatio (int nIndex, float fRatio)
 KSJ_AESetPeakAveRatio.
KSJ_API int __stdcall KSJ_AEGetPeakAveRatio (int nIndex, float *pfRatio)
 KSJ_AEGetPeakAveRatio.
KSJ_API int __stdcall KSJ_AESetExposureTimeRange (int nIndex, float fMinExpMs, float fMaxExpMs)
 KSJ_AESetExposureTimeRange.
KSJ_API int __stdcall KSJ_AEGetExposureTimeRange (int nIndex, float *pfMinExpMs, float *pfMaxExpMs)
 KSJ_AEGetExposureTimeRange.
KSJ_API int __stdcall KSJ_AESetCallbackEx (int nIndex, KSJ_AECALLBACKEX pfAECallbackEx, void *lpContext)
 KSJ_AESetCallbackEx.
KSJ_API int __stdcall KSJ_AESetMaxCount (int nIndex, int nMaxCount)
 KSJ_AESetMaxCount.
KSJ_API int __stdcall KSJ_AESetTarget (int nIndex, int nTarget)
 KSJ_AESetTarget.
KSJ_API int __stdcall KSJ_AEStartEx (int nIndex, bool bStart)
 KSJ_AEStartEx.
KSJ_API int __stdcall KSJ_AEGetStatusEx (int nIndex, bool *pbStart, int *pnMaxCount, int *pnTarget)
 得到自动曝光的设置
KSJ_API int __stdcall KSJ_AEEnableAutoDigitalGainSet (int nIndex, bool bEnable)
 KSJ_AEEnableAutoDigitalGainSet.
KSJ_API int __stdcall KSJ_AEEnableAutoDigitalGainGet (int nIndex, bool *pbEnable)
 KSJ_AEEnableAutoDigitalGainGet.
KSJ_API int __stdcall KSJ_AWBSetRegion (int nIndex, int nX, int nY, int nW, int nH)
 KSJ_AWBSetRegion.
KSJ_API int __stdcall KSJ_AWBShowRegion (int nIndex, bool bShow)
 KSJ_AWBShowRegion.
KSJ_API int __stdcall KSJ_AWBGetRegion (int nIndex, int *pnX, int *pnY, int *pnW, int *pnH, bool *pbShow)
 KSJ_AWBGetRegion.

类型定义文档

typedef void(__stdcall * KSJ_AECALLBACKEX)(KSJ_AE_STATUS Status, int nExpsoureTimeMs, void *lpContext)

KSJ_AECALLBACKEX.

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

自动曝光回调函数定义

参数:
Status [out] 当前自动曝光操作的状态(参考KSJ_AE_STATUS说明)
nExpsoureTimeMs [out] 在自动曝光调节结束后,当前的曝光值,单位:毫秒
lpContext [out] 用户上下文指针,这个指针是用户调用KSJ_AESetCallbackEx时传入的上下文指针
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

typedef void(__stdcall * KSJ_AECALLBACK)(bool bSuccess, int nResult, void *lpContext)

KSJ_AWBSetRegion.

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

设置自动白平衡的参考区域,这个区域是相对预览图像的位置

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
nX [in] 相对于无缩放预览图像的左上角水平像素偏移
nY [in] 相对于无缩放预览图像的左上角垂直像素偏移
nW [in] 相对于无缩放预览图像的自动曝光区域的宽度,以像素为单位
nH [in] 相对于无缩放预览图像的自动曝光区域的高度,以像素为单位
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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


枚举类型文档

自动曝光运算返回状态

枚举值:
KSJ_AE_ONCE_SUCCESS 

单次调节成功

KSJ_AE_ONCE_FAIL_MAX_COUNT 

单次调节失败,失败原因达到最大调节次数

KSJ_AE_ONCE_FAIL_WAVE 

单次调节失败,失败原因调节上下振动

KSJ_AE_ONCE_FAIL_OVER_RANGE 

单次调节失败,失败原因曝光超出设置范围

KSJ_AE_DOING 

单次调节完成,设置了新的曝光时间

KSJ_AE_CONTINUE_SUCCESS 

连续调节成功,当前达到了目标值

KSJ_AE_CONTINUE_FAIL_WAVE 

连续调节失败,失败原因调节上下振动

KSJ_AE_CONTINUE_FAIL_OVER_RANGE 

连续调节失败,失败原因曝光超出设置范围


函数文档

KSJ_API int __stdcall KSJ_AESetRegion ( int  nIndex,
int  nX,
int  nY,
int  nW,
int  nH 
)

KSJ_AESetRegion.

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

设置自动曝光的参考区域,这个区域是相对预览图像的位置

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
nX [in] 相对于无缩放预览图像的左上角水平像素偏移
nY [in] 相对于无缩放预览图像的左上角垂直像素偏移
nW [in] 相对于无缩放预览图像的自动曝光区域的宽度,以像素为单位
nH [in] 相对于无缩放预览图像的自动曝光区域的高度,以像素为单位
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_AEGetRegion ( int  nIndex,
int *  pnX,
int *  pnY,
int *  pnW,
int *  pnH,
bool *  pbShow 
)

KSJ_AEGetRegion.

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

获取自动曝光的参考区域及显示状态,这个区域是相对预览图像的位置

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnX [out] 返回相对于无缩放预览图像的左上角水平像素偏移
pnY [out] 返回相对于无缩放预览图像的左上角垂直像素偏移
pnW [out] 返回相对于无缩放预览图像的自动曝光区域的宽度以像素为单位
pnH [out] 返回相对于无缩放预览图像的自动曝光区域的高度以像素为单位
pbShow [out] 参考区域是否显示
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_AEShowRegion ( int  nIndex,
bool  bShow 
)

KSJ_AEShowRegion.

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

设置是否预览时显示自动曝光的参考区域

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
bShow [in] 是否显示自动曝光参考区域
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_AESetPeakAveRatio ( int  nIndex,
float  fRatio 
)

KSJ_AESetPeakAveRatio.

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

设置自动曝光峰值像素的统计比率

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
fRatio [in] 设置的峰值比率,范围0到1
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码,请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 自动曝光统计像素亮度值的时候,遇到峰值像素(255),该像素值将以(1+fRatio)的倍率参与统计
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_AEGetPeakAveRatio ( int  nIndex,
float *  pfRatio 
)

KSJ_AEGetPeakAveRatio.

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

获取自动曝光峰值像素的统计比率

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pfRatio [out] 返回自动曝光峰值像素的统计比率
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_AESetExposureTimeRange ( int  nIndex,
float  fMinExpMs,
float  fMaxExpMs 
)

KSJ_AESetExposureTimeRange.

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

设置自动曝光的调节范围

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
fMinExpMs [in] 设置自动曝光调节下限,单位:毫秒
fMaxExpMs [in] 设置自动曝光调节上限,单位:毫秒
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 开启自动曝光时,曝光值将仅限于这个范围进行调节
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_AEGetExposureTimeRange ( int  nIndex,
float *  pfMinExpMs,
float *  pfMaxExpMs 
)

KSJ_AEGetExposureTimeRange.

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

获取自动曝光的调节范围

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pfMinExpMs [in] 返回自动曝光调节下限,单位:毫秒
pfMaxExpMs [in] 返回自动曝光调节上限,单位:毫秒
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_AESetCallbackEx ( int  nIndex,
KSJ_AECALLBACKEX  pfAECallbackEx,
void *  lpContext 
)

KSJ_AESetCallbackEx.

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

设置自动曝光操作的回调函数

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pfAECallbackEx [in] 用户定义的自动曝光回调函数指针
lpContext [in] 回调函数的上下文指针
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 自动曝光完成一次曝光运行并调节时,会自动调用pfAECallbackEx用户指定的回调函数
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_AESetMaxCount ( int  nIndex,
int  nMaxCount 
)

KSJ_AESetMaxCount.

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

设置自动曝光调节最大次数

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
nMaxCount [in] 设置自动曝光调节最大次数
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 自动曝光最多进行nMaxCount指定的运算次数
  • 如果需要自动曝光连续运行,请设置nMaxCount为-1
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_AESetTarget ( int  nIndex,
int  nTarget 
)

KSJ_AESetTarget.

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

设置自动曝光目标值

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

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

KSJ_API int __stdcall KSJ_AEStartEx ( int  nIndex,
bool  bStart 
)

KSJ_AEStartEx.

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

启动或结束自动曝光操作

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
bStart [in] true 开始自动曝光调节,false 终止或结束自动曝光调节
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_AEGetStatusEx ( int  nIndex,
bool *  pbStart,
int *  pnMaxCount,
int *  pnTarget 
)

得到自动曝光的设置

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

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pbStart [out] 得到自动曝光是否启动
pnMaxCount [out] 得到自动曝光的最大调节次数
pnTarget [out] 得到自动曝光调节的目标值
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_AEEnableAutoDigitalGainSet ( int  nIndex,
bool  bEnable 
)

KSJ_AEEnableAutoDigitalGainSet.

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

设置自动曝光时,是否使能自动调整数字增益

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
bEnable [in] 使能自动调整数字增益
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 目前仅部分相机执行该功能
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_AEEnableAutoDigitalGainGet ( int  nIndex,
bool *  pbEnable 
)

KSJ_AEEnableAutoDigitalGainGet.

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

获取得到自动曝光时,是否使能自动调整数字增益

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pbEnable [out] 自动调整数字增益是否使能
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 目前仅部分相机执行该功能
-----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_AWBSetRegion ( int  nIndex,
int  nX,
int  nY,
int  nW,
int  nH 
)

KSJ_AWBSetRegion.

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

设置自动白平衡的参考区域,这个区域是相对预览图像的位置

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
nX [in] 相对于无缩放预览图像的左上角水平像素偏移
nY [in] 相对于无缩放预览图像的左上角垂直像素偏移
nW [in] 相对于无缩放预览图像的自动曝光区域的宽度,以像素为单位
nH [in] 相对于无缩放预览图像的自动曝光区域的高度,以像素为单位
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_AWBShowRegion ( int  nIndex,
bool  bShow 
)

KSJ_AWBShowRegion.

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

设置预览时是否显示自动白平衡的参考区域

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

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

KSJ_API int __stdcall KSJ_AWBGetRegion ( int  nIndex,
int *  pnX,
int *  pnY,
int *  pnW,
int *  pnH,
bool *  pbShow 
)

KSJ_AWBGetRegion.

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

获取自动白平衡的参考区域及显示状态,这个区域是相对预览图像的位置

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnX [out] 返回相对于无缩放预览图像的左上角水平像素偏移
pnY [out] 返回相对于无缩放预览图像的左上角垂直像素偏移
pnW [out] 返回相对于无缩放预览图像的自动曝光区域的宽度,以像素为单位
pnH [out] 返回相对于无缩放预览图像的自动曝光区域的高度,以像素为单位
pbShow [out] 参考区域是否显示
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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