KSJ_IF_RAW8 = 0, KSJ_IF_GRAY8, KSJ_IF_RGB24, KSJ_IF_RGB32,
  KSJ_IF_BGR24, KSJ_IF_BGR32, KSJ_IF_RAW16, KSJ_IF_GRAY16,
  KSJ_IF_RGB48, KSJ_IF_RGB64, KSJ_IF_BGR48, KSJ_IF_BGR64
}
 

图像格式

更多...
enum  KSJ_USBSPEED { USB_NOT_CONNECTED = 0x00, USB_FULL_SPEED, USB_HIGH_SPEED, USB_SUPER_SPEED }
 

相机USB连接状态

更多...
enum  KSJ_MAPMODE { KSJ_MM_NEARESTNEIGHBOR, KSJ_MM_BILINEAR }
 

凯视佳工业相机畸变校正目标值计算方式定义

更多...

函数

KSJ_API int __stdcall KSJ_SetImageFormat (IN int nIndex, IN KSJ_IMAGE_FORMAT ImageFormat)
 KSJ_SetImageFormat.
KSJ_API int __stdcall KSJ_GetImageFormat (IN int nIndex, OUT KSJ_IMAGE_FORMAT *pImageFormat)
 KSJ_GetImageFormat.
KSJ_API int __stdcall KSJ_SetNegativeImageMode (IN int nIndex, IN bool bNegative)
 KSJ_SetNegativeImageMode.
KSJ_API int __stdcall KSJ_GetNegativeImageMode (IN int nIndex, OUT bool *pbNegative)
 KSJ_GetNegativeImageMode.
KSJ_API int __stdcall KSJ_GlobalResetShutterSet (int nIndex, bool bGlobalReset)
 设置全局复位滚动快门
KSJ_API int __stdcall KSJ_GlobalResetShutterGet (int nIndex, bool *pbGlobalReset)
 得到全局复位滚动快门状态
KSJ_API int __stdcall KSJ_SetFlatFieldCorrectionFieldOfView (int nIndex, int nColStart, int nRowStart, int nColSize, int nRowSize, KSJ_ADDRESSMODE AmCol, KSJ_ADDRESSMODE AmRow, unsigned short wMultiFrameNum)
 KSJ_SetFlatFieldCorrectionFieldOfView.
KSJ_API int __stdcall KSJ_GetFlatFieldCorrectionFieldOfView (int nIndex, int *pnColStart, int *pnRowStart, int *pnColSize, int *pnRowSize, KSJ_ADDRESSMODE *pColAddressMode, KSJ_ADDRESSMODE *pRowAddressMode, unsigned short *pwMultiFrameNum)
 KSJ_GetFlatFieldCorrectionFieldOfView.
KSJ_API int __stdcall KSJ_MakeDarkFrame (int nIndex, int nDarkFrames)
 KSJ_MakeDarkFrame.
KSJ_API int __stdcall KSJ_MakeFlatFieldFrame (int nIndex, int nFlatFieldFrames)
 KSJ_MakeFlatFieldFrame.
KSJ_API int __stdcall KSJ_PreviewSetFlatFieldCorrection (int nIndex, bool bEnable)
 KSJ_PreviewSetFlatFieldCorrection.
KSJ_API int __stdcall KSJ_PreviewGetFlatFieldCorrection (int nIndex, bool *pbEnable)
 KSJ_PreviewGetFlatFieldCorrection.
KSJ_API int __stdcall KSJ_CaptureSetFlatFieldCorrection (int nIndex, bool bEnable)
 KSJ_CaptureSetFlatFieldCorrection.
KSJ_API int __stdcall KSJ_CaptureGetFlatFieldCorrection (int nIndex, bool *pbEnable)
 KSJ_PreviewGetFlatFieldCorrection.
KSJ_API int __stdcall KSJ_SaveFlatFieldCorrection (int nIndex, TCHAR *pszFilePath)
 KSJ_SaveFlatFieldCorrection.
KSJ_API int __stdcall KSJ_LoadFlatFieldCorrection (int nIndex, TCHAR *pszFilePath)
 KSJ_LoadFlatFieldCorrection.
KSJ_API int __stdcall KSJ_PreExposureRangeGet (int nIndex, int *pnMinValue, int *pnMaxValue)
 KSJ_PreExposureRangeGet.
KSJ_API int __stdcall KSJ_PreExposureTimeSet (int nIndex, float fPreExpTimeMs)
 KSJ_PreExposureTimeSet.
KSJ_API int __stdcall KSJ_PreExposureTimeGet (int nIndex, float *pfPreExpTimeMs)
 KSJ_PreExposureTimeGet.
KSJ_API int __stdcall KSJ_PreExposureLinesSet (int nIndex, int nPreExpLines)
 KSJ_PreExposureLinesSet.
KSJ_API int __stdcall KSJ_PreExposureLinesGet (int nIndex, int *pnPreExpLines)
 KSJ_PreExposureLinesGet.
KSJ_API int __stdcall KSJ_SetBufferCount (int nIndex, int nCount)
 KSJ_SetBufferCount.
KSJ_API int __stdcall KSJ_GetBufferCount (int nIndex, int *pnCount)
 KSJ_GetBufferCount.
KSJ_API int __stdcall KSJ_CaptureRawDataAfterEmptyFrameBuffer (int nIndex, unsigned char *pRawData)
 KSJ_CaptureRawDataAfterEmptyFrameBuffer.
KSJ_API int __stdcall KSJ_CaptureRgbDataAfterEmptyFrameBuffer (int nIndex, unsigned char *pRgbData)
 KSJ_CaptureRgbDataAfterEmptyFrameBuffer.
KSJ_API int __stdcall KSJ_CaptureRgbDataExAfterEmptyFrameBuffer (int nIndex, unsigned char *pRgbData, int *pnWidth, int *pnHeight, int *pnBitCount)
 KSJ_CaptureRgbDataExAfterEmptyFrameBuffer.
KSJ_API int __stdcall KSJ_CheckFieldOfView (int nIndex, int nColStart, int nRowStart, int nColSize, int nRowSize, KSJ_ADDRESSMODE AmCol, KSJ_ADDRESSMODE AmRow)
 KSJ_CheckFieldOfView.
KSJ_API int __stdcall KSJ_GetUsbState (int nIndex, KSJ_USBSPEED *pUSBSpeed)
 获取USBKSJ_GetUsbState
KSJ_API int __stdcall KSJ_SetCalibration (int nIndex, bool bEnable)
 KSJ_SetCalibration.
KSJ_API int __stdcall KSJ_GetCalibration (int nIndex, bool *pbEnable)
 KSJ_GetCalibration.
KSJ_API int __stdcall KSJ_CalibrationProgram (int nIndex, float fCoefficient[14])
 KSJ_CalibrationProgram.
KSJ_API int __stdcall KSJ_CalibrationReadout (int nIndex, float fCoefficient[14])
 KSJ_GetCalibration.
KSJ_API int __stdcall KSJ_SetCalibrationMapMode (int nIndex, KSJ_MAPMODE MapMode)
 KSJ_SetCalibrationMapMode.
KSJ_API int __stdcall KSJ_GetCalibrationMapMode (int nIndex, KSJ_MAPMODE *pMapMode)
 KSJ_GetCalibrationMapMode.
KSJ_API int __stdcall KSJ_LoadCalibrationMapFile (int nIndex, const TCHAR *pszFilePath)
 KSJ_LoadCalibrationMapFile.
KSJ_API int __stdcall KSJ_GetDeviceIndex (int nSerials)
 KSJ_GetDeviceIndex.

枚举类型文档

图像格式

输出图像格式:根据需要直接设置图像的输出格式,API自动将采集到的图像转换成需要的输出图像格式

枚举值:
KSJ_IF_RAW8 
KSJ_IF_GRAY8 
KSJ_IF_RGB24 
KSJ_IF_RGB32 
KSJ_IF_BGR24 
KSJ_IF_BGR32 
KSJ_IF_RAW16 
KSJ_IF_GRAY16 
KSJ_IF_RGB48 
KSJ_IF_RGB64 
KSJ_IF_BGR48 
KSJ_IF_BGR64 

相机USB连接状态

相机USB连接状态:相机出现异常,比如无法采图,采集图像变慢,可以查看当前USB连接状态

枚举值:
USB_NOT_CONNECTED 

USB通信失败.

USB_FULL_SPEED 

全速USB

USB_HIGH_SPEED 

高速USB

USB_SUPER_SPEED 

USB3.0.

凯视佳工业相机畸变校正目标值计算方式定义

枚举值:
KSJ_MM_NEARESTNEIGHBOR 

最临近插值法

KSJ_MM_BILINEAR 

双线性插值


函数文档

KSJ_API int __stdcall KSJ_SetImageFormat ( IN int  nIndex,
IN KSJ_IMAGE_FORMAT  ImageFormat 
)

KSJ_SetImageFormat.

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

设置图像输出的数据格式

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
ImageFormat [in] 图像格式(请参考KSJ_IMAGE_FORMAT的定义)
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_GetImageFormat ( IN int  nIndex,
OUT KSJ_IMAGE_FORMAT pImageFormat 
)

KSJ_GetImageFormat.

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

获得图像输出的数据格式

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pImageFormat [out] 返回当前输出的图像格式(请参考KSJ_IMAGE_FORMAT的定义)
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_SetNegativeImageMode ( IN int  nIndex,
IN bool  bNegative 
)

KSJ_SetNegativeImageMode.

图像负片功能:设置是否输出图像负片-----------------------------------------------------------------------------

设置图像输出的负片

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
bNegative [in] 负片
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_GetNegativeImageMode ( IN int  nIndex,
OUT bool *  pbNegative 
)

KSJ_GetNegativeImageMode.

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

获得图像是否负片输出

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pbNegative [out] 返回当前输出的图像是否负片
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_GlobalResetShutterSet ( int  nIndex,
bool  bGlobalReset 
)

设置全局复位滚动快门

全局复位滚动快门:设置全局快门是否使能-----------------------------------------------------------------------------

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
bGlobalReset [in] 设置全局复位滚动快门生效
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_GlobalResetShutterGet ( int  nIndex,
bool *  pbGlobalReset 
)

得到全局复位滚动快门状态

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

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pbGlobalReset[out] 返回全局复位滚动快门状态指针
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_SetFlatFieldCorrectionFieldOfView ( int  nIndex,
int  nColStart,
int  nRowStart,
int  nColSize,
int  nRowSize,
KSJ_ADDRESSMODE  AmCol,
KSJ_ADDRESSMODE  AmRow,
unsigned short  wMultiFrameNum 
)

KSJ_SetFlatFieldCorrectionFieldOfView.

FFC校正:目的是消除像素与像素间不同的灵敏度特性以及光路的畸变所造成的亮度不均匀的现象,FFC校正流程: 1、首先通过KSJ_SetFlatFieldCorrectionFieldOfView设置FFC的参考视场,这个视场可以是您的采集或预览视场,当以后使能FFC时,所设置的视场必须与FFC的参考视场一致,才可以进行校正。 2、调节相机参数,使采集的图像保持正常。 3、盖住镜头,不要让光进入,调用KSJ_MakeDarkFrame采集一幅黑图,您可以指定采集多少张,此函数会做平均最终得到一幅黑图。(该步骤非必须,如果不采集黑图,那么黑图默认为全黑)。 4、不要盖住镜头,让光正常进入,放一张白纸,调用KSJ_MakeFlatFieldFrame采集一幅图像,您可以指定采集多少张,此函数会做平均最终得到一幅白纸图像。 5、调用KSJ_PreviewSetFlatFieldCorrection或KSJ_CaptureSetFlatFieldCorrection函数,用于设置是否在预览流中还是在采集图像时,进行FFC校正处理。----------------------------------------------------------------------------- 设置FFC校正参考视场

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
nColStart [in] 校正视场的水平像素起始位置
nRowStart [in] 校正视场的垂直行起始位置
nColSize [in] 校正视场的水平像素数
nRowSize [in] 校正视场的垂直像素数
AmCol [in] 校正视场列抽点模式(请参考KSJ_ADDRESSMODE的定义)
AmRow [in] 校正视场行抽点模式(请参考“凯视佳工业相机API函数说明书-基础篇”KSJ_ADDRESSMODE的定义)
wMultiFrameNum [in] 校正视场拼接帧数,该参数不再使用
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
  • 对于视场拼接帧数,计算校正参数不考虑拼接帧,校正参数仅考虑单帧的情况,拼接帧采集的时候,使用同一个参数对拼接帧进行校正 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_GetFlatFieldCorrectionFieldOfView ( int  nIndex,
int *  pnColStart,
int *  pnRowStart,
int *  pnColSize,
int *  pnRowSize,
KSJ_ADDRESSMODE pColAddressMode,
KSJ_ADDRESSMODE pRowAddressMode,
unsigned short *  pwMultiFrameNum 
)

KSJ_GetFlatFieldCorrectionFieldOfView.

----------------------------------------------------------------------------- 设置FFC校正参考视场

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnColStart [out] 返回校正视场的水平像素起始位置
pnRowStart [out] 返回校正视场的垂直行起始位置
pnColSize [out] 返回校正视场的水平像素数
pnRowSize [out] 返回校正视场的垂直像素数
pColAddressMode [out] 返回校正视场列抽点模式(请参考KSJ_ADDRESSMODE的定义)
pRowAddressMode [out] 返回校正视场行抽点模式(请参考“凯视佳工业相机API函数说明书-基础篇”KSJ_ADDRESSMODE的定义)
pwMultiFrameNum [out] 返回校正视场拼接帧数,该参数不再使用
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_MakeDarkFrame ( int  nIndex,
int  nDarkFrames 
)

KSJ_MakeDarkFrame.

----------------------------------------------------------------------------- 获取参考黑图

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
nDarkFrames [in] 采集多少张黑图做平均
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_MakeFlatFieldFrame ( int  nIndex,
int  nFlatFieldFrames 
)

KSJ_MakeFlatFieldFrame.

----------------------------------------------------------------------------- 获取参考白图

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
nFlatFieldFrames [in] 采集多少张白图做平均
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_PreviewSetFlatFieldCorrection ( int  nIndex,
bool  bEnable 
)

KSJ_PreviewSetFlatFieldCorrection.

----------------------------------------------------------------------------- 对预览流是否进行FFC校正处理

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
bEnable [in] 为true时开启FFC校正, false时关闭FFC校正
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_PreviewGetFlatFieldCorrection ( int  nIndex,
bool *  pbEnable 
)

KSJ_PreviewGetFlatFieldCorrection.

----------------------------------------------------------------------------- 获取当前预览流是否进行FFC校正处理

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pbEnable [out] 返回FFC对于预览的使能状态
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_CaptureSetFlatFieldCorrection ( int  nIndex,
bool  bEnable 
)

KSJ_CaptureSetFlatFieldCorrection.

----------------------------------------------------------------------------- 对采集流是否进行FFC校正处理

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
bEnable [in] 为true时开启FFC校正, false时关闭FFC校正
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_CaptureGetFlatFieldCorrection ( int  nIndex,
bool *  pbEnable 
)

KSJ_PreviewGetFlatFieldCorrection.

----------------------------------------------------------------------------- 获取采集时是否进行FFC校正处理

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pbEnable [out] 返回FFC对于采集的使能状态
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_SaveFlatFieldCorrection ( int  nIndex,
TCHAR *  pszFilePath 
)

KSJ_SaveFlatFieldCorrection.

----------------------------------------------------------------------------- 保存FFC当前的参考值

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pszFilePath [in] 保存的文件名(完整路径)
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_LoadFlatFieldCorrection ( int  nIndex,
TCHAR *  pszFilePath 
)

KSJ_LoadFlatFieldCorrection.

----------------------------------------------------------------------------- 用于加载由KSJ_SaveFlatFieldCorrection保存的FFC参考信息文件

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pszFilePath [in] 需要加载的FFC参考信息的文件名(完整路径)
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_PreExposureRangeGet ( int  nIndex,
int *  pnMinValue,
int *  pnMaxValue 
)

KSJ_PreExposureRangeGet.

预曝光设置:在Sensor采图曝光之前,闪光灯会提前曝光一段时间,可以通过以下函数进行测试,该功能仅几个定制相机支持----------------------------------------------------------------------------- 得到预曝光时间范围

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnMinValue[out] 设置预曝光时间最小值指针,单位为曝光行
pnMaxValue[out] 设置预曝光时间最大值指针,单位为曝光行
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_PreExposureTimeSet ( int  nIndex,
float  fPreExpTimeMs 
)

KSJ_PreExposureTimeSet.

----------------------------------------------------------------------------- 设置预曝光时间

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
fPreExpTimeMs [in] 设置的预曝光时间
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_PreExposureTimeGet ( int  nIndex,
float *  pfPreExpTimeMs 
)

KSJ_PreExposureTimeGet.

----------------------------------------------------------------------------- 获取预曝光时间

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pfPreExpTimeMs[out] 返回预曝光时间的指针
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_PreExposureLinesSet ( int  nIndex,
int  nPreExpLines 
)

KSJ_PreExposureLinesSet.

----------------------------------------------------------------------------- 设置预曝光行

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
nPreExpLines [in] 设置的预曝光行
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_PreExposureLinesGet ( int  nIndex,
int *  pnPreExpLines 
)

KSJ_PreExposureLinesGet.

----------------------------------------------------------------------------- 获取预曝光行

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnPreExpLines [out] 返回预曝光时间的指针
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_SetBufferCount ( int  nIndex,
int  nCount 
)

KSJ_SetBufferCount.

设置预览图像缓存数,默认预览缓存数为4,仅使用预览功能的时候起作用,占用系统内存----------------------------------------------------------------------------- 设置预览图像缓存的数量

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
nCount [in] 设置预览缓存的数量
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_GetBufferCount ( int  nIndex,
int *  pnCount 
)

KSJ_GetBufferCount.

----------------------------------------------------------------------------- 获取预览图像缓存的数量

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnCount [out] 返回预览缓存的数量
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_CaptureRawDataAfterEmptyFrameBuffer ( int  nIndex,
unsigned char *  pRawData 
)

KSJ_CaptureRawDataAfterEmptyFrameBuffer.

清空帧存后采集图像:对于需要采集实时图像,先把相机内帧缓存的数据清空,然后在采集图像----------------------------------------------------------------------------- 清空帧存后采集一帧原始或黑白图像数据

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pRawData [out] 由用户分配内存空间,用于保存采集数据,采集图像的像素尺寸可以通过KSJ_CaptureGetSize函数获得
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_CaptureRgbDataAfterEmptyFrameBuffer ( int  nIndex,
unsigned char *  pRgbData 
)

KSJ_CaptureRgbDataAfterEmptyFrameBuffer.

----------------------------------------------------------------------------- 清空帧存后采集一帧8位原始或灰度图像或24,32位彩色数据图像

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pRgbData [out] 由用户分配内存空间,用于保存采集数据,采集图像的像素尺寸可以通过KSJ_CaptureGetSizeEx函数获得
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_CaptureRgbDataExAfterEmptyFrameBuffer ( int  nIndex,
unsigned char *  pRgbData,
int *  pnWidth,
int *  pnHeight,
int *  pnBitCount 
)

KSJ_CaptureRgbDataExAfterEmptyFrameBuffer.

----------------------------------------------------------------------------- 清空帧存后采集一帧8位原始或灰度图像或24,32位彩色数据图像

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pRgbData [out] 由用户分配内存空间,用于保存采集数据,采集图像的像素尺寸可以通过KSJ_CaptureGetSizeEx函数获得
pnWidth [out] 返回图像的宽度(像素)
pnHeight [out] 返回图像的高度(像素)
pnBitCount [out] 返回图像的每个像素位数(8,24或32),由KSJ_PreviewSetMode和KSJ_BayerSetMode的设置影响
注意:
调用KSJ_Init函数初始化后调用 -----------------------------------------------------------------------------
KSJ_API int __stdcall KSJ_CheckFieldOfView ( int  nIndex,
int  nColStart,
int  nRowStart,
int  nColSize,
int  nRowSize,
KSJ_ADDRESSMODE  AmCol,
KSJ_ADDRESSMODE  AmRow 
)

KSJ_CheckFieldOfView.

检测输入的视场参数与相机是否匹配:检查当前的FOV是否能够应用到相机上-----------------------------------------------------------------------------

检测输入的视场参数与相机是否匹配

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pnColStart [in] 要检测的水平像素起始位置
pnRowStart [in] 要检测的垂直行起始位置
pnColSize [in] 要检测的水平像素数
pnRowSize [in] 要检测的垂直行数
AmCol [in] 要检测的有效成像区域列抽点模式(请参考KSJ_ADDRESSMODE的定义)
AmRow [in] 要检测的有效成像区域行抽点模式(请参考KSJ_ADDRESSMODE的定义)
返回:
参考返回1表示匹配,否则不匹配
注意:
调用KSJ_Init函数初始化后调用
该函数用户检测即将设置的FOV是否能够设置到当前相机上。

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

KSJ_API int __stdcall KSJ_GetUsbState ( int  nIndex,
KSJ_USBSPEED pUSBSpeed 
)

获取USBKSJ_GetUsbState

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

获取USB连接状态

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

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

KSJ_API int __stdcall KSJ_SetCalibration ( int  nIndex,
bool  bEnable 
)

KSJ_SetCalibration.

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

是否进行畸变矫正处理

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
bEnable [in] 为true时时开启畸变矫正, false时关闭畸变矫正
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_GetCalibration ( int  nIndex,
bool *  pbEnable 
)

KSJ_GetCalibration.

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

获取是否进行畸变矫正处理

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pbEnable [out] 返回畸变矫正对于采集的使能状态
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_CalibrationProgram ( int  nIndex,
float  fCoefficient[14] 
)

KSJ_CalibrationProgram.

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

将畸变矫正参数写到相机内部

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

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

KSJ_API int __stdcall KSJ_CalibrationReadout ( int  nIndex,
float  fCoefficient[14] 
)

KSJ_GetCalibration.

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

从相机内部读取畸变矫正参数

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

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

KSJ_API int __stdcall KSJ_SetCalibrationMapMode ( int  nIndex,
KSJ_MAPMODE  MapMode 
)

KSJ_SetCalibrationMapMode.

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

设置畸变校正目标值计算方法

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
MapMode [in] 设置畸变校正目标值计算方法
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_GetCalibrationMapMode ( int  nIndex,
KSJ_MAPMODE pMapMode 
)

KSJ_GetCalibrationMapMode.

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

获取畸变校正目标值计算方法

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

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

KSJ_API int __stdcall KSJ_LoadCalibrationMapFile ( int  nIndex,
const TCHAR *  pszFilePath 
)

KSJ_LoadCalibrationMapFile.

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

用于从文件加载畸变校正参数信息

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pszFilePath [in] 需要加载载畸变校正参数的文件名(完整路径)
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_GetDeviceIndex ( int  nSerials  ) 

KSJ_GetDeviceIndex.

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

从相机用户自定义的nSerials序号获取当前的索引

参数:
nSerial [in] 需要或者相机索引的nSerials序号
返回:
返回nSerials对应的索引,如果找不到对应的nSerials相机,则返回-1,如果有多个一样的Serial,则返回最先找到的相机索引(Index小的)。

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