图像处理

包括图像显示、图像保存和图像格式转换接口等。 更多...

函数
MV_CAMCTRL_API int __stdcall	MV_CC_Display (IN void *handle, void *hWnd)
	显示图像，注册显示窗口，内部自动显示（与 MV_CC_GetImageBuffer() 不能同时使用） 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_DisplayOneFrame (IN void *handle, IN MV_DISPLAY_FRAME_INFO *pstDisplayInfo)
	显示一帧图像 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_SaveImageEx2 (IN void *handle, MV_SAVE_IMAGE_PARAM_EX *pSaveParam)
	保存图片，支持Bmp和Jpeg格式. Jpeg格式的编码质量在50-99之间 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_RotateImage (IN void *handle, IN OUT MV_CC_ROTATE_IMAGE_PARAM *pstRotateParam)
	图像旋转 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_FlipImage (IN void *handle, IN OUT MV_CC_FLIP_IMAGE_PARAM *pstFlipParam)
	图像翻转 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_ConvertPixelType (IN void *handle, IN OUT MV_CC_PIXEL_CONVERT_PARAM *pstCvtParam)
	像素格式转换 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_SetBayerCvtQuality (IN void *handle, IN unsigned int BayerCvtQuality)
	插值算法类型设置 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_SetBayerGammaParam (IN void *handle, IN MV_CC_GAMMA_PARAM *pstGammaParam)
	设置Bayer格式的Gamma信息 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_HB_Decode (IN void *handle, IN OUT MV_CC_HB_DECODE_PARAM *pstDecodeParam)
	无损解码 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_StartRecord (IN void *handle, IN MV_CC_RECORD_PARAM *pstRecordParam)
	开始录像 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_InputOneFrame (IN void *handle, IN MV_CC_INPUT_FRAME_INFO *pstInputFrameInfo)
	输入录像数据 更多...
MV_CAMCTRL_API int __stdcall	MV_CC_StopRecord (IN void *handle)
	停止录像 更多...

详细描述

包括图像显示、图像保存和图像格式转换接口等。

函数说明

MV_CC_Display()

MV_CAMCTRL_API int __stdcall MV_CC_Display	(	IN void *	handle,
		void *	hWnd
	)

显示图像，注册显示窗口，内部自动显示（与 MV_CC_GetImageBuffer() 不能同时使用）

参数

handle	[IN] 句柄
hWnd	[IN] 显示窗口句柄

返回

成功，返回MV_OK ；失败，返回错误码

MV_CC_DisplayOneFrame()

MV_CAMCTRL_API int __stdcall MV_CC_DisplayOneFrame	(	IN void *	handle,
		IN MV_DISPLAY_FRAME_INFO *	pstDisplayInfo
	)

显示一帧图像

参数

handle	[IN] 设备句柄
pstDisplayInfo	[IN] 图像信息

返回

成功，返回MV_OK；失败，返回错误码

备注

 • 该接口对于U3V、GIGE设备均可支持。

MV_CC_SaveImageEx2()

MV_CAMCTRL_API int __stdcall MV_CC_SaveImageEx2	(	IN void *	handle,
		MV_SAVE_IMAGE_PARAM_EX *	pSaveParam
	)

保存图片，支持Bmp和Jpeg格式. Jpeg格式的编码质量在50-99之间

参数

handle	[IN] 设备句柄
pSaveParam	[IN][OUT] 保存图片参数结构体

返回

成功，返回MV_OK ；失败，返回错误码

备注

 • 通过将接口可以将从设备采集到的原始图像数据转换成JPEG或者BMP等格式并存放在指定内存中，然后用户可以将转换之后的数据直接保存成图片文件。该接口调用无接口顺序要求，有图像源数据就可以进行转换，可以先调用图像采集 接口，获取一帧图像数据，然后再通过该接口转换格式。
 • MV_CC_SaveImageEx2() 比 MV_CC_SaveImageEx() 增加参数handle，为了保证与其他接口的统一。

示例

ImageProcess.cpp.

MV_CC_RotateImage()

MV_CAMCTRL_API int __stdcall MV_CC_RotateImage	(	IN void *	handle,
		IN OUT MV_CC_ROTATE_IMAGE_PARAM *	pstRotateParam
	)

图像旋转

参数

handle	[IN] 设备句柄
pstRotateParam	[IN][OUT] 图像旋转参数结构体

返回

成功，返回MV_OK ；失败，返回错误码

备注

该接口只支持MONO8/RGB24/BGR24格式数据的90/180/270度旋转。

MV_CC_FlipImage()

MV_CAMCTRL_API int __stdcall MV_CC_FlipImage	(	IN void *	handle,
		IN OUT MV_CC_FLIP_IMAGE_PARAM *	pstFlipParam
	)

图像翻转

参数

handle	[IN] 设备句柄
pstFlipParam	[IN][OUT] 图像翻转参数结构体

返回

成功，返回MV_OK ；失败，返回错误码

备注

该接口只支持MONO8/RGB24/BGR24格式数据的垂直和水平翻转。

MV_CC_ConvertPixelType()

MV_CAMCTRL_API int __stdcall MV_CC_ConvertPixelType	(	IN void *	handle,
		IN OUT MV_CC_PIXEL_CONVERT_PARAM *	pstCvtParam
	)

像素格式转换

参数

handle	[IN] 设备句柄
pstCvtParam	[IN][OUT] 像素格式转换参数结构体

返回

成功，返回MV_OK ；失败，返回错误码

备注

 • 通过将接口可以将从设备采集到的原始图像数据转换成用户所需的像素格式并存放在指定内存中。该接口调用无接口顺序要求，有图像源数据就可以进行转换，可以先调用图像采集 接口，获取一帧图像数据，然后再通过该接口转换格式。如果相机当前采集图像是JPEG压缩的格式，则不支持调用该接口进行显示。
 •  目前支持转换的输入输出像素格式如下表所示：

示例

ImageProcess.cpp.

MV_CC_SetBayerCvtQuality()

MV_CAMCTRL_API int __stdcall MV_CC_SetBayerCvtQuality	(	IN void *	handle,
		IN unsigned int	BayerCvtQuality
	)

插值算法类型设置

参数

handle	[IN] 设备句柄
BayerCvtQuality	[IN] Bayer的插值方法 快速 均衡 最优

返回

成功，返回MV_OK ；失败，返回错误码

备注

 • 设置内部图像转换接口的贝尔插值质量参数， MV_CC_ConvertPixelType() 、 MV_CC_SaveImageEx2() 接口内部使用的插值算法是该接口所设定的。

定义值	含义
0	最邻近
1	双线性
2	Hamilton

MV_CC_SetBayerGammaParam()

MV_CAMCTRL_API int __stdcall MV_CC_SetBayerGammaParam	(	IN void *	handle,
		IN MV_CC_GAMMA_PARAM *	pstGammaParam
	)

设置Bayer格式的Gamma信息

参数

handle	[IN] 设备句柄
pstGammaParam	[IN] Gamma信息

返回

成功，返回MV_OK ；失败，返回错误码

备注

设置该信息后，在调用MV_CC_ConvertPixelType、MV_CC_SaveImageEx2接口将Bayer8/10/12/16格式转成RGB24/48， RGBA32/64，BGR24/48，BGRA32/64时起效。

MV_CC_HB_Decode()

MV_CAMCTRL_API int __stdcall MV_CC_HB_Decode	(	IN void *	handle,
		IN OUT MV_CC_HB_DECODE_PARAM *	pstDecodeParam
	)

无损解码

参数

handle	[IN] 设备句柄
pstDecodeParam	[IN][OUT] 无损解码参数结构体

返回

成功，返回MV_OK ；失败，返回错误码

备注

将从相机中取到的无损压缩码流解码成裸数据，同时支持解析当前相机实时图像的水印信息（如果输入的无损码流不是当前相机或者不是实时取流的，则水印解析可能异常）

MV_CC_StartRecord()

MV_CAMCTRL_API int __stdcall MV_CC_StartRecord	(	IN void *	handle,
		IN MV_CC_RECORD_PARAM *	pstRecordParam
	)

开始录像

参数

handle	[IN] 设备句柄
pstRecordParam	[IN] 录像参数结构体

返回

成功，返回MV_OK ；失败，返回错误码

MV_CC_InputOneFrame()

MV_CAMCTRL_API int __stdcall MV_CC_InputOneFrame	(	IN void *	handle,
		IN MV_CC_INPUT_FRAME_INFO *	pstInputFrameInfo
	)

输入录像数据

参数

handle	[IN] 设备句柄
pstInputFrameInfo	[IN] 录像数据结构体

返回

成功，返回MV_OK ；失败，返回错误码

MV_CC_StopRecord()

MV_CAMCTRL_API int __stdcall MV_CC_StopRecord

(

IN void *

handle

)

停止录像

参数

handle

[IN] 设备句柄

返回

成功，返回MV_OK ；失败，返回错误码