攝像頭代碼實(shí)例解析

1、百度文庫(kù)好好學(xué)習(xí).天天向上1.版本更新說(shuō)明版本：更新日期：版本：更新日期：庫(kù)說(shuō)明：加入噪點(diǎn)檢測(cè)函數(shù)HqDLNoiseCalibratio n加入位置調(diào)節(jié)函數(shù)HqDLSizeCalibration版本：更新日期：庫(kù)說(shuō)明：加入控制電機(jī)HqDLAutoFocus及光源函數(shù)HqDLLedControl版本：更新日期：庫(kù)說(shuō)明：加入avi錄影HqDLCaptureToAvi及自動(dòng)調(diào)焦功能HqDLSetDoAF注：提供的開(kāi)發(fā)包的所有操作都是針對(duì)24比特BMP圖像。百度文庫(kù)好好學(xué)習(xí).天天向上-22、返回值類(lèi)型說(shuō)明ResSuccess0 x0000/返回成功ResNullHandleErr0 x0001/無(wú)效句

2、柄ResNullPointerErr0 x0002指針為空ResFileOpenErr0 x0003/文件打開(kāi)失敗ResNoDeviceErr0 x0004/沒(méi)有設(shè)備連接Resin validParameterErr0 x0005/無(wú)效的參數(shù)ResOutOfMemoryErr0 x0006/內(nèi)存溢出ResNoPreviewRunningErr0 x0007/預(yù)覽沒(méi)有開(kāi)啟ResOSVersionErr0 x0008/操作系統(tǒng)版本錯(cuò)誤ResUsbNotAvailableErr0 x0009/設(shè)備無(wú)效臺(tái)gResNotSupportedErr0 x000a/設(shè)備不支持此功冃匕ResNoSerialSt

3、ring0 x000b/讀取不到序列號(hào)百度文庫(kù)好好學(xué)習(xí).天天向上-3失敗ResTimeoutErrOxOOOd/超時(shí)ResScaleModeErrOxOOOf/縮放葡吳Resllnk no wnErrOxOOff/未知錯(cuò)誤nResDisplayWndExist0 x0011/應(yīng)該關(guān)閉預(yù)覽窗iiResAI located0 x0012/內(nèi)存已經(jīng)分配ResAllocateFail0 x0013/內(nèi)存分配失敗ResRead Error0 x0014/USB讀取失敗ResWriteError0 x0015/ USB命令發(fā)出失敗ResUsbOpe n0 x0016/ USB端口已經(jīng)打開(kāi)ResCreate

4、StreamErr0 x0017/創(chuàng)建avi流失敗ResSetStreamFormatErr0 x0018/設(shè)置AVI流格式ResVerificationErr0 x000c/效驗(yàn)失敗百度文庫(kù)好好學(xué)習(xí).天天向上-43、HqDUnitialize函數(shù)：HQDL.API HqDLInitialize(IN LPCTSTRpFilterName,OUT int*plndexzIN CapInfoStruct *pCapInfo, OUT HANDLE*hCamera)；功能：初始化設(shè)備,返回?cái)z像頭句柄，用于其它函數(shù)的調(diào)用參數(shù)：plndex返回?cái)z像頭索引pFilterName保留pCapInfo初始化

5、攝像頭參數(shù)hCamera返回給調(diào)用者的設(shè)備句柄說(shuō)明： 必須要給pCapInfo-Buffer分配足夠的內(nèi)存空間,一般要 分配比最大的采集空間要大一些，推薦用MAXWIDTH*MAXHEIGHT+512 ,用于傳遞采集數(shù)據(jù)說(shuō)明：此函數(shù)要先于所有的API函數(shù)，并且每一次調(diào)用，都要有HqDLUninitialize相對(duì)應(yīng)。當(dāng)返回ResSuccess時(shí)表示函數(shù) 調(diào)用成功，hCamera是返回給用戶(hù)設(shè)備句柄。 這個(gè)句柄將作 為其它API函數(shù)的參數(shù)。注1:攝像頭的索引值從0開(kāi)始計(jì)數(shù)。用戶(hù)可以通過(guò)索引值同時(shí)操 作多個(gè)攝像頭。注2:攝像頭的索引值在每次重新啟動(dòng)計(jì)算機(jī)后有可能發(fā)生改變。 般是根據(jù)插入的順序由操作

6、系統(tǒng)搜索設(shè)備。CapInfoStruct結(jié)構(gòu)定義：struct CapInfoStructUCHAR *Buffer;/用戶(hù)分配，用于接收采集的原始數(shù)據(jù)8bit百度文庫(kù)好好學(xué)習(xí).天天向上-5ULONG Height;/ 采集高度百度文庫(kù)好好學(xué)習(xí).天天向上-6UCHAR InternalUse; /用戶(hù)不要對(duì)此字節(jié)進(jìn)行操作UCHAR ColorOff3; /用戶(hù)從外面不要改變此數(shù)組的值，要調(diào)用EnableColorOffset來(lái)改變UCHAR Reserved4;/保留位注3對(duì)于3M像素的設(shè)備Exposure的取值范圍一般在300MS左右。注4 : Control一般只在GoldenHawk系列

7、產(chǎn)品中使用，對(duì)于其他設(shè)備，初始化為0oULONG Width;ULONG OffsetX;ULONG OffsetY;ULONG Exposure;UCHAR Gain3;UCHAR Control;/采集寬度/水平偏移/垂直偏移/曝光值1-500MS/RGB增益1-63/控制位百度文庫(kù)好好學(xué)習(xí).天天向上-74、HqDLStartView函數(shù)HQDL_APIHqDLStartView( IN HANDLE hCamera,);功能：打開(kāi)預(yù)覽窗口，并啟動(dòng)視頻流參數(shù):hCamera通過(guò)調(diào)用HqDUnitialize得到的設(shè)備句柄說(shuō)明：主要參數(shù)請(qǐng)參見(jiàn)CWnd : CreateEx函數(shù)說(shuō)明。IN LP

8、CTSTRIN DWORDIN intIN intIN intIN intIN HWNDIpszWindowName,dwStyle,X,y，nWidth, nHeight,hwndPare nt,IN HMENUnIDorHMenu百度文庫(kù)好好學(xué)習(xí).天天向上-85. HqDLStopView函數(shù):HQDL.API HqDLStopView( IN HANDLE hCamera );功能: 停止視頻流參數(shù):hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄說(shuō)明:百度文庫(kù)好好學(xué)習(xí).天天向上-96、HqDLPauseView函數(shù)：HQDL.API HqDLPauseView( IN

9、HANDLE hCamera, IN BOOLbPause);功能: 暫停視頻流參數(shù):hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄說(shuō)明:百度文庫(kù)好好學(xué)習(xí).天天向上7、HqDLUninitialize函數(shù)：HQDL.API HqDLUninitialize( IN HANDLE *hCamera );功能：反初始化設(shè)備參數(shù)：hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄說(shuō)明：必須在程序退出時(shí)調(diào)用，用于釋放內(nèi)存分配空間百度文庫(kù)-好好學(xué)習(xí).天天向上-io8、HqDLSetCapInfo函數(shù)：HQDL.API HqDLSetCapInfo( IN HANDLE h

10、Camera , INCapInfoStruct *pCapInfo);功能: 實(shí)時(shí)設(shè)置視頻參數(shù)參數(shù):hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄說(shuō)明:百度文庫(kù)-好好學(xué)習(xí).天天向上-129、HqDLGetFrameRate函數(shù):HQDL.API HqDLGetFrameRate(IN HANDLE hCamera,OUT float *pfFrameRate );功能: 得到攝像頭的當(dāng)前幀率參數(shù):hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄說(shuō)明:百度文庫(kù)-好好學(xué)習(xí).天天向上-1310 HqDLGetRawFrame函數(shù)：HQDL.API HqDLGetR

11、awFrame(IN HANDLEhCamera,IN struct CapInfoStruct功能:參數(shù):*pCapI nfo);采集一幀原始數(shù)據(jù)到PCapInfo- Buffer中hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄說(shuō)明:百度文庫(kù)-好好學(xué)習(xí).天天向上-1411%HqDLGetRgbFrame函數(shù)：HQDL.APIHqDLGetRgbFrame(IN HANDLE hCamera, IN structCapInfoStruct *pCapInfo, OUT BYTE* pDest);功能hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄參數(shù)：說(shuō)明：采

12、集一幀24bitRGB數(shù)據(jù)到pDest中,同時(shí)原始數(shù)據(jù)會(huì) 保存在pCapInfo-Bu幵er中pDest中的結(jié)果會(huì)根據(jù)CAM PARAM中的設(shè)定而改變，如果設(shè)置bClearView,pDest中是經(jīng)過(guò)優(yōu)化的轉(zhuǎn)換 算法而得到24bit的結(jié)果，如果設(shè)置bBW,那么是轉(zhuǎn)換為8bit的灰 度圖像數(shù)據(jù)，如果設(shè)置UPDOWN則圖像數(shù)據(jù)會(huì)做相應(yīng)的垂直翻轉(zhuǎn)。百度文庫(kù)-好好學(xué)習(xí).天天向上-15L2. HqDLGetPa used Frame函數(shù)：HQDL.API HqDLGetPausedFrame(IN HANDLE hCamera,OUT BYTE* pDest);功能：根據(jù)當(dāng)前暫停的視頻，得到暫停的視頻數(shù)

13、據(jù)參數(shù)：hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄說(shuō)明：通過(guò)調(diào)用此函數(shù)所得到的圖像是當(dāng)用戶(hù)調(diào)用HqDLPauseView時(shí)暫存在內(nèi)存中，等待用戶(hù)來(lái)取得。參見(jiàn)HqDLPauseView函數(shù)。注：調(diào)用此函數(shù)時(shí)，視頻流必須處于暫停狀態(tài)。百度文庫(kù)-好好學(xué)習(xí).天天向上-1613. HqDLGetPausedFrameToBmp函數(shù)：HQDL_APIHqDLGetPausedFrameToBmp(IN HANDLEhCamera,OUT BYTE* pDest, LPCTSTR strFileName);功能 將當(dāng)前暫停視頻保存為BMP文件參數(shù)：hCamera通過(guò)調(diào)用HqDLInit

14、ialize得到的設(shè)備句柄說(shuō)明：通過(guò)調(diào)用此函數(shù)所得到的圖像是當(dāng)用戶(hù)調(diào)用HqDLPauseView時(shí)暫存在內(nèi)存中,等待用戶(hù)來(lái)取得。參見(jiàn)HqDLPauseView函數(shù)。注:調(diào)用此函數(shù)時(shí)，視頻流必須處于暫停狀態(tài)。百度文庫(kù)-好好學(xué)習(xí).天天向上-1714. HqDLGetRawFrameToBmp函數(shù)：HQDL.API HqDLGetRawFrameToBmp(IN HANDLEhCamera,IN struct CapInfoStruct *pCapInfo,LPCTSTR strFileName);功能：采集一幀原始數(shù)據(jù)到pCapInfo-Buffer中的同時(shí)，將原 始數(shù)據(jù)以8位位圖的格式進(jìn)行保存。

15、參數(shù)：hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄說(shuō)明：注:pCapInfo- Buffer必須由用戶(hù)分配空間。百度文庫(kù)-好好學(xué)習(xí).天天向上-1815%HqDLGetRgbFrameToBmp函 數(shù) ：HQDL.API HqDLGetRgbFrameToBmp( IN HANDLEhCamera,IN struct CapInfoStruct *pCapInfo,OUT BYTE* pDest, LPCTSTR strFileName);功能：采集一幀圖像到文件，文件格式會(huì)根據(jù)CAM PARAM中的 設(shè)定改變。如果設(shè)置bClearView,pDest中是經(jīng)過(guò)優(yōu)化的轉(zhuǎn)換算法而

16、 得到24bit的結(jié)果，如果設(shè)置bBW,那么是轉(zhuǎn)換為8bit的灰度圖像 數(shù)據(jù)，如果設(shè)置UPDOWN則圖像數(shù)據(jù)會(huì)做相應(yīng)的垂直翻轉(zhuǎn)。參數(shù)：hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄說(shuō)明：注:pCapInfo-Buffer的空間必須在用戶(hù)調(diào)用此函數(shù)前進(jìn)行分配。 如果用戶(hù)不想通過(guò)pDest得到Rgb數(shù)據(jù) 可以將pDest設(shè)置為NULL,這樣開(kāi)發(fā)包不會(huì)在保存文件的同時(shí)，拷貝數(shù)據(jù)到pDest中。百度文庫(kù)-好好學(xué)習(xí).天天向上-1916%HqDLSetParam函數(shù)：HQDL.API HqDLSetParam( IN HANDLE hCamera,DLPARAM DLParam,ULON

17、G Value);功能：設(shè)置圖像參數(shù)參數(shù)：hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄說(shuō)明：DLParam定義如下：enum DLPARAM BWSHOW = 0,/是否黑白顯示RAWDATASHOW, /是否直接顯示原始數(shù)據(jù)CLEARVIEW,/是否利用優(yōu)化算法進(jìn)行轉(zhuǎn) 換UPDOWN,/上下翻轉(zhuǎn)；百度文庫(kù)-好好學(xué)習(xí).天天向上-2017. HqDLSetGammaValue函數(shù)：HQDL.API HqDLSetGammaValue( IN HANDLE hCamera,INfloatfGammaValue,INBOOLbGamma On);功能：加入Gamma校正功能參數(shù)：

18、hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄fGammaValue推薦范圍1-200bGammaOn TRUE加入Gamma校正功能說(shuō)明：百度文庫(kù)-好好學(xué)習(xí).天天向上-2118%HqDLSetFrameCallback函數(shù)：HQDL.API HqDLSetFrameCallback( IN HANDLE hCamera,DL_FRAM ECALLBACK pfFrameCallback, LPVOID IpContext);功能：用于鼠標(biāo)在預(yù)覽窗口上點(diǎn)擊的回調(diào)，IpParam為用戶(hù)上下 文參數(shù)：hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄pfFrameC

19、allback用戶(hù)給定的每幀到達(dá)時(shí)的回調(diào)函數(shù) 地址IpContext用戶(hù)上下文說(shuō)明：回調(diào)函數(shù)的定義：typedef VOID (WINAPI *DL_FRAMECALLBACK)( LPVOID IpParaml,LPVOID IpPoint, LPVOID IpContext);IpParaml -指向顯示數(shù)據(jù)指針I(yè)pPoint-鼠標(biāo)點(diǎn)擊圖像位置IpContext-上下文回調(diào)函數(shù)的使用方法：百度文庫(kù)-好好學(xué)習(xí).天天向上-2219%HqDLEnableColorOffset函數(shù)：HQDL.API HqDLEnableColorOffset( IN HANDLEhCamera,IN int n

20、Red Offset,IN int nGreenOffset,IN int nBlueOffset,IN BOOL bColorOffset);功能: 進(jìn)行顏色偏移量的調(diào)節(jié)參數(shù):hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄n Red Offset-255 255nGreenOffset255 255nBlueOffset -255 255說(shuō)明：這3個(gè)色彩偏移量分別對(duì)應(yīng)硬件中3個(gè)控制色彩的寄存器。百度文庫(kù)-好好學(xué)習(xí).天天向上-2320.HqDLBitOperation函數(shù)：HQDL.API HqDLBitOperation( IN HANDLE hCamera, INBYTE

21、 Out,OUT BYTE *pln, INUCHAR Comma nd );功能：對(duì)于智能證照檢查儀，GoldenEagle , WhiteHawk的特 殊操作參數(shù)：保留，調(diào)用此函數(shù)時(shí)不允許開(kāi)啟視頻說(shuō)明：用戶(hù)暫不要調(diào)用。百度文庫(kù)-好好學(xué)習(xí).天天向上-2421、HqDLRegOperation函數(shù)：HQDL_API HqDLRegOperation( IN HANDLEhCamera,IN BYTE Reg Ad dress, INOUT USHORT* Value, INBOOL bWrite);功能：對(duì)于GoldenHawk , GoldenEagle , WhiteHawk的特殊 操作參

22、數(shù)：保留，調(diào)用此函數(shù)時(shí)不允許開(kāi)啟視頻說(shuō)明：用戶(hù)暫不要調(diào)用。百度文庫(kù)-好好學(xué)習(xí).天天向上-2522.HqDLSetDoAWB函數(shù)：HQDL.API HqDLSetDoAWB( INHANDLEhCamera,IN BOOL bAWB,IN BYTE btTarget,IN DL_AUTOCALLBACKpfAWBCallback,IN LPVOID IpContext);功能：設(shè)置白平衡操作完成的回調(diào)函數(shù)參數(shù)：hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄pfAWBCallback指定AWB結(jié)束后的回調(diào)函數(shù)指針VOID (WINAPI *DL_AUTOCALLBACK )( D

23、WORD dwl,LPVOID IpContext);Ip Pa rami是指向AWB結(jié)果的指針， 通過(guò)Ip Pa rami來(lái)獲 得AWB結(jié)果如下：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說(shuō)明：當(dāng)白平衡操作完成后,會(huì)調(diào)用用戶(hù)設(shè)定的回

24、調(diào)函數(shù)，在傳 遞給回調(diào)函數(shù)的參數(shù)中給出操作結(jié)果，由于用戶(hù)來(lái)更新程序中的CapInfoStruct百度文庫(kù)-好好學(xué)習(xí).天天向上-26結(jié)構(gòu),或更新界面的各項(xiàng)值。23.HqDLSetDoAE函數(shù)：HQDL.API HqDLSetDoAE( IN HANDLE hCamera,IN BOOL bAE,IN BYTE btTarget,IN DL.AUTOCALLBACKpfAECallback,IN LPVOID IpContext);功能：開(kāi)始自動(dòng)曝光操作參數(shù)：hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄說(shuō)明：百度文庫(kù)-好好學(xué)習(xí).天天向上-2724. HqDLSetDoAF函數(shù)：

25、HQDL.API HqDLSetDoAF( IN HANDLE hCamera, IN BOOLbAF);功能: 開(kāi)始自動(dòng)聚焦參數(shù):hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄說(shuō)明:百度文庫(kù)-好好學(xué)習(xí).天天向上-2825.HqDLSetViewWin函數(shù)：HQDL.API HqDLSetViewWin(IN HANDLE hCamera,IN DLVIDEORECT *pRect);功能設(shè)置預(yù)覽窗口的位置參數(shù)：hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄說(shuō)明：DLVIDEORECT結(jié)構(gòu)定義如下：typedef struct _tagDLVIDEORECT

26、intLeft;/相對(duì)于父窗口的水平偏移intTop;/相對(duì)于父窗口的垂直偏移intWidth;/視頻窗口寬度intHeight;/視頻窗口高度JDLVIDEORECT *PDLVIDEORECT;百度文庫(kù)-好好學(xué)習(xí).天天向上-2926.HqDLGetViewWin函數(shù)：HQDL.API HqDLGetViewWin(IN HANDLE hCamera,IN DLVIDEORECT *pRect);功能得到預(yù)覽窗口的位置參數(shù)：hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄說(shuō)明：DLVIDEORECT結(jié)構(gòu)定義如下：typedef struct _tagDLVIDEORECTin

27、tLeft;/相對(duì)于父窗口的水平偏移intTop;/相對(duì)于父窗口的垂直偏移intWidth;/視頻窗口寬度intHeight;/視頻窗口高度JDLVIDEORECT, *PDLVIDEORECT;百度文庫(kù)-好好學(xué)習(xí).天天向上-3027、HqDLGetTotalDeviceNum函數(shù)：HQDL_API HqDLGetTotalDeviceNum( IN HANDLEhCamera,INint*pDeviceNum );功能：得到與本機(jī)連接的攝像頭數(shù)目參數(shù)：hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄說(shuō)明:百度文庫(kù)-好好學(xué)習(xí).天天向上-3128.HqDLGetSerialsNu

28、m函數(shù)：HQDL_API HqDLGetSerialsNum(IN HANDLE hCamera,IN char *SerialsNum );功能：得到攝像頭序列號(hào)參數(shù)：hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄說(shuō)明：目前的序列號(hào)不是真正意義上的序列號(hào)，它是固件版本 的說(shuō)明。百度文庫(kù)-好好學(xué)習(xí).天天向上-3229.HqDLCalibration*pHeightzBOOL bWrite);功能：專(zhuān)門(mén)對(duì)于采集圖像位置的校正，其參數(shù)存儲(chǔ)在硬件之中參數(shù)：hCamera通過(guò)調(diào)用HqDLInitialize得到的設(shè)備句柄函數(shù)：HQDL_APIhCamera,*pWidth,HqDLS

29、izeCalibration(INHANDLEINOUTUSHORT*pOffHzINOUTUSHORT*pOffVzINOUTUSHORTINOUTUSHORT百度文庫(kù)-好好學(xué)習(xí).天天向上-33說(shuō)明：GoldenHawk設(shè)備專(zhuān)有，其他設(shè)備不要調(diào)用此函數(shù)。百度文庫(kù)-好好學(xué)習(xí).天天向上-3430.HqDLNoiseCalibration函數(shù)：HQDL.API HqDLNoiseCalibration( IN HANDLE hCamera,constchar*FileName,BOOL bPreview,BOOL bSave);功能：加載校正圖像，主要用于去除噪點(diǎn)。通過(guò)調(diào)用HqDLInitiali

30、ze得到的設(shè)備句指定是否在預(yù)覽時(shí)加入去噪功能指定是否在保存時(shí)加入去噪功能加載校正圖像的文件名，是采集原始數(shù)據(jù)得 到的256色bmp灰度圖，當(dāng)FileName =時(shí)，可以只設(shè)置加入去 噪的時(shí)機(jī)說(shuō)明：可以在無(wú)視頻流時(shí)調(diào)用參數(shù)：hCamera柄b PreviewbSaveFileName百度文庫(kù)-好好學(xué)習(xí).天天向上-35注意：加載圖像的大小必須與視頻采集大小相符，否則不會(huì)加載百度文庫(kù)-好好學(xué)習(xí).天天向上-3631.HqDLAutoFocus函數(shù)：HQDL_API HqDLAutoFocus( INHANDLEhCamera,USHORT Step, BOOLbFocusNear);功能：進(jìn)行聚焦調(diào)節(jié)參數(shù)：hCamera通過(guò)調(diào)用HqDL