函数

KSJ_API int __stdcall KSJ_SetSerials (int nIndex, unsigned char btSerials)
 KSJ_SetSerials.
KSJ_API int __stdcall KSJ_GetSerials (int nIndex, unsigned char *pbtSerials)
 KSJ_GetSerials.
KSJ_API int __stdcall KSJ_SerialsDescReadout (int nIndex, unsigned char btDesc[16])
 KSJ_SerialsDescReadout.
KSJ_API int __stdcall KSJ_HardwareVersionReadout (int nIndex, unsigned char btVersion[64])
 KSJ_HardwareVersionReadout.
KSJ_API int __stdcall KSJ_LutInfoProgram (int nIndex, unsigned short wValue)
 KSJ_LutInfoProgram.
KSJ_API int __stdcall KSJ_LutInfoReadout (int nIndex, unsigned short *pValue)
 KSJ_LutInfoReadout.
KSJ_API int __stdcall KSJ_HWBMatrixProgram (int nIndex, float fMatrix[3])
 KSJ_HWBMatrixProgram.
KSJ_API int __stdcall KSJ_HWBMatrixReadout (int nIndex, float fMatrix[3])
 KSJ_HWBMatrixReadout.
KSJ_API int __stdcall KSJ_HWBMatrixUpload (int nIndex, float fMatrix[3])
 KSJ_HWBMatrixUpload.
KSJ_API int __stdcall KSJ_HCCMMatrixProgram (int nIndex, float fMatrix[3][3])
 KSJ_HCCMMatrixProgram.
KSJ_API int __stdcall KSJ_HCCMMatrixReadout (int nIndex, float fMatrix[3][3])
 KSJ_HCCMMatrixReadout.
KSJ_API int __stdcall KSJ_HCCMMatrixUpload (int nIndex, float fMatrix[3][3])
 KSJ_HCCMMatrixUpload.
KSJ_API int __stdcall KSJ_LutFileProgram (int nIndex, TCHAR *pszFile)
 KSJ_LutFileProgram.
KSJ_API int __stdcall KSJ_LutDataProgram (int nIndex, unsigned char *pData, int nBytes)
 KSJ_LutDataProgram.
KSJ_API int __stdcall KSJ_LutDataReadout (int nIndex, unsigned char *pData, int *pnBytes)
 KSJ_LutDataReadout.
KSJ_API int __stdcall KSJ_ParamProgram (int nIndex)
 KSJ_ParamProgram.
KSJ_API int __stdcall KSJ_LoadParamFromCamera (int nIndex)
 将目前的主要参数保存至相机,再次重启KSJApi库时会自动加载并设置
KSJ_API int __stdcall KSJ_ParamErase (int nIndex)
 KSJ_ParamErase.
KSJ_API int __stdcall KSJ_SaveParamToFile (int nIndex, TCHAR *pszFile)
 清除目前保存至相机的主要参数(预览视场、采集视场、曝光、增益)
KSJ_API int __stdcall KSJ_LoadParamFromFile (int nIndex, TCHAR *pszFile)
 KSJ_LoadParamFromFile.

函数文档

KSJ_API int __stdcall KSJ_SetSerials ( int  nIndex,
unsigned char  btSerials 
)

KSJ_SetSerials.

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

设置相机序号

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
btSerials [in] 将序号设置到当前相机
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
序号即KSJ_DeviceGetInformation/KSJ_DeviceGetInformationEx所获取的pnSerials

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

KSJ_API int __stdcall KSJ_GetSerials ( int  nIndex,
unsigned char *  pbtSerials 
)

KSJ_GetSerials.

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

获取相机序号

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pbtSerials [out] 返回相机序号
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
序号即KSJ_DeviceGetInformation/KSJ_DeviceGetInformationEx所获取的pnSerials

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

KSJ_API int __stdcall KSJ_SerialsDescReadout ( int  nIndex,
unsigned char  btDesc[16] 
)

KSJ_SerialsDescReadout.

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

获取相机唯一序列号SN

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
btDesc [out] 返回相机唯一序列号SN
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
唯一序列号SN即为相机的唯一号,与硬件标牌上SN一致,为8个宽字符数字

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

KSJ_API int __stdcall KSJ_HardwareVersionReadout ( int  nIndex,
unsigned char  btVersion[64] 
)

KSJ_HardwareVersionReadout.

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

获取相机的硬件版本号

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

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

KSJ_API int __stdcall KSJ_LutInfoProgram ( int  nIndex,
unsigned short  wValue 
)

KSJ_LutInfoProgram.

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

设置LUT信息

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
wValue [in] LUT信息,即LUT表大小(LUT bytes size),应该为2^10、2^12或者2^14
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_LutInfoReadout ( int  nIndex,
unsigned short *  pValue 
)

KSJ_LutInfoReadout.

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

获取LUT信息

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pValue [out] 返回LUT信息,即LUT表大小(LUT bytes size),应该为2^10、2^12或者2^14
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

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

KSJ_HWBMatrixProgram.

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

设置硬件白平衡参数

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

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

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

KSJ_HWBMatrixReadout.

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

获取硬件白平衡参数

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

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

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

KSJ_HWBMatrixUpload.

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

获取当前硬件执行白平衡参数

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
fMatrix [out] 当前硬件处理图像使用的白平衡参数
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
与KSJ_HWBMatrixReadout区别,上面是获取默认的白平衡参数,该函数是当前的白平衡参数,在硬件连续白平衡时,这个白平衡参数是变化的

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

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

KSJ_HCCMMatrixProgram.

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

设置硬件CCM参数

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

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

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

KSJ_HCCMMatrixReadout.

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

获取硬件CCM参数

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

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

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

KSJ_HCCMMatrixUpload.

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

获取当前硬件执行CCM参数

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
fMatrix [out] 当前硬件处理图像使用的CCM参数
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
与KSJ_HCCMMatrixReadout区别,上面是获取默认的CCM参数,该函数是当前的CCM参数,在硬件连续CCM时,这个CCM参数是变化的
KSJ_API int __stdcall KSJ_LutFileProgram ( int  nIndex,
TCHAR *  pszFile 
)

KSJ_LutFileProgram.

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

将LUT数据从文件下载到硬件中

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

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

KSJ_API int __stdcall KSJ_LutDataProgram ( int  nIndex,
unsigned char *  pData,
int  nBytes 
)

KSJ_LutDataProgram.

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

将LUT数据下载到硬件中

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

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

KSJ_API int __stdcall KSJ_LutDataReadout ( int  nIndex,
unsigned char *  pData,
int *  pnBytes 
)

KSJ_LutDataReadout.

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

读取相机LUT数据

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
pData [out] LUT数据内存地址,需要提前分配
nBytes [out] 返回LUT数据大小,单位:字节
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用

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

KSJ_API int __stdcall KSJ_ParamProgram ( int  nIndex  ) 

KSJ_ParamProgram.

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

将当前的相机设置参数保存到相机中

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
保存参数以后,相机断电再连接,软件启动后,会自动加载这些参数。

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

KSJ_API int __stdcall KSJ_LoadParamFromCamera ( int  nIndex  ) 

将目前的主要参数保存至相机,再次重启KSJApi库时会自动加载并设置

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

KSJ_LoadParamFromCamera 将当前的相机保存的设置参数应用到相机中

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

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

KSJ_API int __stdcall KSJ_ParamErase ( int  nIndex  ) 

KSJ_ParamErase.

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

擦除保存在相机内的参数

参数:
nIndex [in] 相机索引(从0开始,最大索引数为:连接到主机的相机数目减一)
返回:
成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。
注意:
调用KSJ_Init函数初始化后调用
可以执行该函数后,相机重新上电将会恢复到出厂设置

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

KSJ_API int __stdcall KSJ_SaveParamToFile ( int  nIndex,
TCHAR *  pszFile 
)

清除目前保存至相机的主要参数(预览视场、采集视场、曝光、增益)

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

KSJ_SaveParamToFile 将当前的相机设置参数保存到一个文件

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

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

KSJ_API int __stdcall KSJ_LoadParamFromFile ( int  nIndex,
TCHAR *  pszFile 
)

KSJ_LoadParamFromFile.

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

用一个参数文件设置到当前的相机

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

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