數(shù)字?jǐn)z像機(jī)軟件開發(fā)說(shuō)明書

1、 大恒圖像系列數(shù)字?jǐn)z像機(jī)數(shù)字?jǐn)z像機(jī)軟件開發(fā)說(shuō)明書2011年5月版本手冊(cè)中所提及的其它軟硬件產(chǎn)品的商標(biāo)與名稱,都屬于相應(yīng)公司所有。本手冊(cè)的版權(quán)屬于中國(guó)大恒(集團(tuán)有限公司北京圖像視覺技術(shù)分公司所有。未得到本公司的正式許可,任何組織或個(gè)人均不得以任何手段和形式對(duì)本手冊(cè)內(nèi)容進(jìn)行復(fù)制或傳播。本手冊(cè)的內(nèi)容若有任何修改,恕不另行通知。 2011 中國(guó)大恒(集團(tuán)有限公司北京圖像視覺技術(shù)分公司版權(quán)所有銷售熱線:010-*轉(zhuǎn)8021支持熱線:010-*轉(zhuǎn)8006前言首先感謝您選用大恒圖像產(chǎn)品,數(shù)字?jǐn)z像機(jī)應(yīng)用接口庫(kù)是我公司提供的應(yīng)用程序接口函數(shù)。它基本上概括了數(shù)字?jǐn)z像機(jī)應(yīng)用程序編程中涉及的各個(gè)方面,通過(guò)應(yīng)用接口庫(kù),

2、用戶可以很好地了解數(shù)字?jǐn)z像機(jī)的運(yùn)行機(jī)制,并在此基礎(chǔ)上進(jìn)行應(yīng)用程序的開發(fā)。數(shù)字?jǐn)z像機(jī)應(yīng)用接口庫(kù)按照模塊分為應(yīng)用功能模塊和擴(kuò)充功能模塊。其中應(yīng)用功能模塊包括數(shù)字?jǐn)z像機(jī)的控制、采集圖像到內(nèi)存、錯(cuò)誤處理等功能,擴(kuò)充功能模塊包括圖像數(shù)據(jù)的轉(zhuǎn)換等功能。本手冊(cè)按功能對(duì)接口庫(kù)中的函數(shù)進(jìn)行了劃分,對(duì)于每一個(gè)功能部分的函數(shù)都具體給出了它們的函數(shù)原型、參數(shù)定義、說(shuō)明、示例等信息。手冊(cè)為用戶進(jìn)行數(shù)字?jǐn)z像機(jī)的二次開發(fā)提供了詳細(xì)的說(shuō)明,如果用戶在使用過(guò)程中發(fā)現(xiàn)錯(cuò)誤和紕漏,請(qǐng)與我公司的銷售或技術(shù)服務(wù)部門聯(lián)系,以便我們及時(shí)改進(jìn)。 目錄1.概述 (11.1功能 (11.2文件 (11.3開發(fā)工具 (21.4應(yīng)用程序的發(fā)布 (2

3、2.說(shuō)明 (32.1應(yīng)用功能 (31. HHV (32. HVTYPE (33. HV_RESOLUTION (54. HV_SNAP_MODE (65. HV_POLARITY (66. HV_SNAP_SPEED (77. HV_CHANNEL (78. HV_ADC_CONTROL (89. HV_ADC_LEVEL (810. HV_AEC_CONTROL (911. HV_SHUTTER_UNIT (912. HV_MIRROR_DIRECTION (1013. HV_COMMAND_CODE (1014. HV_DEVICE_INFO (1115. HV_CONTROL_CODE

4、(1216. HV_LAST_STATUS (1217. HV_SIGNAL_TYPE (1318. HV_EXPOSURE_MODE (1319. HV_NOISECORR_CONTROL (131. HV_SANP_INFO (142. HV_SNAPPROC (153. HV_CHECK_PARAM (154. HV API_CONTROL_PARAMETER (155. HV_RES_QUERY_LAST_STATUS_PRESENCE (166. HV_ARG_GET_LAST_STATUS (177. HV_RES_GET_LAST_STA TUS (178. HV_SIGNAL_

5、MODE (171. HV_SUCCESS (18 2. HV_VERIFY (181. 函數(shù):BeginHVDevice (192. 函數(shù):EndHVDevice (203. 函數(shù):HVSetResolution (204. 函數(shù):HVSetOutputWindow (215. 函數(shù):HVSetBlanking (226. 函數(shù):HVSetSnapMode (227. 函數(shù):HVSetTriggerPolarity (238. 函數(shù):HVSetStrobePolarity (239. 函數(shù):HVSetSnapSpeed (2310. 函數(shù):HVEnableVideoMirror (2411.

6、 函數(shù):HV ADCControl (2412. 函數(shù):HV AGCControl (2513. 函數(shù):HV AECControl (2614. 函數(shù):HVCommand (271. 函數(shù):HVSnapShot (302. 函數(shù):HVOpenSnap (313. 函數(shù):HVCloseSnap (324. 函數(shù):HVStartSnap (325. 函數(shù):HVStopSnap (336. 函數(shù):HVTriggerShot (337. 函數(shù):HVWaitSync (331. 函數(shù):HVGetErrorString (341. 函數(shù):HVGetDeviceTotal (342. 函數(shù):HVGetDev

7、iceInfo (343. 函數(shù):HVCheckDevice (364. 函數(shù):HVDeviceMemRead (375. 函數(shù):HVDeviceMemWrite (372.2擴(kuò)充功能 (381. HV_BAYER_CONVERT_TYPE (382. HV_BAYER_LAYOUT (401. 函數(shù):ConvertBayer2RGB (402. 函數(shù):GetWhiteBalanceRatio (413. 函數(shù):SetGammaLut (424. 函數(shù):DetectDeadPixel (42 目錄5. 函數(shù):EraseDeadPixel (436. 函數(shù):GetPatternNoise (44

8、7. 函數(shù):AvgPatternNoise (448. 函數(shù):FixPatternNoise (453.附錄 (463.1函數(shù)返回值代碼表 (464.備注 (1 1.概述在Microsoft 的32位Windows 操作系統(tǒng)中,數(shù)字?jǐn)z像機(jī)應(yīng)用接口庫(kù)直接操作數(shù)字?jǐn)z像機(jī),并提供給用戶一個(gè)簡(jiǎn)單明確的應(yīng)用接口。用戶在編制自己的應(yīng)用程序時(shí),可以直接調(diào)用這些庫(kù)函數(shù)來(lái)實(shí)現(xiàn)指定的功能。數(shù)字?jǐn)z像機(jī)工作流程如下: 一般情況下,攝像機(jī)的開始操作和初始化參數(shù)的設(shè)置,最好在用戶應(yīng)用程序的初始化中完成,攝像機(jī)的結(jié)束操作應(yīng)在應(yīng)用程序退出前執(zhí)行。1.1 功能應(yīng)用接口庫(kù)劃分為應(yīng)用功能模塊和擴(kuò)充功能模塊。1.2 文件包含文件HV

9、DAIlT.h動(dòng)態(tài)鏈接庫(kù)HVDAIlT.dll靜態(tài)鏈接庫(kù)HVDAIlT.lib包含文件Raw2RGB.h動(dòng)態(tài)鏈接庫(kù)Raw2RGB.dll靜態(tài)鏈接庫(kù)Raw2RGB.lib 1.3開發(fā)工具應(yīng)用接口庫(kù)支持32位編程開發(fā)工具M(jìn)icrosoft Visual C/C+、Microsoft Visual Basic、Borland C/C+、Delphi、C+ Builder、Power Builder等。使用C/C+編程工具,用戶應(yīng)在程序中調(diào)用相關(guān)的包含文件(.h,并將靜態(tài)鏈接庫(kù)(.lib文件加入到工程文件中,供編譯程序在鏈接(Link時(shí)使用。需要說(shuō)明的是,MS-Visual C/C+和C+ Build

10、er定義了各自的靜態(tài)鏈接庫(kù)的文件格式,它們之間是不通用的。使用MS-Visual Basic、Delphi、Power Builder等編程工具調(diào)用應(yīng)用接口庫(kù)時(shí),應(yīng)按照調(diào)用動(dòng)態(tài)鏈接庫(kù)的方法,在程序中重新聲明函數(shù)原型,這時(shí)要注意正確定義參數(shù)的數(shù)據(jù)類型。1.4應(yīng)用程序的發(fā)布發(fā)布數(shù)字?jǐn)z像機(jī)的應(yīng)用程序,首先,安裝攝像機(jī)的設(shè)備驅(qū)動(dòng)程序(安裝步驟可參見“安裝數(shù)字?jǐn)z像機(jī)設(shè)備驅(qū)動(dòng)程序”說(shuō)明,并確認(rèn)安裝成功;然后,將要發(fā)布的應(yīng)用程序安裝到相應(yīng)的工作目錄。這樣,應(yīng)用程序就可以運(yùn)行了。如果需要將驅(qū)動(dòng)程序與二次開發(fā)的應(yīng)用程序安裝盤一并發(fā)布,請(qǐng)將隨卡的驅(qū)動(dòng)程序光盤或軟盤中,相應(yīng)操作系統(tǒng)目錄下的驅(qū)動(dòng)程序拷貝到準(zhǔn)備發(fā)布的安

11、裝盤上即可。 2.說(shuō)明2.1應(yīng)用功能數(shù)字?jǐn)z像機(jī)應(yīng)用接口庫(kù)包括數(shù)字?jǐn)z像機(jī)的控制、采集圖像到內(nèi)存、錯(cuò)誤處理、其它功能等功能。函數(shù)的原型聲明在包含文件HVDAIlT.h,動(dòng)態(tài)鏈接庫(kù)HVDAIlT.dll,靜態(tài)鏈接庫(kù)HVDAIlT.lib。模塊中相關(guān)常量,數(shù)據(jù)結(jié)構(gòu),宏的說(shuō)明。1. HHVtypedef HANDLE HHV;HHV 標(biāo)識(shí)數(shù)字?jǐn)z像機(jī)設(shè)備句柄。數(shù)字?jǐn)z像機(jī)的控制,參數(shù)設(shè)置,圖像采集等,都需要使用設(shè)備句柄。2. HVTYPEtypedef enum tagHVTYPE HV1300UCTYPE = 0,HV2000UCTYPE = 1,HV1301UCTYPE = 2,HV2001UCTYPE

12、 = 3,HV3000UCTYPE = 4,HV1300UMTYPE = 5,HV1302UCTYPE = 6,HV2002UCTYPE = 7,HV3102UCTYPE = 8,HV1302UMTYPE = 9 HV1300FCTYPE = 10, HV2000FCTYPE = 11, HV3100FCTYPE = 12, HV1300FMTYPE = 13, HV1303UCTYPE = 14, HV2003UCTYPE = 15, HV3103UCTYPE = 16, HV1303UMTYPE = 17, SV1300FMTYPE = 18, SV1300FCTYPE = 19, SV1

13、310FCTYPE = 20, SV1310FMTYPE = 21, SV1311FCTYPE = 22, SV1311FMTYPE = 23, SV400FCTYPE = 24, SV400FMTYPE = 25, DH1394FXTYPE = 26, SV1410FCTYPE = 27, SV1410FMTYPE = 28, SV1420FCTYPE = 29, SV1420FMTYPE = 30, SV2000FCTYPE = 31, SV2000FMTYPE = 32, SV1400FCTYPE = 33, SV1400FMTYPE = 34, HV1350UCTYPE = 35, H

14、V2050UCTYPE = 36, HV3150UCTYPE = 37, HV1350UMTYPE = 38, HV1360UCTYPE = 39, HV2060UCTYPE = 40,HV3160UCTYPE = 41,HV1360UMTYPE = 42,HV2060UCTYPE = 40,HV3160UCTYPE = 41,HV1360UMTYPE = 42,HV1351UCTYPE = 56,HV2051UCTYPE = 57,HV3151UCTYPE = 58,HV1351UMTYPE = 59,GV400UCTYPE = 60,GV400UMTYPE = 61 HVTYPE;HVTY

15、PE 標(biāo)識(shí)當(dāng)前數(shù)字?jǐn)z像機(jī)的設(shè)備類型。不同類型的數(shù)字?jǐn)z像機(jī)有一些不同的硬件特性或參數(shù),用戶需要根據(jù)攝像機(jī)類型,完成相關(guān)的操作。3. HV_RESOLUTIONtypedef enum tagHV_RESOLUTION RES_MODE0 = 0,RES_MODE1 = 1,RES_MODE2 = 2,RES_MODE3 = 3 HV_RESOLUTION;HV_RESOLUTION 標(biāo)識(shí)圖像分辨率的類型。RES_MODE0分辨率0;RES_MODE1分辨率1;RES_MODE2 分辨率2;RES_MODE3分辨率3。4. HV_SNAP_MODEtypedef enum tagHV_SNAP_M

16、ODE CONTINUATION = 0,TRIGGER = 1,TRIGGER_EDGE = 2,TRIGGER_LEVEL = 3 HV_SNAP_MODE;HV_SNAP_MODE 標(biāo)識(shí)圖像采集模式。CONTINUATION連續(xù);TRIGGER外觸發(fā);TRIGGER_EDGE邊緣外觸發(fā),僅HV31xx系列攝像機(jī)支持;TRIGGER_LEVEL電平外觸發(fā),僅HV31xx系列攝像機(jī)支持。5. HV_POLARITYtypedef enum tag HV_POLARITY LOW = 0,HIGH = 1 HV_POLARITY;HV_POLARITY 標(biāo)識(shí)攝像機(jī)為外觸發(fā)采集模式時(shí),外觸發(fā)信號(hào)

17、的極性。LOW下降沿或低電平有效; HIGH上升沿或高電平有效。6. HV_SNAP_SPEEDtypedef enum tagHV_SNAP_SPEED NORMAL_SPEED = 0,HIGH_SPEED = 1 HV_SNAP_SPEED;HV_SNAP_SPEED 標(biāo)識(shí)圖像采集速度。NORMAL_SPEED正常速度采集;HIGH_SPEED高速采集。7. HV_CHANNELtypedef enum tagHV_CHANNEL RED_CHANNEL = 0x10,GREEN_CHANNEL1 = 0x11,GREEN_CHANNEL2 = 0x12,BLUE_CHANNEL = 0

18、x13 HV_CHANNEL;HV_CHANNEL 標(biāo)識(shí)攝像機(jī)的增益控制的顏色通道。RED_CHANNEL紅色通道;GREEN_CHANNEL1綠色通道1;GREEN_CHANNEL2綠色通道2;BLUE_CHANNEL 藍(lán)色通道。8. HV_ADC_CONTROLtypedef enum tagHV_ADC_CONTROLADC_BITS = 0ADC_BLKLEVEL_CAL = 1,ADC_BLKLEVEL_CAL_REDCHANNEL = 0x10,ADC_BLKLEVEL_CAL_GREENCHANNEL1 = 0x11,ADC_BLKLEVEL_CAL_GREENCHANNEL2

19、= 0x12,ADC_BLKLEVEL_CAL_BLUECHANNEL = 0x13, HV_ADC_CONTROL;HV_ADC_CONTROL 標(biāo)識(shí)攝像機(jī)的模擬/數(shù)字轉(zhuǎn)換控制方式。ADC_BITS模擬/數(shù)字轉(zhuǎn)換級(jí)別控制;ADC_BLKLEVEL_CAL黑電平參數(shù)調(diào)節(jié)允許;ADC_BLKLEVEL_CAL_REDCHANNEL紅色通道黑電平調(diào)節(jié);ADC_BLKLEVEL_CAL_GREENCHANNEL1綠色通道1黑電平調(diào)節(jié);ADC_BLKLEVEL_CAL_GREENCHANNEL2綠色通道2黑電平調(diào)節(jié);ADC_BLKLEVEL_CAL_BLUECHANNEL藍(lán)色通道黑電平調(diào)節(jié)。9. HV

20、_ADC_LEVELtypedef enum tagHV_ADC_LEVELADC_LEVEL0 = 0,ADC_LEVEL1 = 1, ADC_LEVEL2 = 2,ADC_LEVEL3 = 3 HV_ADC_LEVEL;HV_ADC_LEVEL 標(biāo)識(shí)模擬/數(shù)字轉(zhuǎn)換級(jí)別。ADC_LEVEL00級(jí),10位數(shù)據(jù)取低7位有效;ADC_LEVEL01級(jí),10位數(shù)據(jù)取低8位有效;ADC_LEVEL22級(jí),10位數(shù)據(jù)取中間8位有效;ADC_LEVEL33級(jí),10位數(shù)據(jù)取高8位有效。10. HV_AEC_CONTROLtypedef enum tagHV_AEC_CONTROLAEC_EXPOSURE_T

21、IME = 1,AEC_SHUTTER_SPEED = 2,AEC_SHUTTER_UNIT = 3 HV_AEC_CONTROL;HV_AEC_CONTROL 標(biāo)識(shí)攝像機(jī)曝光控制方式。AEC_EXPOSURE_TIME曝光系數(shù);AEC_SHUTTER_SPEED快門速度;AEC_SHUTTER_UNIT快門速度單位。11. HV_SHUTTER_UNITtypedef enum tagHV_SHUTTER_UNIT SHUTTER_US = 0,SHUTTER_MS = 1, HV_SHUTTER_UNIT;HV_SHUTTER_UNIT 標(biāo)識(shí)攝像機(jī)快門速度的單位。SHUTTER_US微秒;

22、SHUTTER_MS毫秒12. HV_MIRROR_DIRECTIONtypedef enum tag HV_MIRROR_DIRECTION VERT_DIR = 1,Hor_DIR = 2,Full_DIR = 3 HV_MIRROR_DIRECTION;HV_MIRROR_DIRECTION 標(biāo)識(shí)圖像采集的鏡像功能。VERT_DIR垂直方向。Hor_DIR水平方向。Full_DIR全方向。13. HV_COMMAND_CODEtypedef enum tagHV_COMMAND_CODE CMD_SET_STROBE_SIGNAL_MODE = 0x25,CMD_SET_EXPOSURE

23、_MODE = 0x26,CMD_SET_ROW_NOISECORR_CONTROL = 0x27,CMD_HVAPI_CONTROL = 0x100 HV_COMMAND_CODE;HV_COMMAND_CODE 標(biāo)識(shí)攝像機(jī)的控制功能。CMD_SET_STROBE_SIGNAL_MODE控制閃光燈信號(hào)模式的功能碼CMD_SET_EXPOSURE_MODE控制曝光模式的功能碼CMD_SET_ROW_NOISECORR_CONTROL控制行噪聲校正開關(guān)的功能碼CMD_HVAPI_CONTROL執(zhí)行HV_CONTROL_CODE定義的功能。14. HV_DEVICE_INFOtypedef enu

24、m tag HV_DEVICE_INFO DESC_DEVICE_TYPE = 0,DESC_RESOLUTION = 1,DESC_DEVICE_MARK = 2,DESC_DEVICE_SERIESNUM = 3,DESC_DEVICE_BLANKSIZE = 4,DESC_DEVICE_HARDWARE_VERSION = 6,DESC_DEVICE_BAYER_LAYOUT = 11 HV_DEVICE_INFO;HV_DEVICE_INFO 標(biāo)識(shí)攝像機(jī)的信息。DESC_DEVICE_TYPE攝像機(jī)的設(shè)備類型;DESC_RESOLUTION攝像機(jī)的分辨率;DESC_DEVICE_MAR

25、K攝像機(jī)類型的標(biāo)志;DESC_DEVICE_SERIESNUM 攝像機(jī)的序列號(hào);DESC_DEVICE_BLANKSIZE消隱的取值范圍;DESC_DEVICE_HARDWARE_VERSION攝像機(jī)的設(shè)備(硬件版本號(hào)。DESC_DEVICE_BAYER_LAYOUT攝像機(jī)圖像Bayer格式15. HV_CONTROL_CODEtypedef enum tagHV_CONTROL_CODE ORD_QUERY_LAST_STATUS_PRESENCE = 0x0000000C,ORD_GET_LAST_STATUS = 0x0000000E HV_CONTROL_CODE;HV_CONTROL

26、_CODE,列舉函數(shù)HVCommand的命令控制碼CMD_HVAPI_ CONTROL執(zhí)行的功能。ORD_QUERY_LAST_STATUS_PRESENCE用于查詢是否支持,獲取攝像機(jī)的工作狀態(tài);ORD_GET_LAST_STATUS用于獲取攝像機(jī)的工作狀態(tài)。16. HV_LAST_STATUStypedef enum tagHV_LAST_STATUS HV_LAST_STATUS_ERROR_CONTROL = 0,HV_LAST_STATUS_SNAP = 1,HV_LAST_STATUS_TRANSFER = 2 HV_LAST_STATUS;HV_LAST_STATUS列舉攝像機(jī)工

27、作狀態(tài)類型。HV_LAST_STATUS_ERROR_CONTROL攝像機(jī)控制操作錯(cuò)誤碼,調(diào)用控制函數(shù)返回錯(cuò)誤值時(shí),使用ORD_GET_LAST_STATUS獲取的詳細(xì)錯(cuò)誤信息;HV_LAST_STATUS_SNAP 攝像機(jī)采集圖像操作狀態(tài)碼,實(shí)時(shí)采集圖像時(shí),查詢攝像機(jī)采集狀態(tài);HV_LAST_STATUS_TRANSFER攝像機(jī)采集圖像操作狀態(tài)碼,實(shí)時(shí)采集圖像時(shí),在用戶定義的回調(diào)函數(shù)中使用,查詢攝像機(jī)采集狀態(tài)。17. HV_SIGNAL_TYPEtypedef enum tagHV_SIGNAL_TYPESIGNAL_IMPULSE = 0,SIGNAL_LEVEL = 1HV_SIGNAL

28、_TYPE;HV_SIGNAL_TYPE列舉攝像機(jī)閃光燈信號(hào)的模式。SIGNAL_IMPULSE脈沖信號(hào)SIGNAL_LEVEL電平信號(hào)18. HV_EXPOSURE_MODEtypedef enum tagHV_EXPOSURE_MODESEQUENCE = 0,SIMULTANEITY = 1 HV_EXPOSURE_MODE;HV_ EXPOSURE_MODE列舉攝像機(jī)的曝光模式。SEQUENCE順序模式SIMULTANEITY同時(shí)模式19. HV_NOISECORR_CONTROLtypedef enum tagHV_NOISECORR_CONTROL NOISECORR_ENABLE

29、 = 0,NOISECORR_DISABLE = 1 HV_NOISECORR_CONTROL;HV_NOISECORR_CONTROL列舉攝像機(jī)的噪聲校正控制開關(guān)。NOISECORR_ENABLE噪聲校正控制開啟NOISECORR_DISABLE噪聲校正控制關(guān)閉1. HV_SANP_INFOtypedef struct tagHV_SANP_INFO HHV hhv;int nDevice;int nIndex;void *pParam; HV_SNAP_INFO;HV_SNAP_INFO 結(jié)構(gòu)包含執(zhí)行采集圖像到內(nèi)存的操作中,攝像機(jī)的工作狀態(tài)。在連續(xù)采集圖像到內(nèi)存的過(guò)程中,標(biāo)示當(dāng)前工作的攝像

30、機(jī)設(shè)備,圖像數(shù)據(jù)緩沖區(qū)的序號(hào)和用戶定義的參數(shù)。成員hhv標(biāo)示當(dāng)前工作的攝像機(jī)的句柄。nDevice標(biāo)示當(dāng)前工作的攝像機(jī)的序號(hào)(從1開始。nIndex標(biāo)示當(dāng)前攝像機(jī)采集的圖像數(shù)據(jù)緩沖區(qū)的序號(hào)(從0開始。pParam指向用戶定義的參數(shù)。 2. HV_SNAPPROCtypedef int (CALLBACK *HV_SNAPPROC(HV_SNAP_INFO *pInfo;HV_SNAPPROC標(biāo)示回調(diào)函數(shù)的聲明。在采集圖像到內(nèi)存控制程序中,用戶定義回調(diào)函數(shù),在函數(shù)體中編寫自己的程序,如,圖像數(shù)據(jù)的處理等。使用函數(shù)HVOpenSnap注冊(cè)回調(diào)函數(shù),由攝像機(jī)采集控制程序調(diào)用。3. HV_CHECK_

31、PARAMtypedef struct tagHV_CHECK_PARAM BYTE byParam1;BYTE byParam2;BYTE byParam3;BYTE byParam4; HV_CHECK_PARAM;HV_CHECK_PARAM 結(jié)構(gòu)包含給定的攝像機(jī)查驗(yàn)參數(shù)。成員byParam1參數(shù)1。byParam2參數(shù)2。byParam3參數(shù)3。byParam4參數(shù)4。4. HV API_CONTROL_PARAMETERtypedef struct tagHVAPI_CONTROL_PARAMETER HV_CONTROL_CODE code;void *pInBuf;DWORD d

32、wInBufSize;void *pOutBuf; DWORD dwOutBufSize;DWORD *pBytesRet; HVAPI_CONTROL_PARAMETER;HVAPI_CONTROL_PARAMETER結(jié)構(gòu)用于CMD_HVAPI_CONTROL 功能的輸入輸出參數(shù)。成員code功能碼,參見HV_CONTROL_CODE,其它成員pInBuf,dwInBufSize,pOutBuf,dwOutBufSize和pBytesRet描述code的參數(shù),每個(gè)功能都有各自對(duì)應(yīng)的輸入輸出參數(shù);pInBuf指向輸入緩沖區(qū),如果code指明的操作不需要輸入?yún)?shù),pInBuf設(shè)置為NULL;dw

33、InBufSize輸入緩沖區(qū)大小,單位:字節(jié),如果code指明的操作不需要輸入?yún)?shù),dwInBufSize設(shè)置為0;pOutBuf指向輸出緩沖區(qū),如果code指明的操作不需要輸出參數(shù),pOutBuf設(shè)置為NULL;dwOutBufSize輸出緩沖區(qū)大小,單位:字節(jié),如果code指明的操作不需要輸入?yún)?shù),dwOutBufSize設(shè)置為0;pBytesRet指向一個(gè)DWORD變量,接收pOutBuf中實(shí)際輸出的數(shù)據(jù)大小,單位:字節(jié),如果輸出緩沖區(qū)太小,HVCommand函數(shù)返回STATUS_NOT_ENOUGH_SYSTEM_MEMORY,并且pBytesRet為0。5. HV_RES_QUERY

34、_LAST_STATUS_PRESENCEtypedef struct tagHV_RES_QUERY_LAST_STATUS_PRESENCE DWORD : 29;DWORD Transfer : 1;DWORD Snap : 1;DWORD Control : 1; HV_RES_QUERY_LAST_STATUS_PRESENCE;HV_RES_QUERY_LAST_STATUS_PRESENCE結(jié)構(gòu)用于ORD_QUERY_LAST_STATUS_PRESENCE的輸出參數(shù),描述是否支持,獲取攝像機(jī)的工作狀態(tài)。成員Transfer 標(biāo)示是否支持,在用戶定義的回調(diào)函數(shù)中獲取攝像機(jī)采集圖像

35、操作狀態(tài)碼;Snap標(biāo)示是否支持,獲取攝像機(jī)采集圖像操作狀態(tài)碼;Control標(biāo)示是否支持,獲取攝像機(jī)控制操作錯(cuò)誤碼。6. HV_ARG_GET_LAST_STATUStypedef struct tagHV_ARG_GET_LAST_STATUS HV_LAST_STATUS type; HV_ARG_GET_LAST_STATUS;HV_ARG_GET_LAST_STATUS結(jié)構(gòu)用于ORD_GET_LAST_STATUS的輸入?yún)?shù),描述要獲取的攝像機(jī)工作狀態(tài)類型。成員type攝像機(jī)工作狀態(tài)類型,參見HV_LAST_STATUS。7. HV_RES_GET_LAST_STATUStypede

36、f struct tagHV_RES_GET_LAST_STATUS DWORD status; HV_RES_GET_LAST_STATUS;HV_RES_GET_LAST_STATUS結(jié)構(gòu)用于ORD_GET_LAST_STATUS的輸出參數(shù),描述攝像機(jī)工作狀態(tài)。成員status標(biāo)識(shí)攝像機(jī)工作狀態(tài)碼或錯(cuò)誤碼。8. HV_SIGNAL_MODEtypedef struct tagHV_SIGNAL_MODEint Polarity; /0:LOW ;1: HIGHint Mode; /0:SIGNAL_IMPULSE; 1: SIGNAL_LEVELHV_SIGNAL_MODE;HV_SIGN

37、AL_MODE結(jié)構(gòu)用于設(shè)置攝像機(jī)閃光燈信號(hào)的模式和極性。 成員Polarity標(biāo)識(shí)攝像機(jī)閃光燈信號(hào)的極性。Mode標(biāo)示攝像機(jī)閃光燈信號(hào)的模式。1. HV_SUCCESSBOOL HV_SUCCESS(statusHV_SUCCESS宏檢查函數(shù)執(zhí)行的返回狀態(tài)。參數(shù):HVSTATUS status;函數(shù)執(zhí)行的返回狀態(tài)。返回值:標(biāo)識(shí)函數(shù)執(zhí)行結(jié)果,成功為TRUE;失敗為FALSE。注釋:HV_SUCCESS在HVDef.h中的定義如下,#define HV_SUCCESS(status(status= STATUS_OK 2. HV_VERIFYHV_VERIFY(statusHV_VERIFY宏校驗(yàn)

38、函數(shù)執(zhí)行是否成功。HV_VERIFY宏只在調(diào)試(DEBUG版的執(zhí)行程序中運(yùn)行,函數(shù)執(zhí)行成功,不顯示信息;函數(shù)執(zhí)行不成功,則彈出對(duì)話框,顯示錯(cuò)誤信息。在發(fā)布(RELEASE版的執(zhí)行程序中不運(yùn)行,也不產(chǎn)生任何代碼。參數(shù):HVSTATUS status;函數(shù)執(zhí)行的返回狀態(tài)。注釋:HV_VERIFY在HVDef.h中的定義如下,#ifdef _DEBUG#define HV_VERIFY(statusif(status!= STATUS_OK :MessageBox(NULL,HVGetErrorString(status, Error,MB_ICONWARNING | MB_OK;#else#def

39、ine HV_VERIFY(status(status#endif數(shù)字?jǐn)z像機(jī)的開始(初始化、結(jié)束,設(shè)置分辨率、圖像窗口、采集模式等。1. 函數(shù):BeginHVDevice原型:HVSTATUS _stdcall BeginHVDevice(int nDevice,HHV *pHandle參數(shù):int nDevice;攝像機(jī)序號(hào),由1開始。HHV *pHandle;指向攝像機(jī)設(shè)備句柄。返回值:調(diào)用成功,返回STA TUS_OK,否則返回錯(cuò)誤代碼。說(shuō)明:開始指定攝像機(jī)操作,初始化攝像機(jī),獲得其設(shè)備句柄,分配相應(yīng)的資源。輸入?yún)?shù)nDevice是攝像機(jī)的邏輯序號(hào),按照大恒數(shù)字?jǐn)z像機(jī)序列,如HV1300

40、UC、HV2000UC HVxxx等,由低到高排列確定,同一型號(hào)設(shè)備按所連接USB接口序號(hào)排列。例如:用戶系統(tǒng)中有3支HV1300UC,按USB接口序號(hào),則攝像機(jī)的序號(hào)分別為1、2、3。如果nDevice的值超過(guò)當(dāng)前系統(tǒng)實(shí)際的攝像機(jī)數(shù),則返回STATUS_NO_DEVICE_FOUND。調(diào)用函數(shù)HVGetDeviceInfo可以確定當(dāng)前攝像機(jī)類型。攝像機(jī)使用完畢,調(diào)用函數(shù)EndHVDevice結(jié)束。范例:如果系統(tǒng)中安裝了兩支或兩支以上的攝像機(jī),則可以按下面調(diào)用得到每支攝像機(jī)的設(shè)備句柄。BeginHVDevice(1,&hDevice1;/打開攝像機(jī)1BeginHVDevice(2,&hDevi

41、ce2;/打開攝像機(jī)2 /類推 參看:EndHVDevice,HVGetDeviceInfo。2. 函數(shù):EndHVDevice原型:HVSTATUS _stdcall EndHVDevice(HHV hhv參數(shù):HHV hhv;攝像機(jī)句柄。返回值:調(diào)用成功,返回STA TUS_OK,否則返回錯(cuò)誤代碼。說(shuō)明:結(jié)束指定攝像機(jī)操作,釋放其設(shè)備句柄和資源。調(diào)用函數(shù)前,必須停止攝像機(jī)工作,如果攝像機(jī)正在采集圖像時(shí)調(diào)用函數(shù),則返回STA TUS_IN_WORK。范例:EndHVDevice(hDevice1; /關(guān)閉攝像機(jī)1EndHVDevice(hDevice2;/關(guān)閉攝像機(jī)2參看:BeginHVDe

42、vice。3. 函數(shù):HVSetResolution原型:HVSTATUS _stdcall HVSetResolution(HHV hhv, HV_RESOLUTION resoultion;參數(shù):HHV hhv;攝像機(jī)句柄。HV_RESOLUTION resolution;圖像分辨率。返回值:調(diào)用成功,返回STA TUS_OK,否則返回錯(cuò)誤代碼。說(shuō)明:設(shè)置攝像機(jī)的分辨率,HV13xxUx系列攝像機(jī)的分辨率:RES_MODE0 12801024,RES_MODE1 640512,RES_MODE2 320256。HV20xxUx系列攝像機(jī)的分辨率:RES_MODE0 16001200,RES

43、_MODE1 800600,RES_MODE2400300。HV31xxUx系列攝像機(jī)的分辨率:RES_MODE0 20481536,RES_MODE1 1024768,RES_MODE2640480,RES_MODE3 512384。GV400Ux攝像機(jī)的分辨率:RES_MODE0 752480,RES_MODE1 376240。其中GV400UC在 RES_MODE1模式下圖像為黑白圖像。有關(guān)攝像機(jī)分辨率的信息,參見函數(shù)HVGetDeviceInfo。范例:HVSetResolution(hDevice1,RES_MODE1;參看:HVSetOutputWindow。4. 函數(shù):HVSet

44、OutputWindow原型:HVSTATUS _stdcall HVSetOutputWindow(HHV hhv,int nStartX,int nStartY,int nWidth,int nHeight參數(shù):HHV hhv;攝像機(jī)句柄。int nStartX;輸出窗口左上角x坐標(biāo),數(shù)值應(yīng)為4的倍數(shù)。int nStartY;輸出窗口左上角y坐標(biāo),數(shù)值應(yīng)為2的倍數(shù)。int nWidth;輸出窗口寬度,數(shù)值應(yīng)為4的倍數(shù)。int nHeight;輸出窗口高度,數(shù)值應(yīng)為2的倍數(shù)。返回值:調(diào)用成功,返回STA TUS_OK,否則返回錯(cuò)誤代碼。說(shuō)明:設(shè)置圖像輸出(Output窗口,輸出窗口是指圖像數(shù)

45、據(jù)從攝像機(jī)輸出時(shí)的起始位置和大小。輸出窗口大小只能等于或小于當(dāng)前分辨率的大小。需要特別說(shuō)明的是攝像機(jī)GV400Ux,在調(diào)節(jié)窗口時(shí),需要滿足條件:nWidth *rate + Horizontal Blanking + 0x5e 0x294rate取值:分辨率Mode0:rate=1;Mode1:rate=2范例:HVSetOutputWindow(hDevice1,0,0,640,512;參看:HVSetResolution。 5. 函數(shù):HVSetBlanking原型:HVSTATUS _stdcall HVSetBlanking(HHV hhv, int nHor, int nVert;參

46、數(shù):HHV hhv;攝像機(jī)句柄。int nHor;行消隱值。int nVert;場(chǎng)消隱值。返回值:調(diào)用成功,返回STA TUS_OK,否則返回錯(cuò)誤代碼。說(shuō)明:設(shè)置攝像機(jī)的消隱值,消隱的取值范圍通過(guò)函數(shù)HVGetDeviceInfo得到,請(qǐng)參考HVGetDeviceInfo 函數(shù)說(shuō)明。GV400Ux攝像機(jī)的行消隱與水平寬度需要滿足一定的條件,詳見HVSetResolution函數(shù)說(shuō)明。范例:HVSetBlanking(hDevice1,20,0;6. 函數(shù):HVSetSnapMode原型:HVSTATUS _stdcall HVSetSnapMode(HHV hhv, HV_SNAP_MODE

47、mode;參數(shù):HHV hhv;攝像機(jī)句柄。HV_SNAP_MODE mode;圖像采集模式:CONTINUATION 連續(xù)方式;TRIGGER 外觸發(fā)方式;TRIGGER_EDGE 邊緣外觸發(fā);TRIGGER_LEVEL 電平外觸發(fā)。返回值:調(diào)用成功,返回STA TUS_OK,否則返回錯(cuò)誤代碼。說(shuō)明:設(shè)置圖像的采集方式。范例:HVSetSnapMode(hDevice1, CONTINUATION;僅HV31xxUx攝像機(jī)支持TRIGGER_EDGE和TRIGGER_LEVEL兩種模式。 7. 函數(shù):HVSetTriggerPolarity原型:HVSTATUS _stdcall HVSet

48、TriggerPolarity(HHV hhv, HV_POLARITY polarity;參數(shù):HHV hhv;攝像機(jī)句柄。HV_POLARITY polarity;外觸發(fā)信號(hào)的極性:LOW 下降沿或低電平有效;HIGH 上升沿或高電平有效。返回值:調(diào)用成功,返回STA TUS_OK,否則返回錯(cuò)誤代碼。說(shuō)明:當(dāng)攝像機(jī)為外觸發(fā)模式采集圖像時(shí),設(shè)置外觸發(fā)信號(hào)的極性。范例:HVSetTriggerPolarity(hDevice1, LOW;8. 函數(shù):HVSetStrobePolarity原型:HVSTATUS _stdcall HVSetStrobePolarity(HHV hhv, HV_P

49、OLARITY polarity;參數(shù):HHV hhv;攝像機(jī)句柄。HV_POLARITY polarity;閃光燈信號(hào)的極性:LOW 下降沿或低電平有效;HIGH 上升沿或高電平有效。返回值:調(diào)用成功,返回STA TUS_OK,否則返回錯(cuò)誤代碼。說(shuō)明:設(shè)置攝像機(jī)輸出的閃光燈信號(hào)的極性。范例:HVSetStrobePolarity(hDevice1, LOW;9. 函數(shù):HVSetSnapSpeed原型:HVSTATUS _stdcall HVSetSnapSpeed (HHV hhv, HV_SNAP_SPEED speed;參數(shù):HHV hhv;攝像機(jī)句柄。 HV_SNAP_SPEED s

50、peed;圖像采集速度:NORMAL_SPEED正常速度;HIGH_SPEED高速。返回值:調(diào)用成功,返回STA TUS_OK,否則返回錯(cuò)誤代碼。說(shuō)明:設(shè)置圖像的采集速度,例如HV1301UC,HV1302UC,HV1300UM,HV1302UM分辨率為12801024時(shí),高速采集為15fps,正常速度采集時(shí)為7.5fps;HV2001UC,HV2002UC分辨率為16001200時(shí),高速采集為10fps,正常速度采集時(shí)為5fps;HV3000UC,HV3102UC分辨率為20481536時(shí),高速采集為6fps,正常速度采集時(shí)為3fps。范例:HVSetSnapMode(hDevice1, N

51、ORMAL_SPEED;10. 函數(shù):HVEnableVideoMirror原型:HVSTATUS _stdcall HVEnableVideoMirror(HHV hhv,HV_MIRROR_DIRECTION dir,BOOL bEnable參數(shù):HHV hhv;攝像機(jī)句柄。HV_MIRROR_DIRECTION dir;圖像采集的鏡像方向。BOOL bEnable;TRUE 允許,FALSE 禁止。返回值:調(diào)用成功,返回STA TUS_OK,否則返回錯(cuò)誤代碼。說(shuō)明:設(shè)置采集圖像的垂直方向鏡像功能。只有GV400Ux攝像機(jī)同時(shí)支持垂直、水平和完全鏡像,其他攝像機(jī)都只支持垂直鏡像。11. 函

52、數(shù):HV ADCControl原型:HVSTATUS _stdcall HVADCControl(HHV hhv, BYTE byParam, long lValue;參數(shù):HHV hhv;攝像機(jī)句柄。BYTE byParam;控制參數(shù), ADC_BITS 模擬/數(shù)字轉(zhuǎn)換級(jí)別;ADC_BLKLEVEL_CAL 黑電平參數(shù)調(diào)節(jié)允許;ADC_BLKLEVEL_CAL_REDCHANNEL 紅色通道黑電平調(diào)節(jié);ADC_BLKLEVEL_CAL_GREENCHANNEL1綠色通道1黑電平調(diào)節(jié);ADC_BLKLEVEL_CAL_GREENCHANNEL2綠色通道2黑電平調(diào)節(jié);ADC_BLKLEVEL_C

53、AL_BLUECHANNEL藍(lán)色通道黑電平調(diào)節(jié);long lValue;參數(shù)值,設(shè)置模擬數(shù)字轉(zhuǎn)換級(jí)別,取值,ADC_LEVEL0;ADC_LEVEL1;ADC_LEVEL2;ADC_LEVEL3。設(shè)置黑電平參數(shù)調(diào)節(jié)允許,取值,TRUE 允許;FALSE 禁止。設(shè)置黑電平參數(shù),取值,-255 到255。注:GV400Ux攝像機(jī)黑電平參數(shù),取值:-127到127。返回值:調(diào)用成功,返回STA TUS_OK,否則返回錯(cuò)誤代碼。說(shuō)明:攝像機(jī)的模擬/數(shù)字轉(zhuǎn)換控制。12. 函數(shù):HV AGCControl原型:HVSTATUS _stdcall HVAGCControl(HHV hhv, BYTE byP

54、aram, long lValue;參數(shù):HHV hhv;攝像機(jī)句柄。BYTE byParam;控制參數(shù),AGC_GAIN_RED_CHANNEL 紅通道增益調(diào)節(jié);AGC_GAIN_GREEN_CHANNEL1 綠通道1增益調(diào)節(jié);AGC_GAIN_GREEN_CHANNEL2 綠通道2增益調(diào)節(jié); AGC_GAIN_BLUE_CHANNEL 藍(lán)通道增益調(diào)節(jié);long lValue;增益大小,HV-50系列和HV-51系列攝像機(jī)增益0-63。其他HV系列攝像機(jī)分通道的增益調(diào)節(jié)取值,0-127。GV400Ux攝像機(jī)增益調(diào)節(jié)為:16-64。返回值:調(diào)用成功,返回STA TUS_OK,否則返回錯(cuò)誤代碼。說(shuō)明:攝像機(jī)的自動(dòng)增益控制。13. 函數(shù):HV AECControl原型:HVSTATUS _stdcall HVAECControl(HHV hhv, BYTE byParam, long lValue;參數(shù):HHV hhv;攝像機(jī)句柄。BYTE byParam;控制參數(shù),AEC_EXPOSURE_TIME 曝光系數(shù);AEC_SHUTTER_SPEED 快門速度;AE