摄像头代码实例解析

1、百度文库好好学习.天天向上1.版本更新说明版本：更新日期：版本：更新日期：库说明：加入噪点检测函数HqDLNoiseCalibratio n加入位置调节函数HqDLSizeCalibration版本：更新日期：库说明：加入控制电机HqDLAutoFocus及光源函数HqDLLedControl版本：更新日期：库说明：加入avi录影HqDLCaptureToAvi及自动调焦功能HqDLSetDoAF注：提供的开发包的所有操作都是针对24比特BMP图像。百度文库好好学习.天天向上-22、返回值类型说明ResSuccess0 x0000/返回成功ResNullHandleErr0 x0001/无效句

2、柄ResNullPointerErr0 x0002指针为空ResFileOpenErr0 x0003/文件打开失败ResNoDeviceErr0 x0004/没有设备连接Resin validParameterErr0 x0005/无效的参数ResOutOfMemoryErr0 x0006/内存溢出ResNoPreviewRunningErr0 x0007/预览没有开启ResOSVersionErr0 x0008/操作系统版本错误ResUsbNotAvailableErr0 x0009/设备无效台gResNotSupportedErr0 x000a/设备不支持此功冃匕ResNoSerialSt

3、ring0 x000b/读取不到序列号百度文库好好学习.天天向上-3失败ResTimeoutErrOxOOOd/超时ResScaleModeErrOxOOOf/缩放葡吴Resllnk no wnErrOxOOff/未知错误nResDisplayWndExist0 x0011/应该关闭预览窗iiResAI located0 x0012/内存已经分配ResAllocateFail0 x0013/内存分配失败ResRead Error0 x0014/USB读取失败ResWriteError0 x0015/ USB命令发出失败ResUsbOpe n0 x0016/ USB端口已经打开ResCreate

4、StreamErr0 x0017/创建avi流失败ResSetStreamFormatErr0 x0018/设置AVI流格式ResVerificationErr0 x000c/效验失败百度文库好好学习.天天向上-43、HqDUnitialize函数：HQDL.API HqDLInitialize(IN LPCTSTRpFilterName,OUT int*plndexzIN CapInfoStruct *pCapInfo, OUT HANDLE*hCamera)；功能：初始化设备,返回摄像头句柄，用于其它函数的调用参数：plndex返回摄像头索引pFilterName保留pCapInfo初始化

5、摄像头参数hCamera返回给调用者的设备句柄说明： 必须要给pCapInfo-Buffer分配足够的内存空间,一般要 分配比最大的采集空间要大一些，推荐用MAXWIDTH*MAXHEIGHT+512 ,用于传递采集数据说明：此函数要先于所有的API函数，并且每一次调用，都要有HqDLUninitialize相对应。当返回ResSuccess时表示函数 调用成功，hCamera是返回给用户设备句柄。 这个句柄将作 为其它API函数的参数。注1:摄像头的索引值从0开始计数。用户可以通过索引值同时操 作多个摄像头。注2:摄像头的索引值在每次重新启动计算机后有可能发生改变。 般是根据插入的顺序由操作

6、系统搜索设备。CapInfoStruct结构定义：struct CapInfoStructUCHAR *Buffer;/用户分配，用于接收采集的原始数据8bit百度文库好好学习.天天向上-5ULONG Height;/ 采集高度百度文库好好学习.天天向上-6UCHAR InternalUse; /用户不要对此字节进行操作UCHAR ColorOff3; /用户从外面不要改变此数组的值，要调用EnableColorOffset来改变UCHAR Reserved4;/保留位注3对于3M像素的设备Exposure的取值范围一般在300MS左右。注4 : Control一般只在GoldenHawk系列

7、产品中使用，对于其他设备，初始化为0oULONG Width;ULONG OffsetX;ULONG OffsetY;ULONG Exposure;UCHAR Gain3;UCHAR Control;/采集宽度/水平偏移/垂直偏移/曝光值1-500MS/RGB增益1-63/控制位百度文库好好学习.天天向上-74、HqDLStartView函数HQDL_APIHqDLStartView( IN HANDLE hCamera,);功能：打开预览窗口，并启动视频流参数:hCamera通过调用HqDUnitialize得到的设备句柄说明：主要参数请参见CWnd : CreateEx函数说明。IN LP

8、CTSTRIN DWORDIN intIN intIN intIN intIN HWNDIpszWindowName,dwStyle,X,y，nWidth, nHeight,hwndPare nt,IN HMENUnIDorHMenu百度文库好好学习.天天向上-85. HqDLStopView函数:HQDL.API HqDLStopView( IN HANDLE hCamera );功能: 停止视频流参数:hCamera通过调用HqDLInitialize得到的设备句柄说明:百度文库好好学习.天天向上-96、HqDLPauseView函数：HQDL.API HqDLPauseView( IN

9、HANDLE hCamera, IN BOOLbPause);功能: 暂停视频流参数:hCamera通过调用HqDLInitialize得到的设备句柄说明:百度文库好好学习.天天向上7、HqDLUninitialize函数：HQDL.API HqDLUninitialize( IN HANDLE *hCamera );功能：反初始化设备参数：hCamera通过调用HqDLInitialize得到的设备句柄说明：必须在程序退出时调用，用于释放内存分配空间百度文库-好好学习.天天向上-io8、HqDLSetCapInfo函数：HQDL.API HqDLSetCapInfo( IN HANDLE h

10、Camera , INCapInfoStruct *pCapInfo);功能: 实时设置视频参数参数:hCamera通过调用HqDLInitialize得到的设备句柄说明:百度文库-好好学习.天天向上-129、HqDLGetFrameRate函数:HQDL.API HqDLGetFrameRate(IN HANDLE hCamera,OUT float *pfFrameRate );功能: 得到摄像头的当前帧率参数:hCamera通过调用HqDLInitialize得到的设备句柄说明:百度文库-好好学习.天天向上-1310 HqDLGetRawFrame函数：HQDL.API HqDLGetR

11、awFrame(IN HANDLEhCamera,IN struct CapInfoStruct功能:参数:*pCapI nfo);采集一帧原始数据到PCapInfo- Buffer中hCamera通过调用HqDLInitialize得到的设备句柄说明:百度文库-好好学习.天天向上-1411%HqDLGetRgbFrame函数：HQDL.APIHqDLGetRgbFrame(IN HANDLE hCamera, IN structCapInfoStruct *pCapInfo, OUT BYTE* pDest);功能hCamera通过调用HqDLInitialize得到的设备句柄参数：说明：采

12、集一帧24bitRGB数据到pDest中,同时原始数据会 保存在pCapInfo-Bu幵er中pDest中的结果会根据CAM PARAM中的设定而改变，如果设置bClearView,pDest中是经过优化的转换 算法而得到24bit的结果，如果设置bBW,那么是转换为8bit的灰 度图像数据，如果设置UPDOWN则图像数据会做相应的垂直翻转。百度文库-好好学习.天天向上-15L2. HqDLGetPa used Frame函数：HQDL.API HqDLGetPausedFrame(IN HANDLE hCamera,OUT BYTE* pDest);功能：根据当前暂停的视频，得到暂停的视频数

13、据参数：hCamera通过调用HqDLInitialize得到的设备句柄说明：通过调用此函数所得到的图像是当用户调用HqDLPauseView时暂存在内存中，等待用户来取得。参见HqDLPauseView函数。注：调用此函数时，视频流必须处于暂停状态。百度文库-好好学习.天天向上-1613. HqDLGetPausedFrameToBmp函数：HQDL_APIHqDLGetPausedFrameToBmp(IN HANDLEhCamera,OUT BYTE* pDest, LPCTSTR strFileName);功能 将当前暂停视频保存为BMP文件参数：hCamera通过调用HqDLInit

14、ialize得到的设备句柄说明：通过调用此函数所得到的图像是当用户调用HqDLPauseView时暂存在内存中,等待用户来取得。参见HqDLPauseView函数。注:调用此函数时，视频流必须处于暂停状态。百度文库-好好学习.天天向上-1714. HqDLGetRawFrameToBmp函数：HQDL.API HqDLGetRawFrameToBmp(IN HANDLEhCamera,IN struct CapInfoStruct *pCapInfo,LPCTSTR strFileName);功能：采集一帧原始数据到pCapInfo-Buffer中的同时，将原 始数据以8位位图的格式进行保存。

15、参数：hCamera通过调用HqDLInitialize得到的设备句柄说明：注:pCapInfo- Buffer必须由用户分配空间。百度文库-好好学习.天天向上-1815%HqDLGetRgbFrameToBmp函 数 ：HQDL.API HqDLGetRgbFrameToBmp( IN HANDLEhCamera,IN struct CapInfoStruct *pCapInfo,OUT BYTE* pDest, LPCTSTR strFileName);功能：采集一帧图像到文件，文件格式会根据CAM PARAM中的 设定改变。如果设置bClearView,pDest中是经过优化的转换算法而

16、 得到24bit的结果，如果设置bBW,那么是转换为8bit的灰度图像 数据，如果设置UPDOWN则图像数据会做相应的垂直翻转。参数：hCamera通过调用HqDLInitialize得到的设备句柄说明：注:pCapInfo-Buffer的空间必须在用户调用此函数前进行分配。 如果用户不想通过pDest得到Rgb数据 可以将pDest设置为NULL,这样开发包不会在保存文件的同时，拷贝数据到pDest中。百度文库-好好学习.天天向上-1916%HqDLSetParam函数：HQDL.API HqDLSetParam( IN HANDLE hCamera,DLPARAM DLParam,ULON

17、G Value);功能：设置图像参数参数：hCamera通过调用HqDLInitialize得到的设备句柄说明：DLParam定义如下：enum DLPARAM BWSHOW = 0,/是否黑白显示RAWDATASHOW, /是否直接显示原始数据CLEARVIEW,/是否利用优化算法进行转 换UPDOWN,/上下翻转；百度文库-好好学习.天天向上-2017. HqDLSetGammaValue函数：HQDL.API HqDLSetGammaValue( IN HANDLE hCamera,INfloatfGammaValue,INBOOLbGamma On);功能：加入Gamma校正功能参数：

18、hCamera通过调用HqDLInitialize得到的设备句柄fGammaValue推荐范围1-200bGammaOn TRUE加入Gamma校正功能说明：百度文库-好好学习.天天向上-2118%HqDLSetFrameCallback函数：HQDL.API HqDLSetFrameCallback( IN HANDLE hCamera,DL_FRAM ECALLBACK pfFrameCallback, LPVOID IpContext);功能：用于鼠标在预览窗口上点击的回调，IpParam为用户上下 文参数：hCamera通过调用HqDLInitialize得到的设备句柄pfFrameC

19、allback用户给定的每帧到达时的回调函数 地址IpContext用户上下文说明：回调函数的定义：typedef VOID (WINAPI *DL_FRAMECALLBACK)( LPVOID IpParaml,LPVOID IpPoint, LPVOID IpContext);IpParaml -指向显示数据指针IpPoint-鼠标点击图像位置IpContext-上下文回调函数的使用方法：百度文库-好好学习.天天向上-2219%HqDLEnableColorOffset函数：HQDL.API HqDLEnableColorOffset( IN HANDLEhCamera,IN int n

20、Red Offset,IN int nGreenOffset,IN int nBlueOffset,IN BOOL bColorOffset);功能: 进行颜色偏移量的调节参数:hCamera通过调用HqDLInitialize得到的设备句柄n Red Offset-255 255nGreenOffset255 255nBlueOffset -255 255说明：这3个色彩偏移量分别对应硬件中3个控制色彩的寄存器。百度文库-好好学习.天天向上-2320.HqDLBitOperation函数：HQDL.API HqDLBitOperation( IN HANDLE hCamera, INBYTE

21、 Out,OUT BYTE *pln, INUCHAR Comma nd );功能：对于智能证照检查仪，GoldenEagle , WhiteHawk的特 殊操作参数：保留，调用此函数时不允许开启视频说明：用户暂不要调用。百度文库-好好学习.天天向上-2421、HqDLRegOperation函数：HQDL_API HqDLRegOperation( IN HANDLEhCamera,IN BYTE Reg Ad dress, INOUT USHORT* Value, INBOOL bWrite);功能：对于GoldenHawk , GoldenEagle , WhiteHawk的特殊 操作参

22、数：保留，调用此函数时不允许开启视频说明：用户暂不要调用。百度文库-好好学习.天天向上-2522.HqDLSetDoAWB函数：HQDL.API HqDLSetDoAWB( INHANDLEhCamera,IN BOOL bAWB,IN BYTE btTarget,IN DL_AUTOCALLBACKpfAWBCallback,IN LPVOID IpContext);功能：设置白平衡操作完成的回调函数参数：hCamera通过调用HqDLInitialize得到的设备句柄pfAWBCallback指定AWB结束后的回调函数指针VOID (WINAPI *DL_AUTOCALLBACK )( D

23、WORD dwl,LPVOID IpContext);Ip Pa rami是指向AWB结果的指针， 通过Ip Pa rami来获 得AWB结果如下：ULONG Result = dwl;/ 0 xFF202020BYTE btRed= ( BYTE )(Result);/ 0 x20BYTE btGreen= ( BYTE )( Result8 );/ 0 x20BYTE btBlue= ( BYTE )( Result16 );/ 0 x20ULONG Exposure= ( BYTE )( Result24)*2;/255 *2 = 510 ms说明：当白平衡操作完成后,会调用用户设定的回

24、调函数，在传 递给回调函数的参数中给出操作结果，由于用户来更新程序中的CapInfoStruct百度文库-好好学习.天天向上-26结构,或更新界面的各项值。23.HqDLSetDoAE函数：HQDL.API HqDLSetDoAE( IN HANDLE hCamera,IN BOOL bAE,IN BYTE btTarget,IN DL.AUTOCALLBACKpfAECallback,IN LPVOID IpContext);功能：开始自动曝光操作参数：hCamera通过调用HqDLInitialize得到的设备句柄说明：百度文库-好好学习.天天向上-2724. HqDLSetDoAF函数：

25、HQDL.API HqDLSetDoAF( IN HANDLE hCamera, IN BOOLbAF);功能: 开始自动聚焦参数:hCamera通过调用HqDLInitialize得到的设备句柄说明:百度文库-好好学习.天天向上-2825.HqDLSetViewWin函数：HQDL.API HqDLSetViewWin(IN HANDLE hCamera,IN DLVIDEORECT *pRect);功能设置预览窗口的位置参数：hCamera通过调用HqDLInitialize得到的设备句柄说明：DLVIDEORECT结构定义如下：typedef struct _tagDLVIDEORECT

26、intLeft;/相对于父窗口的水平偏移intTop;/相对于父窗口的垂直偏移intWidth;/视频窗口宽度intHeight;/视频窗口高度JDLVIDEORECT *PDLVIDEORECT;百度文库-好好学习.天天向上-2926.HqDLGetViewWin函数：HQDL.API HqDLGetViewWin(IN HANDLE hCamera,IN DLVIDEORECT *pRect);功能得到预览窗口的位置参数：hCamera通过调用HqDLInitialize得到的设备句柄说明：DLVIDEORECT结构定义如下：typedef struct _tagDLVIDEORECTin

27、tLeft;/相对于父窗口的水平偏移intTop;/相对于父窗口的垂直偏移intWidth;/视频窗口宽度intHeight;/视频窗口高度JDLVIDEORECT, *PDLVIDEORECT;百度文库-好好学习.天天向上-3027、HqDLGetTotalDeviceNum函数：HQDL_API HqDLGetTotalDeviceNum( IN HANDLEhCamera,INint*pDeviceNum );功能：得到与本机连接的摄像头数目参数：hCamera通过调用HqDLInitialize得到的设备句柄说明:百度文库-好好学习.天天向上-3128.HqDLGetSerialsNu

28、m函数：HQDL_API HqDLGetSerialsNum(IN HANDLE hCamera,IN char *SerialsNum );功能：得到摄像头序列号参数：hCamera通过调用HqDLInitialize得到的设备句柄说明：目前的序列号不是真正意义上的序列号，它是固件版本 的说明。百度文库-好好学习.天天向上-3229.HqDLCalibration*pHeightzBOOL bWrite);功能：专门对于采集图像位置的校正，其参数存储在硬件之中参数：hCamera通过调用HqDLInitialize得到的设备句柄函数：HQDL_APIhCamera,*pWidth,HqDLS

29、izeCalibration(INHANDLEINOUTUSHORT*pOffHzINOUTUSHORT*pOffVzINOUTUSHORTINOUTUSHORT百度文库-好好学习.天天向上-33说明：GoldenHawk设备专有，其他设备不要调用此函数。百度文库-好好学习.天天向上-3430.HqDLNoiseCalibration函数：HQDL.API HqDLNoiseCalibration( IN HANDLE hCamera,constchar*FileName,BOOL bPreview,BOOL bSave);功能：加载校正图像，主要用于去除噪点。通过调用HqDLInitiali

30、ze得到的设备句指定是否在预览时加入去噪功能指定是否在保存时加入去噪功能加载校正图像的文件名，是采集原始数据得 到的256色bmp灰度图，当FileName =时，可以只设置加入去 噪的时机说明：可以在无视频流时调用参数：hCamera柄b PreviewbSaveFileName百度文库-好好学习.天天向上-35注意：加载图像的大小必须与视频采集大小相符，否则不会加载百度文库-好好学习.天天向上-3631.HqDLAutoFocus函数：HQDL_API HqDLAutoFocus( INHANDLEhCamera,USHORT Step, BOOLbFocusNear);功能：进行聚焦调节参数：hCamera通过调用HqDL