多帧

函数
KSJ_API int __stdcall	KSJ_PreviewSetFieldOfViewEx (int nIndex, int nColStart, int nRowStart, int nColSize, int nRowSize, KSJ_ADDRESSMODE AmCol, KSJ_ADDRESSMODE AmRow, unsigned short wMultiFrameNum)
	KSJ_CaptureSetFieldOfViewEx.
KSJ_API int __stdcall	KSJ_PreviewGetFieldOfViewEx (int nIndex, int *pnColStart, int *pnRowStart, int *pnColSize, int *pnRowSize, KSJ_ADDRESSMODE *pColAddressMode, KSJ_ADDRESSMODE *pRowAddressMode, unsigned short *pwMultiFrameNum)
	KSJ_CaptureGetFieldOfViewEx.
KSJ_API int __stdcall	KSJ_CaptureSetFieldOfViewEx (int nIndex, int nColStart, int nRowStart, int nColSize, int nRowSize, KSJ_ADDRESSMODE AmCol, KSJ_ADDRESSMODE AmRow, unsigned short wMultiFrameNum)
	KSJ_CaptureSetFieldOfViewEx.
KSJ_API int __stdcall	KSJ_CaptureGetFieldOfViewEx (int nIndex, int *pnColStart, int *pnRowStart, int *pnColSize, int *pnRowSize, KSJ_ADDRESSMODE *pColAddressMode, KSJ_ADDRESSMODE *pRowAddressMode, unsigned short *pwMultiFrameNum)
	KSJ_CaptureGetFieldOfViewEx.

---

函数文档

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

KSJ_CaptureSetFieldOfViewEx.

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

设置多帧拼接时的预览视场

参数:

	nIndex	[in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
	nColStart	[in] 采集时拼接的单个帧有效成像区域相对于默认最大成像区域的水平像素起始位置
	nRowStart	[in] 采集时拼接的单个帧有效成像区域相对于最大默认成像区域的垂直行起始位置
	nColSize	[in] 采集时拼接的单个帧有效成像区域的水平像素数
	nRowSize	[in] 采集时拼接的单个帧有效成像区域的垂直行数
	AmCol	[in] 采集时拼接的单个帧针对有效成像区域列抽点模式（请参考KSJ_ADDRESSMODE的定义）
	AmRow	[in] 采集时针拼接的单个帧对有效成像区域行抽点模式（请参考KSJ_ADDRESSMODE的定义）
	wMultiFrameNum	[in] 设置单次采集的拼接帧数

返回:

成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。

注意:

调用KSJ_Init函数初始化后调用

• 设置多帧wMultiFrameNum>1时，内触发或者软触发，采集一次图像就会返回wMultiFrameNum帧图像组成的拼帧数据；如果是外触发或者固定帧率，需要有wMultiFrameNum个触发信号之后，采集函数才返回一个拼帧。
• 多帧情况更多是用在线阵相机时，自动拼接wMultiFrameNum行图像成一个面阵图像。
• 如果设置参数无效，比如wMultiFrameNum太大造成相机帧缓存不够，API自动会使用最接近的参数对相机进行设置，所以设置成功以后，需要通过KSJ_CaptureGetFieldOfViewEx获取实际生效的参数。

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

KSJ_API int __stdcall KSJ_PreviewGetFieldOfViewEx	(	int	nIndex,
		int *	pnColStart,
		int *	pnRowStart,
		int *	pnColSize,
		int *	pnRowSize,
		KSJ_ADDRESSMODE *	pColAddressMode,
		KSJ_ADDRESSMODE *	pRowAddressMode,
		unsigned short *	pwMultiFrameNum
	)

KSJ_CaptureGetFieldOfViewEx.

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

获取预览的多帧拼接信息

参数:

	nIndex	[in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
	pnColStart	[out] 返返回拼接的单个帧图像感光芯片采集时成像感光的有效区域起始列位置
	pnRowStart	[out] 返回拼接的单个帧图像感光芯片采集时成像感光的有效区域起始行位置
	pnColSize	[out] 返回拼接的单个帧图像感光芯片采集时成像感光的有效区域水平像素数
	pnRowSize	[out] 返回拼接的单个帧图像感光芯片采集时成像感光的有效区域垂直行数
	pColAddressMode	[out] 返回拼接的单个帧图像感光芯片采集时成像感光的有效区域列抽点模式（请参考KSJ_ADDRESSMODE的定义）
	pRowAddressMode	[out] 返回拼接的单个帧图像感光芯片采集时成像感光的有效区域行抽点模式（请参考KSJ_ADDRESSMODE的定义）
	pwMultiFrameNum	[out] 返回采集的拼接帧数

返回:

成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。

注意:

调用KSJ_Init函数初始化后调用

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

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

KSJ_CaptureSetFieldOfViewEx.

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

设置多帧拼接时的采集视场

参数:

	nIndex	[in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
	nColStart	[in] 采集时拼接的单个帧有效成像区域相对于默认最大成像区域的水平像素起始位置
	nRowStart	[in] 采集时拼接的单个帧有效成像区域相对于最大默认成像区域的垂直行起始位置
	nColSize	[in] 采集时拼接的单个帧有效成像区域的水平像素数
	nRowSize	[in] 采集时拼接的单个帧有效成像区域的垂直行数
	AmCol	[in] 采集时拼接的单个帧针对有效成像区域列抽点模式（请参考KSJ_ADDRESSMODE的定义）
	AmRow	[in] 采集时针拼接的单个帧对有效成像区域行抽点模式（请参考KSJ_ADDRESSMODE的定义）
	wMultiFrameNum	[in] 设置单次采集的拼接帧数

返回:

成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。

注意:

调用KSJ_Init函数初始化后调用

• 设置多帧wMultiFrameNum>1时，内触发或者软触发，采集一次图像就会返回wMultiFrameNum帧图像组成的拼帧数据；如果是外触发或者固定帧率，需要有wMultiFrameNum个触发信号之后，采集函数才返回一个拼帧。
• 多帧情况更多是用在线阵相机时，自动拼接wMultiFrameNum行图像成一个面阵图像。
• 如果设置参数无效，比如wMultiFrameNum太大造成相机帧缓存不够，API自动会使用最接近的参数对相机进行设置，所以设置成功以后，需要通过KSJ_CaptureGetFieldOfViewEx获取实际生效的参数。

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

KSJ_API int __stdcall KSJ_CaptureGetFieldOfViewEx	(	int	nIndex,
		int *	pnColStart,
		int *	pnRowStart,
		int *	pnColSize,
		int *	pnRowSize,
		KSJ_ADDRESSMODE *	pColAddressMode,
		KSJ_ADDRESSMODE *	pRowAddressMode,
		unsigned short *	pwMultiFrameNum
	)

KSJ_CaptureGetFieldOfViewEx.

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

获取采集的多帧拼接信息

参数:

	nIndex	[in] 相机索引（从0开始，最大索引数为:连接到主机的相机数目减一）
	pnColStart	[out] 返返回拼接的单个帧图像感光芯片采集时成像感光的有效区域起始列位置
	pnRowStart	[out] 返回拼接的单个帧图像感光芯片采集时成像感光的有效区域起始行位置
	pnColSize	[out] 返回拼接的单个帧图像感光芯片采集时成像感光的有效区域水平像素数
	pnRowSize	[out] 返回拼接的单个帧图像感光芯片采集时成像感光的有效区域垂直行数
	pColAddressMode	[out] 返回拼接的单个帧图像感光芯片采集时成像感光的有效区域列抽点模式（请参考KSJ_ADDRESSMODE的定义）
	pRowAddressMode	[out] 返回拼接的单个帧图像感光芯片采集时成像感光的有效区域行抽点模式（请参考KSJ_ADDRESSMODE的定义）
	pwMultiFrameNum	[out] 返回采集的拼接帧数

返回:

成功返回 RET_SUCCESS(1)。否则返回非1值的错误码, 请参考 KSJCode.h 中错误码的定义。

注意:

调用KSJ_Init函数初始化后调用

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