捷易拍sdk开发指南

1

DoccameraOcx 控件参考文档V3.7.120527

一、 DoccameraOcx功能说明

DoccameraOcx这是一个连接福州捷宇电脑科技有限公司开发的捷易拍设备视频源的 ActiveX 控件。

二、 DoccameraOcx安装注册说明

运行Setup.bat进行安装，安装时要输入注册码，请将注册界面上的本机序列号发给供应商，供应商会根据你的序列号生成一个注册码。输入注册码后，点击“注册按钮”进行注册并安装OCX。商务会谈后发布免注册SDK。

三、 DoccameraOcx接口说明:

/*************************************************************************/

1、 BOOL bStartPlay();

/*************************************************************************/* 函数名称: bStartPlay

* 功能描述: 显示视频源

* 输入参数: 无

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

*/

/*************************************************************************/

2、 BOOL bPausePlay();

/*************************************************************************/* 函数名称: bPausePlay

* 功能描述: 暂停视频源的显示

* 输入参数: 无

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

*/

/*************************************************************************/

3、 BOOL bStopPlay();

/*************************************************************************/* 函数名称: bStopPlay

* 功能描述: 停止视频源的显示

* 输入参数: 无

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

*/

/*************************************************************************/

4、 BOOL bSaveBMP(LPCTSTR filePath, LPCTSTR fileName);

/*************************************************************************/* 函数名称: bSaveBMP

* 功能描述: 保存为BMP图片

* 输入参数: filePath 保存图片的路径

* filename 保存图片的名称（不用包含后缀名）

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如： m_cap.bSaveBMP("D:\\","bmpImage");

*/

/*************************************************************************/

5、 BOOL bSaveJPG(LPCTSTR filePath, LPCTSTR fileName);

/*************************************************************************/* 函数名称: bSaveJPG

* 功能描述: 保存为JPG图片

* 输入参数: filePath 保存图片的路径

* filename 保存图片的名称（不用包含后缀名）

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

*/

/*************************************************************************/

6、 BOOL bSavePNG(LPCTSTR filePath, LPCTSTR fileName);

/*************************************************************************/* 函数名称: bSavePNG

* 功能描述: 保存为PNG图片

* 输入参数: filePath 保存图片的路径

* filename 保存图片的名称（不用包含后缀名）

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

*/

/*************************************************************************/

7、 BOOL bSaveTIF (LPCTSTR filePath, LPCTSTR fileName);

/*************************************************************************/* 函数名称: bSaveTIF

* 功能描述: 保存为1位TIF图片

* 输入参数: filePath 保存图片的路径

* filename 保存图片的名称（不用包含后缀名）

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如： m_cap. bSaveTIFEx ("D:\\","tif");

*/

/*************************************************************************/

8、 void displayVideoPara();

/*************************************************************************/* 函数名称: displayVideoPara

* 功能描述: 显示并设置视频源参数

* 输入参数: 无

* 输出参数: 无

* 返回值: 无

*/

/*************************************************************************/

9、 void vSetDPI(long DPI_X, long DPI_Y);

/*************************************************************************/* 函数名称: vSetDPI

* 功能描述: 设置DPI

* 输入参数: DPI_X 横向DPI 默认 96

* DPI_Y 纵向DPI 默认 96

* 输出参数: 无

* 返回值: 无

*/

/*************************************************************************/

10、 void vGetDPI(long* DPI_X, long* DPI_Y);

/*************************************************************************/* 函数名称: vGetDPI

* 功能描述: 获取DPI

* 输入参数: 无

* 输出参数: DPI_X

* DPI_Y

* 返回值: 无

*/

横向DPI 默认 96 纵向DPI 默认 96

/*************************************************************************/

11、 void vSetTIFPara(float fRPara, float fGPara, float fBPara, float fWBPara); /*************************************************************************/* 函数名称: vSetTIFPara

* 功能描述: 设置二值化参数

* 输入参数: fRPara 红色参数 默认 0.3

* fGPara 绿色参数 默认 0.59

* fBPara 蓝色参数 默认 0.11

* fWBPara 阀值参数 默认 0.2

* 输出参数: 无

* 返回值: 无

*/

/*************************************************************************/

12、 void vGetTIFPara(float* fRPara, float* fGPara, float* fBPara, float* fWBPara);

/*************************************************************************/* 函数名称: vGetTIFPara

* 功能描述: 获取当前二值化参数

* 输入参数: 无

* 输出参数: fRPara

* fGPara

* fBPara

* fWBPara

* 返回值: 无

*/ 红色参数 绿色参数 蓝色参数 阀值参数 默认 0.3 默认 0.59 默认 0.11 默认 0.2

/*************************************************************************/

13、 void vSetRotate(short Rotate);

/*************************************************************************/ * 函数名称: vSetRotate

* 功能描述: 设置当前旋转角度

* 输入参数: Rotate 当前旋转角度

* 输出参数: 无

* 返回值: 无

*/ 默认 0度

/*************************************************************************/

14、 short iGetRotate();

/*************************************************************************/ * 函数名称: iGetRotate

* 功能描述: 获取当前旋转角度

* 输入参数: 无

* 输出参数: 无

* 返回值: 当前旋转角度 默认 0度

*/

/*************************************************************************/

15、 1BOOL bSaveGrayAndTIF(LPCTSTR grayPath, LPCTSTR grayName, LPCTSTR tifPath, LPCTSTR tifName );

/*************************************************************************/* 函数名称: bSaveGrayAndTIF

* 功能描述: 同时保存为Gray灰度图和TIF图片

* 输入参数: grayPath 保存Gray图片的路径

* grayName保存Gray图片的名称（不用包含后缀名OCX写死为。BMP） * tifPath 保存TIF图片的路径

* tifName 保存TIF图片的名称(不用包含后缀名OCX写死为。TIF） * 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如：

* m_cap.bSaveGrayAndTIF("D:\\","Gray1","D:\\","Gray1_FIT");

*/

/*************************************************************************/

16、 BOOL bSaveTifToOCR(LPCTSTR TifPath, LPCTSTR TifName);

/*************************************************************************/* 函数名称: bSaveTifToOCR

* 功能描述: 保存为Tif并进行OCR识别

* 输入参数: TifPath保存Tif图片的路径

* TifName保存Tif图片的名称（不用包含后缀名）

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如： m_cap. bSaveTifToOCR ("D:\\","TifImage");

* 备注： 该接口中有用到的微软的OCR，所以用这个接口时，要先安装微软的 * OCR程序。

*/

/*************************************************************************/

17、 BOOL bSetMode(short iMode);

/*************************************************************************/* 函数名称: bSetMode

* 功能描述: 设置拍照模式

* 输入参数: iMode 拍照模式

* 0 支持鼠标框选模式（默认模式）

* 1 定义固定大小拍照模式

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如：

* 备注：

m_cap. bSetMode(0); //设置为默认鼠标可以框选的模式 如果设置bSetMode(1)后，要用bSetImageArea ()函数定义拍照区域;

/*************************************************************************/

18、 BOOL bSetImageArea(short iX1, short iY1, short iX2, short iY2);

/*************************************************************************/* 函数名称: bSetImageArea

* 功能描述: 设置拍照区域大小（宽和高分为10000份））

* 输入参数: iX1 拍照区域的左边Left（1－10000）

* iY1 拍照区域的上边Top（1－10000）

* iX2 拍照区域的右边Right（1－10000）

* iY2 拍照区域的下边Bottom（1－10000）

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如： m_cap. bSetMode(1);

* m_cap. bSetImageArea (100，100，9900，9900);

* 备注： 调用该接口前要先调用bSetMode(1)函数，设置为1模式

*/

/*************************************************************************/

19、 BOOL bSetIamgeXYZoom(float fImageXYZoom);

/*************************************************************************/* 函数名称: bSetIamgeXYZoom

* 功能描述: 设置图片宽高分辨率的缩放率

* 输入参数: fImageXYZoom 宽高分辨率的缩放率

* 默认值为1.0

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如： m_cap. bSetIamgeXYZoom (0.8); 把图片分辨率缩小为原来的0.8倍 */

/*************************************************************************/

20、 void vSetImageQuality(short sImageQuality);

/*************************************************************************/* 函数名称: vSetImageQuality

* 功能描述: 设置图片保存的压缩率 （拍.BMP图片本函数无效）

* 输入参数: sImageQuality 图片保存的压缩率（1－100）

* 默认值为70

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如： m_cap. vSetImageQuality (70);

*/

/*************************************************************************/

21、 short sGetImageQuality();

/*************************************************************************/* 函数名称: sGetImageQuality

* 功能描述: 获取图片保存的压缩率（1－100）

* 输入参数: 无

* 输出参数: 无

* 返回值: 图片保存的压缩率（1－100）

* 例如： short sQuality = m_cap. sGetImageQuality ();

*/

/*************************************************************************/

22、 BOOL bStartPlayEx(long hwnd) ;

/*************************************************************************/* 函数名称: bStartPlayEx

* 功能描述: 显示视频源

* 输入参数: hwnd 显示视频的窗口句柄

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如： m_cap. bStartPlayEx ( hwnd);

*/

/*************************************************************************/

23、 BOOL bSaveTIFEx(LPCTSTR filePath, LPCTSTR fileName, short iMulPageFlag);

/*************************************************************************/* 函数名称: bSaveTIFEx

* 功能描述: 保存为1位TIF图片

* 输入参数: filePath 保存图片的路径

* filename 保存图片的名称（不用包含后缀名）

* iMulPageFlag 1为拍多页 0为拍单页

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如： m_cap. bSaveTIFEx ("D:\\","tif",0);

* 或者 m_cap. bSaveTIFEx ("D:\\","mulTif",1);

*/

24、 BOOL bGetSkewFlag(); /*************************************************************************/

/*************************************************************************/* 函数名称: bGetSkewFlag

* 功能描述: 获取自动矫正标志

* 输入参数: 无

* 输出参数: 无

* 返回值: TRUE：矫正 FALSE：不矫正

*/

/*************************************************************************/

25、 Void vSetSkewFlag (BOOL flag);

/*************************************************************************/* 函数名称: vSetSkewFlag

* 功能描述: 设置自动矫正标志

* 输入参数: flag：TRUE：矫正 FALSE：不矫正

* 输出参数: 无

* 返回值: 无

*/

/*************************************************************************/

26、 BOOL bGetDelHBFlag ();

/*************************************************************************/* 函数名称: bGetDelHBFlag

* 功能描述: 获取黑边去除标志

* 输入参数: 无

* 输出参数: 无

* 返回值: TRUE：矫正 FALSE：不矫正

*/

/*************************************************************************/

27、 Void vSetDelHBFlag (BOOL bFlag);

/*************************************************************************/* 函数名称: vSetSkewFlag

* 功能描述: 设置自动矫正标志

* 输入参数: bFlag：TRUE：矫正 FALSE：不矫正

* 输出参数: 无

* 返回值: 无

*/

/*************************************************************************/

28、 BOOL bStartPlay2 (short sRotate);

/*************************************************************************/* 函数名称: bStartPlay2

* 功能描述: 显示副视频源

* 输入参数: sRotate旋转角度

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如：

* m_cap. bStartPlay2 (0);

*/

/*************************************************************************/

29、 BOOL bStartPlay2Ex(long hwnd, short sRotate);

/*************************************************************************/* 函数名称: bStartPlay2Ex

* 功能描述: 显示副视频源

* 输入参数: hwnd 显示视频的窗口句柄

* 输入参数: sRotate旋转角度

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* m_cap. bStartPlay2 (hwnd ,90);//副摄像头

*/

/*************************************************************************/

30、 Void vSetCapturePin ();

/*************************************************************************/* 函数名称: vSetCapturePin

* 功能描述: 设置PIN参数

* 输入参数: 无

* 输出参数: 无

* 返回值: 无

*/

/*************************************************************************/

31、 BOOL bSaveGray (LPCTSTR grayPath, LPCTSTR grayName);

/*************************************************************************/* 函数名称: vSetCapturePin

* 功能描述: 保存灰度图

* 输入参数: grayPath 保存Gray图片的路径

* grayName保存Gray图片的名称（不用包含后缀名OCX写死为。BMP） * 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如：

* m_cap.bSaveGray("D:\\","Gray1");

*/

/*************************************************************************/

32、 BOOL bSaveTifJPG(LPCTSTR filePath, LPCTSTR fileName);

/*************************************************************************/* 函数名称: bSaveTifJPG

* 功能描述: 保存黑白JPG图片

* 输入参数: filePath 保存图片的路径

* filename 保存图片的名称（不用包含后缀名）

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如：

*/ m_cap. bSaveTifJPG ("D:\\","tifJpg");

/*************************************************************************/

33、 BOOL bRotateJpgImage (LPCTSTR pathName, short rotate);

/*************************************************************************/* 函数名称: bRotateJpgImage

* 功能描述: 图片旋转

* 输入参数: pathName图片的路径

* rotate图片旋转角度

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如： m_cap. bRotateJpgImage ("D:\\",90);

*/

/*************************************************************************/

34、 BOOL bDeleteFile(LPCTSTR pathName);

/*************************************************************************/* 函数名称: bDeleteFile

* 功能描述: 删除文件或者目录

* 输入参数: pathName文件或者目录的路径

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如： m_cap. bDeleteFile ("D:\\ tif.tif");

*/

/*************************************************************************/

35、 BOOL bCopyFile(LPCTSTR toPath, LPCTSTR fromPath);

/*************************************************************************/* 函数名称: bCopyFile

* 功能描述: 复制文件或者目录

* 输入参数: toPath 新的文件或者目录的路径

* fromPath被复制的文件或者目录的路径

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如： m_cap. bCopyFile ("D:\\ tif_bak.tif", "D:\\ tif.tif");

*/

36、 BOOL bMoveFile(LPCTSTR toPath, LPCTSTR fromPath); /*************************************************************************/

/*************************************************************************/*

函数名称: bMoveFile

* 功能描述: 移动文件或者目录

* 输入参数: toPath 移动后的文件或者目录的路径

* fromPath被移动的文件或者目录的路径

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如： m_cap. bMoveFile ("D:\\ tif_bak.tif", "D:\\ tif.tif");

*/

37、 BOOL bReNameFile(LPCTSTR toPath, LPCTSTR fromPath); /*************************************************************************/

/*************************************************************************/* 函数名称: bReNameFile

* 功能描述: 重命名文件或者目录

* 输入参数: toPath 重命名后的文件或者目录的路径

* fromPath重命名前的文件或者目录的路径

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如： m_cap. bReNameFile ("D:\\ tif_New.tif", "D:\\ tif.tif");

*/

/*************************************************************************/

38、 BOOL bUpLoadImage(LPCTSTR fileName, LPCTSTR serverName, short usPort, LPCTSTR objectName);

/*************************************************************************/* 函数名称: bUpLoadImage

* 功能描述: 上传指定图片到服务器

* 输入参数: fileName要上传图片的完整路径

* serverName服务器名称

* usPort端口号

* objectName 处理图片上传的服务器对象

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如： m_cap. bUpLoadImage ("D:\\JPG.JPG",

"/shop/servlet/uploadServlet");

*/ "127.0.0.1", 8080,

/*************************************************************************/

39、 BOOL bDispPath (LPCTSTR path);

/*************************************************************************/* 函数名称: bDispPath

* 功能描述: 显示目录

* 输入参数: path 目录的路径

* 输出参数: 无

* 返回值: TRUE：成功 FALSE：失败

* 例如： m_cap. bDispPath ("D:\\ ");

*/

40、 BSTR sGetBarCode (LPCTSTR imagePath); /*************************************************************************/

/*************************************************************************/* 函数名称: sGetBarCode

* 功能描述: 识别图片中的条形码

* 输入参数: imagePath 图片路径

* 输出参数: 无

* 返回值: 返回图片中的条形码

*/

/*************************************************************************/

41、 Void vSetResolution(short resolutionType);

/*************************************************************************/* 函数名称: vSetResolution

* 功能描述: 设置分辨率

* 输入参数: resolutionType分辨率类型 0：640*480 1：1024*768 2：1600*1200 3：2048*1536 3：2240*1600 其它：按设备默认值分辨率

* 输出参数: 无

* 返回值: 无

*/

四、本ActiveX 控件提供的DEMO在控件安装目录里。

本文来源：https://www.bwwdw.com/article/qt2m.html