攝像頭代碼實例解析

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

2、柄ResNullPointerErr0 x0002指針為空ResFileOpenErr0 x0003/文件打開失敗ResNoDeviceErr0 x0004/沒有設備連接Resin validParameterErr0 x0005/無效的參數(shù)ResOutOfMemoryErr0 x0006/內存溢出ResNoPreviewRunningErr0 x0007/預覽沒有開啟ResOSVersionErr0 x0008/操作系統(tǒng)版本錯誤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命令發(fā)出失敗ResUsbOpe n0 x0016/ USB端口已經打開ResCreate

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

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

6、系統(tǒng)搜索設備。CapInfoStruct結構定義：struct CapInfoStructUCHAR *Buffer;/用戶分配，用于接收采集的原始數(shù)據8bit百度文庫好好學習.天天向上-5ULONG Height;/ 采集高度百度文庫好好學習.天天向上-6UCHAR InternalUse; /用戶不要對此字節(jié)進行操作UCHAR ColorOff3; /用戶從外面不要改變此數(shù)組的值，要調用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函數(shù)HQDL_APIHqDLStartView( IN HANDLE hCamera,);功能：打開預覽窗口，并啟動視頻流參數(shù):hCamera通過調用HqDUnitialize得到的設備句柄說明：主要參數(shù)請參見CWnd : CreateEx函數(shù)說明。IN LP

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

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

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

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

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

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

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

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

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

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

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

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

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

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

22、數(shù)：保留，調用此函數(shù)時不允許開啟視頻說明：用戶暫不要調用。百度文庫-好好學習.天天向上-2522.HqDLSetDoAWB函數(shù)：HQDL.API HqDLSetDoAWB( INHANDLEhCamera,IN BOOL bAWB,IN BYTE btTarget,IN DL_AUTOCALLBACKpfAWBCallback,IN LPVOID IpContext);功能：設置白平衡操作完成的回調函數(shù)參數(shù)：hCamera通過調用HqDLInitialize得到的設備句柄pfAWBCallback指定AWB結束后的回調函數(shù)指針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、調函數(shù)，在傳 遞給回調函數(shù)的參數(shù)中給出操作結果，由于用戶來更新程序中的CapInfoStruct百度文庫-好好學習.天天向上-26結構,或更新界面的各項值。23.HqDLSetDoAE函數(shù)：HQDL.API HqDLSetDoAE( IN HANDLE hCamera,IN BOOL bAE,IN BYTE btTarget,IN DL.AUTOCALLBACKpfAECallback,IN LPVOID IpContext);功能：開始自動曝光操作參數(shù)：hCamera通過調用HqDLInitialize得到的設備句柄說明：百度文庫-好好學習.天天向上-2724. HqDLSetDoAF函數(shù)：

25、HQDL.API HqDLSetDoAF( IN HANDLE hCamera, IN BOOLbAF);功能: 開始自動聚焦參數(shù):hCamera通過調用HqDLInitialize得到的設備句柄說明:百度文庫-好好學習.天天向上-2825.HqDLSetViewWin函數(shù)：HQDL.API HqDLSetViewWin(IN HANDLE hCamera,IN DLVIDEORECT *pRect);功能設置預覽窗口的位置參數(shù)：hCamera通過調用HqDLInitialize得到的設備句柄說明：DLVIDEORECT結構定義如下：typedef struct _tagDLVIDEORECT

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

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

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

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

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