OK系列攝像頭軟件編程說明書

1、OK 系列攝像頭軟件編程說明書 OK Series Camera Software Programming Manual二零一零年三月版北京嘉恒中自圖像技術(shù)有限公司 Beijing JoinHope Image Technology Ltd.Tel:一號通 , 62568368Fax:Web: Email: info目 錄緒 言第一章 攝像頭的軟件控制. 1一、接口參數(shù)結(jié)構(gòu)的定義說明 .11、設(shè)置參數(shù)的結(jié)構(gòu)定義 .12、參數(shù)項目名稱宏定義 .53、錯誤代碼宏定義 .84、產(chǎn)品類型碼宏定義 .85、參數(shù)結(jié)構(gòu)體標示宏定義 .10 二、DLL

2、動態(tài)庫接口函數(shù) . 111、常用函數(shù) . 112、攝像頭參數(shù)的計算函數(shù) .333、攝像頭 Gamma 值的設(shè)置 .384、USB 攝像頭相關(guān)函數(shù) .415、線陣攝像頭相關(guān)函數(shù) .446、千兆攝像頭相關(guān)函數(shù) .45 三、設(shè)置參數(shù)說明 .501、 CCD 總增益(CONFIG_CCDGAIN .502、工作模式(CONFIG_WORKMODE .503、 Gamma 模式(CONFIG_GAMMAMODE .514、幅度模式 (CONFIG_FRAMEMODE.515、輸出模式(CONFIG_TESTMODE .526、黑電平(CONFIG_REFBLACK .527、局部起始行 (CONFIG_

3、PARTBEGIN.528、局部結(jié)束行 (CONFIG_PARTBEGIN.539、曝光行數(shù) (CONFIG_EXPOSE.5410、 R 通道增益(CONFIG_RGAIN .54 11、 G 通道增益(CONFIG_GGAIN .55 12、 B 通道增益(CONFIG_BGAIN .55 13、色彩飽和度(CONFIG_ COLORSATURATION .56 14、幀頻索引(CONFIG_FRAMERATE .56 15、 GAMMA 數(shù)據(jù)(CONFIG_GAMMA .57 16、消隱圓半徑(CONFIG_CIRLRADIUS .57 17、消隱圓中心橫坐標(CONFIG_CIRLCO

4、REHS .58 18、消隱圓中心縱坐標(CONFIG_CIRLCOREVS .58 19、 USB 攝像頭曝光時間 (CONFIG_EXPOSETIME.58 20、 USB 攝像頭亮度 (CONFIG_BRIGHTNESS .58 21、 USB 攝像頭紅色通道亮度 (CONFIG_REDBRIGHTNESS .58 22、 USB 攝像頭綠色通道亮度(CONFIG_GREENBRIGHTNESS.58 23、 USB攝像頭藍色通道亮度 (CONFIG_BLUEBRIGHTNESS .59 24、 USB 攝像頭二級 CCD 增益 (CONFIG_ALLCONTRAST .59 25、 U

5、SB 攝像頭對比度(CONFIG_CONTRAST .59 26、 USB 攝像頭紅色通道對比度 (CONFIG_REDCONTRAST .59 27、 USB 攝像頭綠色通道對比度(CONFIG_GREENCONTRAST .59 28、 USB 攝像頭藍色通道對比度(CONFIG_BLUECONTRAST.59 29、遞歸參數(shù)(CONFIG_RECURSION .60 30、負像參數(shù) (CONFIG_VIDEOMODE.6031、水平反轉(zhuǎn) (CONFIG_INVERSE_HOR.60 32、垂直反轉(zhuǎn) (CONFIG_INVERSE_VER.60 33、所有參數(shù)(CONFIG_ALLPARA

6、M_LINEAR .60 34、缺省參數(shù)(CONFIG_INITPARAM_LINEAR .60 35、工作模式(CONFIG_WORKMODE_LINEAR .61 36、 Cameralink 輸出模式(CONFIG_OUTPUTMODE_LINEAR .61 37、 AOI 起始像素(CONFIG_AOIBEGIN_LINEAR .61 38、 AOI 像素長度(CONFIG_AOIBEGIN_LINEAR .62 39、 Time1曝光時間(CONFIG_TIME1EXPOSE_LINEAR 62 40、 Time2曝光時間(CONFIG_TIME2EXPOSE_LINEAR 63 4

7、1、測試圖模式(CONFIG_TESTMODE_LINEAR .63 42、校正起始行(CONFIG_REGULATEBEGIN_LINEAR .63 43、位置校正行數(shù)(CONFIG_REGULATELINE_LINEAR 63 44、數(shù)據(jù)移位(CONFIG_DATAOFFSET_LINEAR .64 45、紅色增益(CONFIG_REDGAIN_LINEAR .64 46、綠色增益(CONFIG_GREENGAIN_LINEAR .64 47、藍色增益(CONFIG_BLUEGAIN_LINEAR .64 48、紅色偏置(CONFIG_REDOFFSET_LINEAR .64 49、綠色偏

8、置(CONFIG_GREENOFFSET_LINEAR .64 50、藍色偏置(CONFIG_BLUEOFFSET_LINEAR .65 51、顏色增益等級(CONFIG_GAINLEVEL_LINEAR .65 52、組編號(CONFIG_GROUPID_LINEAR .65 53、組內(nèi)編號(CONFIG_MEMBERID_LINEAR .65 54、增益(CONFIG_GAIN_INEAR .65 55、偏置(CONFIG_OFFSET_LINEAR .65 56、短曝光參數(shù)(CONFIG_SHORT_EXPOSE .66 57、 外觸發(fā)上升沿濾波延時 (CONFIG_TRIG_DELAY

9、_REDGE.66 58、 外觸發(fā)下降沿濾波延時 (CONFIG_TRIG_DELAY_DEDGE .66 59、外觸發(fā)結(jié)束屏蔽(CONFIG_TRIG_END_SHILD .66 60、設(shè)置特殊功能全部參數(shù)(CONFIG_ALLPARAM_EX .66 61、設(shè)置特殊功能全部參數(shù)(CONFIG_INITPARAM_EX .66 62、設(shè)置外觸發(fā)長曝光(CONFIG_TRIG_LONGEXPOSE .67 四、產(chǎn)品型號與對應(yīng)的常量 .67 1、 AM1100AM1101AM1105AM1120AM1121AM1130AM1131.672、 AM1300AM1320AM1330.723、 AM1

10、400AM1420AM1430.734、 AM1500AM1520AM153.755、 AC1200(211200.776、 AC1300.77 五、 DLL 動態(tài)庫函數(shù)索引 .78第二章 攝像頭開發(fā) RS232串口通訊協(xié)議. 82一、模式選擇 .82二、參數(shù)調(diào)節(jié) .83(一增益調(diào)節(jié) .83(二黑電平調(diào)節(jié) .84(三色彩調(diào)節(jié):RGB 彩色攝像頭有效 .84(四消隱圓設(shè)置:帶有消隱圓功能的攝像頭此命令有效 .84(五局部起始行和結(jié)束行設(shè)置:在局部模式下有效 .85(六曝光時間調(diào)節(jié) .86(七調(diào)整攝像頭的幀頻 .86(八調(diào)設(shè)置遞歸參數(shù) .91緒 言隨著圖象技術(shù)應(yīng)用的不斷推廣和提高,市場對視頻產(chǎn)品有

11、了更高的 要求, 攝像頭就是其中的主要產(chǎn)品, 原有的標準 PAL 或 NTSC 制隔行攝 像頭,這些原本僅滿足于廣播電視的“觀看”性產(chǎn)品,已越來越不能適 應(yīng)各個圖象技術(shù)應(yīng)用領(lǐng)域的需求。在這些需要圖像采集和處理的領(lǐng)域, 特別是在對速度、 精度有較高要求的機器視覺系統(tǒng)、 醫(yī)學(xué)圖像處理系統(tǒng)、 交通監(jiān)控系統(tǒng)等等應(yīng)用領(lǐng)域,攝像頭應(yīng)能滿足以下要求:z逐行(progressive掃描,而不是隔行掃描;z高分辨率,應(yīng)能達到 1K×1K的百萬級像元以上;z彩色攝像頭應(yīng)為 RGB 分量而不是復(fù)合視頻或 YUU 分量輸出; z具有隨機外觸發(fā)掃描和可控電子快門;z攝像頭的工作狀態(tài)和參數(shù)通過計算機軟件可調(diào);z

12、高灰度分辨率。北京嘉恒中自圖像技術(shù)有限公司是開發(fā)、生產(chǎn)、銷售圖像采集和處理產(chǎn)品 的專業(yè)公司,從事圖像采集卡的開發(fā)已歷經(jīng)二十多年,積累了豐富的經(jīng)驗。 為了滿足圖象技術(shù)應(yīng)用需求的不斷提高,公司集中了有生力量開發(fā)適用于 圖像處理的OK系列機器視覺專業(yè)攝像頭產(chǎn)品,產(chǎn)品包括:各種分辨率的黑/白和 彩色模擬攝像頭; CameraLink、LVDS數(shù)字輸出攝像頭;便攜式USB數(shù)字接口的 CCD和CMOS攝像頭等等。更新的產(chǎn)品,用戶可從上隨時了解或致 電公司銷售部進行咨詢。第一章 攝像頭的軟件控制 第一章 攝像頭的軟件控制一、接口參數(shù)結(jié)構(gòu)的定義說明1、設(shè)置參數(shù)的結(jié)構(gòu)定義1、模擬攝像頭參數(shù)結(jié)構(gòu)體定義struct

13、 Config_Valuelong size; /結(jié)構(gòu)大小 此標記為結(jié)構(gòu)大小,要求必須設(shè)置 long ident_code; /結(jié)構(gòu)體標示,此標記用于判定參數(shù)結(jié)構(gòu)體的合法 性。 在初始化參數(shù)結(jié)構(gòu)體時, 必須設(shè)置參數(shù) (參見本節(jié) 1.5 long type_code; /產(chǎn)品型號long ver_code; /硬件版本號long constant_swinterval; /swarp間隔long constant_totallength;/總行數(shù)long ccd_gain; /ccd總增益,范圍:01023long ref_black; /黑電平,范圍:0255long work_mode; /

14、工作模式long gamma_mode; /gamma校正模式long frame_mode; /幅度模式long test_mode; /測試模式long part_begin; /局部起始行,在局部模式下有效long part_end; /局部結(jié)束行,在局部模式下有效, long expose_line; /曝光行數(shù)long r_gain; /r通道增益,對彩色攝像頭有效1long g_gain; /g通道增益,對彩色攝像頭有效long b_gain; /b通道增益,對彩色攝像頭有效long color_saturation; /色彩飽和度,對彩色攝像頭有效long frame_rate;

15、 /幀頻索引號long b_level; /保留long clock_value; /時鐘相關(guān)long cirl_radius; /消隱圓半徑,對 LVDS 攝像頭有效long cirl_corehs; /消隱圓中心橫坐標,對 LVDS 攝像頭有效 long cirl_corevs; /消隱圓中心縱坐標,對 LVDS 攝像頭有效 long Expose_time; /USB攝像頭曝光時間long Red_Brightness; /R通道亮度,對 USB 攝像頭有效long Green_Brightness; /G通道亮度,對 USB 攝像頭有效long Blue_Brightness; /B通

16、道亮度,對 USB 攝像頭有效long Gain; /USB攝像頭增益long TrigStatus; /外觸發(fā)狀態(tài),對 USB 攝像頭有效long recursion_param; /遞歸參數(shù)long videomode; /圖像負像狀態(tài)long inverse_hor; /水平反轉(zhuǎn)long inverse_ver; /垂直反轉(zhuǎn)long reserved7; /保留 , 要求賦值為 0 ;以上參數(shù)的詳細說明見本章第三部分設(shè)置參數(shù)說明,其中 type_code、 ver_code、 constant_swinterval、constant_totallength只作輸出使用。22、USB 攝像

17、頭信息的結(jié)構(gòu)定義Typedef struct _usbinfoDWORD dwSize; /結(jié)構(gòu)大小DWORD dwType; /設(shè)備代碼char szDeviceName32; /設(shè)備名稱DWORD dwEzVer; /68013軟件版本DWORD dwFpgaVer; /fpga設(shè)備版本DWORD dwFpgaType; /fpga類型DWORD dwMaxExpolLines; /最大可設(shè)置曝光行數(shù)DWORD dwMinExpolLines; /最小可設(shè)置曝光行數(shù)DWORD dwMaxWidth; /最大可采集區(qū)域?qū)挾菵WORD dwMaxHeight; /最大可采集區(qū)域高度DWORD

18、dwConvertType; /數(shù)據(jù)格式long lReverse; /數(shù)據(jù)是否反轉(zhuǎn)DWORD dwReverse28; /保留,必須為 0USBINFO, *LPUSBINFO;3、 線陣攝像頭結(jié)構(gòu)體定義struct Config_Linear_Valuelong size;long ident_code;long type_code; /攝像頭 idlong ver_code; /類型碼long work_mode; /工作模式long output_mode; /輸出模式long aoi_begin; /AOI起始像素3long aoi_length; /AOI像素長度long time

19、1_expose; /Time1暴光時間 long time2_expose; /Time2暴光時間 long test_mode; /測試圖模式long regulate_begin; /校正起始行l(wèi)ong regulate_line; /矯正行數(shù)long data_offset; /數(shù)據(jù)移位long red_gain; /紅色增益long green_gain; /綠色增益long blue_gain; /藍色增益long red_offset; /紅色偏置long green_offset; /綠色偏置long blue_offset; /藍色偏置long gain_level; /攝像

20、頭顏色增益等級 long group_id; /攝像頭組編號long member_id; /組內(nèi)成員編號long gain; /單色增益long offset; /單色偏置long reserved39; /保留4、特殊功能結(jié)構(gòu)體定義struct Config_Value_Exlong trigdelay_redge;外觸發(fā)上升沿濾波延時 long trigdelay_dedge;外觸發(fā)下降沿濾波延時 long trigend_shild;外觸發(fā)結(jié)束屏蔽long trig_longexpose;設(shè)置外觸發(fā)長曝光4long reserved28;保留;2、參數(shù)項目名稱宏定義(1以下參數(shù)定義用于

21、函數(shù) okCamSetConfigParm 和 okCamGetConfigParam #define CONFIG_ALLPARAM -1 /設(shè)置全部參數(shù)#define CONFIG_INIPARAM -2 /將全部參數(shù)設(shè)為缺省值 #define CONFIG_CCDGAIN 1 /總增益(原定義#define CONFIG_CONTRAST 1 /對比度(新定義#define CONFIG_WORKMODE 2 /工作模式#define CONFIG_GAMMAMODE 3 /gamma模式#define CONFIG_REFBLACK 4 /黑電平(原定義#define CONFIG_B

22、RIGHTNESS 4 /亮度(新定義#define CONFIG_FRAMEMODE 5 /幀模式#define CONFIG_TESTMODE 6 /測試模式#define CONFIG_PARTBEGIN 7 /局部起始行#define CONFIG_PARTEND 8 /局部結(jié)束行#define CONFIG_EXPOSE 9 /曝光行數(shù)#define CONFIG_RGAIN 10 /R通道增益(原定義 #define CONFIG_REDCONTRAST 10 /紅色通道對比度(新定義 #define CONFIG_GGAIN 11 /G通道增益(原定義 #define CONFI

23、G_GREENCONTRAST 11 /綠色通道對比度(新定義 #define CONFIG_BGAIN 12 /B通道增益(原定義 #define CONFIG_BLUECONTRAST 12 /藍色通道對比度(新定義 #define CONFIG_COLORSATURATION 13 /色彩飽和度#define CONFIG_FRAMERATE 14 /幀頻索引號5#define CONFIG_GAMMA 15 /設(shè)置 GAMMA 數(shù)據(jù)參數(shù)#define CONFIG_CIRLRADIUS 16 /消隱圓半徑#define CONFIG_CIRLCOREHS 17 /消隱圓中心橫坐標#de

24、fine CONFIG_CIRLCOREVS 18 /消隱園中心縱坐標#define CONFIG_EXPOSETIME 19 /USB攝像頭曝光時間#define CONFIG_REDBRIGHTNESS 21 /USB攝像頭紅色通道亮度#define CONFIG_GREENBRIGHTNESS 22 /USB攝像頭綠色通道亮度#define CONFIG_BLUEBRIGHTNESS 23 /USB攝像頭藍色通道亮度#define CONFIG_ALLCONTRAST 24 /二級 CCD 增益,對 AC1310有效 #define CONFIG_RECURSION 25 /遞歸參數(shù)#d

25、efine CONFIG_VIDEOMODE 26 /負像 1有效,0無效#define CONFIG_INVERSE_HOR 27 /水平反轉(zhuǎn)(左右 :1有效,0無效 #define CONFIG_INVERSE_VER 28 /垂直反轉(zhuǎn)(左右 :1有效,0無效 #define CONFIG_SHORT_EXPOSE 29 /短曝光參數(shù),有效范圍 0255,目前 只對 AM1430I 有效/攝像頭特殊功能#define CONFIG_TRIG_DELAY_REDGE 31 /外觸發(fā)上升沿濾波延時 #define CONFIG_TRIG_DELAY_DEDGE 32 /外觸發(fā)下降沿濾波延時 #

26、define CONFIG_TRIG_END_SHILD 33 /外觸發(fā)結(jié)束屏蔽#define CONFIG_ALLPARAM_EX 34 /設(shè)置特殊功能全部參數(shù)#define CONFIG_INITPARAM_EX 35 /將特殊功能全部參數(shù)設(shè)為缺省值 #define CONFIG_TRIG_LONGEXPOSE 36 /外觸發(fā)長曝光以下適用于線陣攝像頭:#define CONFIG_ALLPARAM_LINEAR 100 /所有參數(shù)#define CONFIG_INITPARAM_LINEAR 101 /缺省值#define CONFIG_WORKMODE_LINEAR 102 /工作模式

27、#define CONFIG_OUTPUTMODE_LINEAR 103 /Cameralink輸出模式 6#define CONFIG_AOIBEGIN_LINEAR 104 /AOI起始像素#define CONFIG_AOILENGTH_LINEAR 105 /AOI像素長度#define CONFIG_TIME1EXPOSE_LINEAR 106 /Time1曝光時間#define CONFIG_TIME2EXPOSE_LINEAR 107 /Time2曝光時間#define CONFIG_TESTMODE_LINEAR 108 /測試圖模式#define CONFIG_REGULAT

28、EBEGIN_LINEAR 109 /校正起始行#define CONFIG_REGULATELINE_LINEAR 110 /位置校正行數(shù)#define CONFIG_DATAOFFSET_LINEAR 111 /數(shù)據(jù)移位#define CONFIG_REDGAIN_LINEAR 112 /紅色增益#define CONFIG_GREENGAIN_LINEAR 113 /綠色增益#define CONFIG_BLUEGAIN_LINEAR 114 /藍色增益#define CONFIG_REDOFFSET_LINEAR 115 /紅色偏置#define CONFIG_GREENOFFSET_

29、LINEAR 116 /綠色偏置#define CONFIG_BLUEOFFSET_LINEAR 117 /藍色偏置#define CONFIG_GAINLEVEL_LINEAR 118 /顏色增益等級#define CONFIG_GROUPID_LINEAR 119 /分組功能,組編號#define CONFIG_MEMBERID_LINEAR 120 /分組功能,組內(nèi)編號 #define CONFIG_GAIN_INEAR 125 /增益#define CONFIG_OFFSET_LINEAR 126 /偏置 CONFIG_WORKMODE(2 對應(yīng)的 lParam 參數(shù)宏定義如下:#de

30、fine FREE 1 /連續(xù)模式#define TRIG 2 /外觸發(fā)模式,沿觸發(fā)#define EXTSYN 3 /外同步模式#define FREEZEFRAME 4 /末幀凍結(jié)模式#define PULSETRIG 5 /脈沖觸發(fā)模式 CONFIG_FRAMEMODE(5 對應(yīng)的 lParam 參數(shù)宏定義如下:#define FULL 1 /全圖模式7#define PART 2 /局部模式#define INTERLACE 4 /隔行掃描模式(2以下參數(shù)宏定義用于函數(shù) okCamGetUsbInfo#define DEVICE_INFO 1 /USB攝像頭產(chǎn)品信息#define SO

31、FTWARE_INFO 2 /USB攝像頭軟件版本信息#define DRIVER_INFO 3 /USB攝像頭驅(qū)動版本信息3、錯誤代碼宏定義ERR_COMM_OPEN (102 /打開串口失敗ERR_COMM_LINK (103 /連接設(shè)備失敗ERR_COMM_WRITE (104 /寫串口失敗ERR_COMM_READ (105 /讀串口失敗ERR_FILE_TAG (114 /配置文件標識錯誤ERR_FILE_PRODUCT (116 /配置文件的產(chǎn)品類型碼與連接設(shè)備不一致 ERR_FILE_OPEN (118 /配置文件打開失敗ERR_HANDLE_INVALIDATE (120 /引

32、用句柄無效ERR_INPUT_PARAM (122 /輸入?yún)?shù)錯誤ERR_TYPE_CODE (124 /讀取的設(shè)備類型碼無法識別 4、產(chǎn)品類型碼宏定義#define AC1200 211200#define AC1300 211300#define AM1100 201100#define AM1101 2011018#define AM1105 201105#define AM1120 201120#define AM1300 201300#define AM1320 201320#define AM1330 201330#define AM1400 201400#define AM142

33、0 201420#define AM1430 201430#define AM1520 201520#define AM1521 201521#define AM1530 201530#define AM1531 201531/USB攝像頭#define SC3010 313010#define SC1310 311310#define AM1310 201310#define AM1410 201410#define AC1310 211310#define AC1360 211360/千兆網(wǎng)攝像頭#define AM1160 201160#define AM1161 201161#defi

34、ne AM1360 201360#define AM1460 201460#define AM1560 201560/線陣攝像頭#define LC2020 1120209#define LM2020 102020#define LM1020 101020對同一類型攝像頭的升級版采用相同類型碼,但用不同版本號進行區(qū)分。 如 AM1100的類型碼為 201100,版本號為 0, 其升級版 AM1100A 類型碼為 201100, 版本號為 1, 升級版 AM1100B 類型碼為 201100,版本號為 2;AM1101的類型碼 為 201101, 版本號為 0, 其升級版 AM1101A 類型碼

35、為 201101, 版本號為 1; AM1430I 的類型碼為 201430,版本號為 9。5、參數(shù)結(jié)構(gòu)體標示宏定義#define CCD_IDENT_CODE 0xFFFE此標記用于判定參數(shù)結(jié)構(gòu)體的合法性。在初始化參數(shù)結(jié)構(gòu)體時,必須設(shè)置 參數(shù) ident_code= CCD_IDENT_CODE;10二、DLL 動態(tài)庫接口函數(shù)1、常用函數(shù)(1打開攝像頭HANDLE WINAPI okCamOpenCamera(long *lTypeCode, char *szPortName;功 能:打開指定端口的攝像頭,創(chuàng)建可供其它函數(shù)引用的攝像頭句柄。 適用范圍:RS232串行接口攝像頭、USB 接口攝

36、像頭、線陣攝像頭和千兆攝像頭 參 數(shù):lTypeCode 產(chǎn)品類型碼的傳遞指針(in/out ,產(chǎn)品類型碼的宏定 義如下:#define AC1200 211200#define AC1300 211300#define AM1100 201100#define AM1101 201101#define AM1105 201105#define AM1120 201120#define AM1300 201300#define AM1320 201320#define AM1330 201330#define AM1400 201400#define AM1420 20142011#defin

37、e AM1430 201430#define AM1520 201520#define AM1521 201521#define AM1530 201530#define AM1531 201531/USB攝像頭#define SC3010 313010#define SC1310 311310#define AM1310 201310#define AM1410 201410#define AC1310 211310#define AC1360 211360/千兆攝像頭#define AM1160 201160#define AM1161 201161#define AM1360 20136

38、0#define AM1460 201460#define AM1560 201560/線陣攝像頭#define LC2020 112020#define LM2020 102020#define LM1020 101020szPortName 端口名稱的傳遞指針(in/out返回值:如果調(diào)用成功,返回一個指向攝像頭的引用句柄,如果未能打開指定 的攝像頭或無法創(chuàng)建句柄返回 0;說明:為指針 szPortName 分配的存儲空間, 應(yīng)大于或等于 10個字符長度。 如 char 12szPortName10。以保證其有足夠的空間傳遞串口名稱。當 *lTypeCode初始值為 -1, 且 szPor

39、tName 等于 ”COM” 時, 函數(shù)將依次檢測 串口 COM1到 COM18, 如在此過程中找到某一攝像頭, 則自動停止檢測 (即若 在 COM1檢測到攝像頭, 函數(shù)不會繼續(xù)檢測 COM2, COM3 。 這時指針 lTypeCode 傳遞的參數(shù)值等于該攝像頭的產(chǎn)品類型碼,指針 szPortName 傳遞的參數(shù)值為該 攝像頭所在的串口名稱,函數(shù)返回一個引用句柄。如在此過程中沒有檢測到任 何攝像頭,則指針 lTypeCode 傳遞的參數(shù)值等于 -1,指針 szPortName 傳遞的參 數(shù)值不變,函數(shù)返回 0。我們提供的 CamerDemo 演示程序默認檢測 4個串口 COM1到 COM4。

40、當 *lTypeCode初始值為 -1,且 szPortName 等于 ”COM1” , , ”COMn” 中 的某一個串口名稱時,函數(shù)只檢測這一串口。如找到某一攝像頭,這時指針 lTypeCode 傳遞的參數(shù)值等于該攝像頭的產(chǎn)品類型碼,指針 szPortName 傳遞的 參數(shù)值不變化,函數(shù)返回一個引用句柄。如在此過程中沒有檢測到任何攝像頭, 則指針 lTypeCode 傳遞的參數(shù)值等于 -1,指針 szPortName 傳遞的參數(shù)值不變, 函數(shù)返回 0。當 *lTypeCode初始值為某一攝像頭的產(chǎn)品類型碼,且 szPortName 等 于 ”COM” 時,函數(shù)依次檢測 COM1到 COM1

41、8,如在此過程中找到產(chǎn)品類型碼 與指針 lTypeCode 傳遞的參數(shù)值相等的攝像頭, 則自動停止檢測 (即若在 COM1檢測到符合條件的攝像頭,函數(shù)不會繼續(xù)檢測 COM2, COM3 。這時指針 lTypeCode 傳遞的參數(shù)值等于該攝像頭的產(chǎn)品類型碼,指針 szPortName 傳遞的 參數(shù)值為該攝像頭所在的串口名稱,函數(shù)返回一個引用句柄。如在此過程中沒 有檢測到符合條件的攝像頭,則指針 lTypeCode 傳遞的參數(shù)值等于 -1,指針 szPortName 傳遞的參數(shù)值不變,函數(shù)返回 0。當 *lTypeCode初始值為某一攝像頭的產(chǎn)品類型碼,且 szPortName 等 于 ”COM1

42、” , , ”COMn” 中的某一個串口名稱時,函數(shù)只檢測這一串口,如再 找到產(chǎn)品類型碼與指針 lTypeCode 傳遞的參數(shù)值相等的攝像頭。這時指針 lTypeCode 傳遞的參數(shù)值不變,指針 szPortName 傳遞的參數(shù)為該攝像頭所在的13串口名稱,函數(shù)返回一個引用句柄。如沒有檢測到符合條件的攝像頭,則指針 lTypeCode 傳遞的參數(shù)值為 -1, 指針 szPortName 傳遞的參數(shù)值不變, 函數(shù)返回 0。 同樣,對于打開 USB 端口的攝像頭, szPortName 等于 ”USB” 時,函數(shù)依次 檢測 USB1到 USB4端口,如在此過程中找到某一攝像頭,則自動停止檢測。 如

43、 szPortName 等于 ”USB1” , , ”USB4” 中的某一個 USB 口名稱時,函數(shù)只 檢測這一 USB 口。其調(diào)用方式與打開串口相同。對于打開 CameraLink 端口的攝像頭, szPortName 等于 ”CamLink” 時,函數(shù) 依次檢測 CameraLink1和 CameraLink2端口,如在此過程中找到某一攝像頭, 則自動停止檢測。其它調(diào)用方式與打開串口相同。對于 USB 轉(zhuǎn)接攝像頭, szPortName 等于 ”USB/232-” 時,函數(shù)依次檢測 USB/232-1到 USB/232-4端口,如在此過程中找到某一攝像頭,則自動停止檢 測。如 szPort

44、Name 等于 ”USB/232-1” , , ”USB/232-4” 中的某一個時,函數(shù) 只檢測這一 USB 轉(zhuǎn)接端口。其調(diào)用方式與打開串口相同。對于千兆網(wǎng)攝像頭,其打開方式與其他類型的攝像頭略有不同。千兆網(wǎng)攝 像頭要求在打開設(shè)備之前先執(zhí)行函數(shù) okCamScanDevice 搜索局域網(wǎng)上設(shè)備連接 狀況,得到所有已連接攝像頭的 IP 等詳細信息。并根據(jù)得到的信息對攝像頭進 行操作,目前我們的軟件支持最多同時連接 4個千兆攝像頭的情況。在這里需 要注意的是,每次執(zhí)行 okCamScanDevice 搜索千兆攝像頭得到的排列順序并不 是完全不變的,因此對千兆攝像頭而言我們不能像操作模擬攝像頭那樣

45、僅通過 連接端口就能確定的對指定的攝像頭進行操作。與其他類型的攝像頭不同,千 兆攝像頭唯一不變的標識是執(zhí)行 okCamScanDevice 搜索得到的攝像頭 IP 信息。 為了保持與原有攝像頭打開函數(shù)形式兼容, CamDemo 對千兆攝像頭的處理如 下:按照 okCamScanDevice 搜索結(jié)果順序, 虛擬設(shè)定端口為 NetPort1至 NetPort4, 并將其與得到的攝像頭 IP 信息關(guān)聯(lián),其他操作方法與前面介紹的打開串口方式 相同,即 szPortName的取值范圍為 ”NetPort1”NetPortn”, 其中 n 為執(zhí)行 okCamScanDevice 搜索得到的連接攝像頭數(shù),對于同一次搜索結(jié)果,攝像頭 IP 與端口索引的對應(yīng)關(guān)系是固定的。關(guān)于 okCamScanDevice 函數(shù)的介紹請參考本14小節(jié)第 6部分千兆攝像頭相關(guān)函數(shù)。相關(guān)函數(shù):okCamCloseCamera,okCamGetLastError, okCamScanDevice(2關(guān)閉攝像頭BOOL WINAPI okCamCloseCamera(HANDLE hCamera;功 能:關(guān)閉進行配置的攝像頭,釋放引用句柄。適用范圍:RS232串行接口攝像頭、USB 接口攝像頭、線陣攝像頭和千兆攝像頭 參 數(shù): hCamera 引用