簡(jiǎn)介本資源是一套面向工業(yè)視覺(jué)開(kāi)發(fā)者的C#實(shí)戰(zhàn)示例項(xiàng)目聚焦Basler相機(jī)SDK集成與圖像采集核心功能實(shí)現(xiàn)適用于機(jī)器視覺(jué)工程師、自動(dòng)化設(shè)備開(kāi)發(fā)者及高校相關(guān)專業(yè)學(xué)生快速掌握工業(yè)相機(jī)二次開(kāi)發(fā)要點(diǎn)。項(xiàng)目完整覆蓋相機(jī)連接枚舉、單幀/連續(xù)圖像采集、軟觸發(fā)控制、曝光與增益動(dòng)態(tài)調(diào)節(jié)、圖像縮放等關(guān)鍵環(huán)節(jié)并提供線程安全處理與基礎(chǔ)錯(cuò)誤恢復(fù)邏輯可直接用于產(chǎn)線檢測(cè)、實(shí)時(shí)監(jiān)控等場(chǎng)景的原型開(kāi)發(fā)。壓縮包含37個(gè)文件11個(gè)C#源碼文件、3個(gè)可執(zhí)行exe、3個(gè)核心dll、4個(gè)配置及緩存文件等總大小11.05MB結(jié)構(gòu)清晰——包含主窗體Form_Main、相機(jī)基類(lèi)CameraBase、程序入口Program及完整VS解決方案.sln與項(xiàng)目配置.csproj便于理解模塊劃分與調(diào)用鏈路。目前已有2039人學(xué)習(xí)下載代碼注釋充分、邏輯分層明確是入門(mén)Basler官方Pylon SDK C#開(kāi)發(fā)的高實(shí)用性參考工程。 做工業(yè)相機(jī)上位機(jī)開(kāi)發(fā)的朋友應(yīng)該都對(duì)Basler不陌生。這個(gè)項(xiàng)目是基于C#的Basler相機(jī)SDK開(kāi)發(fā)示例核心任務(wù)就是讀取相機(jī)——從枚舉設(shè)備、打開(kāi)相機(jī)、配置參數(shù)到采集圖像并保存把一條完整的取流鏈路跑通。如果你正在用C#做上位機(jī)或者剛拿到Basler相機(jī)不知道從哪里下手這篇內(nèi)容可以幫你少走不少?gòu)澛贰Ｎ易约旱谝淮谓佑|Basler時(shí)就是從這樣一個(gè)小小的讀取示例開(kāi)始的后面逐步擴(kuò)展到了視覺(jué)定位、外觀檢測(cè)、多個(gè)相機(jī)同時(shí)采集等真實(shí)項(xiàng)目這里就把整個(gè)思路和代碼細(xì)節(jié)都梳理一遍。1. 項(xiàng)目背景與整體思路1.1 為什么選C#和官方SDK當(dāng)時(shí)我拿到Basler相機(jī)后第一反應(yīng)是想用C寫(xiě)采集程序覺(jué)得工業(yè)相機(jī)底層應(yīng)該用C才夠?qū)I(yè)。但真正做下來(lái)發(fā)現(xiàn)團(tuán)隊(duì)里的大部分業(yè)務(wù)代碼都是C#寫(xiě)的上位機(jī)界面、數(shù)據(jù)存儲(chǔ)、通信協(xié)議這些環(huán)節(jié)都已經(jīng)有現(xiàn)成模塊如果再引入一套C采集代碼維護(hù)成本會(huì)翻倍。Basler官方pylon SDK對(duì)C#的支持已經(jīng)很成熟取流性能經(jīng)過(guò)封裝后仍然足夠穩(wěn)定對(duì)大多數(shù)視覺(jué)檢測(cè)項(xiàng)目來(lái)說(shuō)完全夠用。所以我最后選了C# Basler官方pylon SDK這也是工業(yè)現(xiàn)場(chǎng)驗(yàn)證過(guò)的最穩(wěn)妥路徑。選擇官方SDK而不是AForge、OpenCV VideoCapture這類(lèi)通用庫(kù)理由更直接。AForge雖然后續(xù)版本也能驅(qū)動(dòng)部分?jǐn)z像頭但它更偏民用攝像頭對(duì)工業(yè)相機(jī)上常用的曝光、增益、觸發(fā)源、像素格式、ROI這些參數(shù)控制很弱。OpenCV的VideoCapture同樣只負(fù)責(zé)拉到視頻幀根本不夠應(yīng)對(duì)工業(yè)場(chǎng)景里“必須精確控制采集時(shí)機(jī)”的需求。Basler的pylon SDK基于GenICam標(biāo)準(zhǔn)把所有相機(jī)參數(shù)都抽象成參數(shù)節(jié)點(diǎn)讀寫(xiě)統(tǒng)一走一套接口跟具體相機(jī)型號(hào)無(wú)關(guān)。你只需要關(guān)注業(yè)務(wù)邏輯不用為每個(gè)型號(hào)單獨(dú)適配。1.2 開(kāi)發(fā)環(huán)境和工具準(zhǔn)備我這次的開(kāi)發(fā)環(huán)境是Windows 10 x64系統(tǒng)、Visual Studio 2019、pylon 6.3.1版本64位。如果你手頭的相機(jī)是USB3.0接口建議先檢查電腦的USB控制器驅(qū)動(dòng)是不是官方最新版如果是GigE網(wǎng)口相機(jī)要確保網(wǎng)卡和相機(jī)在同一個(gè)網(wǎng)段并且網(wǎng)卡支持并開(kāi)啟巨型幀。安裝pylon時(shí)默認(rèn)會(huì)一起安裝pylon Viewer這個(gè)工具非常關(guān)鍵。我強(qiáng)烈建議你先用pylon Viewer確認(rèn)相機(jī)能正常出圖再動(dòng)手寫(xiě)代碼否則你很難判斷問(wèn)題到底出在相機(jī)本身還是自己的代碼里。注意安裝pylon時(shí)一定要確認(rèn)勾選了“.pylon .NET runtime”組件。很多新手裝完SDK之后在Visual Studio里添加引用時(shí)找不到Basler.Pylon.dll就是因?yàn)闆](méi)有裝.NET運(yùn)行時(shí)。這個(gè)坑我自己就踩過(guò)后來(lái)重新運(yùn)行安裝包補(bǔ)裝組件才解決。然后在Visual Studio里新建一個(gè)控制臺(tái)應(yīng)用目標(biāo)框架用.NET Framework 4.7.2或者.NET 6.0以上都可以Basler官方對(duì).NET的支持現(xiàn)在非常成熟。在項(xiàng)目引用里添加Basler.Pylon.dll默認(rèn)路徑一般是C:\Program Files\Basler\pylon 6\Development\Assemblies\。如果這一步編譯時(shí)提示找不到程序集先檢查項(xiàng)目平臺(tái)是不是x64pylon的64位DLL不能直接給AnyCPU平臺(tái)引用這里需要提前設(shè)置好。2. 快速搭通第一步發(fā)現(xiàn)與枚舉相機(jī)2.1 認(rèn)識(shí)pylon SDK中的核心類(lèi)整個(gè)pylon .NET SDK里最核心的類(lèi)其實(shí)就幾個(gè)CameraFinder負(fù)責(zé)查找相機(jī)Camera是相機(jī)操作入口ICameraInfo描述設(shè)備信息IGrabResult是一次取流的結(jié)果對(duì)象ImageConverter負(fù)責(zé)像素格式轉(zhuǎn)換。這一組類(lèi)和C版本的API是一一對(duì)應(yīng)的理解了它們后續(xù)不管換哪款Basler相機(jī)你的代碼都能很快適應(yīng)。CameraFinder這個(gè)名字取得很直白它就是用來(lái)找設(shè)備的。很多初學(xué)者寫(xiě)相機(jī)程序第一步就卡在這里不知道怎么枚舉USB相機(jī)和GigE相機(jī)。CameraFinder會(huì)調(diào)用底層傳輸層把系統(tǒng)里所有pylon能認(rèn)識(shí)的設(shè)備都列出來(lái)你不用分別處理USB3、GigE、Camera Link等接口的差異。這個(gè)設(shè)計(jì)對(duì)業(yè)務(wù)開(kāi)發(fā)非常友好相當(dāng)于把底層硬件差異全部屏蔽掉了。2.2 枚舉相機(jī)并讀取基本信息先寫(xiě)一個(gè)最簡(jiǎn)單的枚舉示例using Basler.Pylon; using System; using System.Collections.Generic; class Program { static void Main(string[] args) { ListICameraInfo cameras CameraFinder.Enumerate(); if (cameras.Count 0) { Console.WriteLine(未找到相機(jī)請(qǐng)檢查連接和驅(qū)動(dòng)。); return; } for (int i 0; i cameras.Count; i) { Console.WriteLine(相機(jī)索引: i); Console.WriteLine(廠商: cameras[i][CameraInfoKey.VendorName]); Console.WriteLine(型號(hào): cameras[i][CameraInfoKey.ModelName]); Console.WriteLine(序列號(hào): cameras[i][CameraInfoKey.SerialNumber]); Console.WriteLine(接口類(lèi)型: cameras[i][CameraInfoKey.DeviceType]); } } }運(yùn)行這段代碼如果相機(jī)連接正?？刂婆_(tái)會(huì)列出當(dāng)前系統(tǒng)里的所有Basler相機(jī)信息。CameraInfoKey訪問(wèn)器返回的是字符串屬性不存在時(shí)返回空字符串所以直接打印也不會(huì)拋異常。這里有個(gè)細(xì)節(jié)值得多說(shuō)一句枚舉到的設(shè)備不保證一定能打開(kāi)。比如GigE相機(jī)如果IP沒(méi)有配好CameraFinder依然能看到它但真正Open時(shí)會(huì)失敗。所以枚舉只能作為第一步真正能否通信要以打開(kāi)相機(jī)的結(jié)果為準(zhǔn)。另外如果你的電腦上同時(shí)安裝了多個(gè)品牌的相機(jī)驅(qū)動(dòng)pylon偶爾也會(huì)枚舉出非Basler設(shè)備但一般不推薦用它來(lái)操作其他品牌相機(jī)各家的SDK還是各用各的穩(wěn)妥。3. 連接相機(jī)與參數(shù)配置實(shí)操3.1 打開(kāi)相機(jī)與觸發(fā)模式設(shè)置枚舉沒(méi)問(wèn)題之后下一步就是打開(kāi)相機(jī)。Basler pylon的Camera對(duì)象實(shí)現(xiàn)了IDisposable用完要釋放。最穩(wěn)妥的寫(xiě)法是用using包裹using (Camera camera new Camera(cameras[0])) { camera.Open(); // 打開(kāi)后可以設(shè)置參數(shù) camera.Parameters[PLCamera.ExposureTime].SetValue(5000.0); // 曝光 5000us camera.Parameters[PLCamera.Gain].SetValue(0.0); // 切換觸發(fā)模式 camera.Parameters[PLCamera.TriggerMode].SetValue(PLCamera.TriggerMode.Off); // 連續(xù)采集 }camera.Open()如果不拋異常說(shuō)明設(shè)備通信正常pylon已經(jīng)建立了與相機(jī)的連接。這里有一個(gè)容易踩的坑不同型號(hào)的Basler相機(jī)參數(shù)名可能略有差異比如有的相機(jī)用ExposureTime有的用ExposureTimeRaw還有的老型號(hào)保留ExposureTimeAbs。代碼里直接寫(xiě)字符串參數(shù)名也可以但推薦用PLCamera枚舉pylon會(huì)自動(dòng)做映射換型號(hào)時(shí)不容易寫(xiě)錯(cuò)。觸發(fā)模式是工業(yè)相機(jī)開(kāi)發(fā)里繞不開(kāi)的概念。連續(xù)模式TriggerMode.Off適合實(shí)時(shí)預(yù)覽和對(duì)幀率要求高的場(chǎng)景軟觸發(fā)模式TriggerMode.On TriggerSource.Software適合需要精確控制采集時(shí)機(jī)的場(chǎng)景比如系統(tǒng)定位完成后再去抓一幀硬觸發(fā)模式TriggerSource.Line1適合外部傳感器給信號(hào)時(shí)采集比如運(yùn)動(dòng)控制系統(tǒng)到達(dá)指定位置后觸發(fā)拍照。項(xiàng)目標(biāo)題里說(shuō)的是“讀取相機(jī)”所以先用連續(xù)模式跑通但代碼里最好把觸發(fā)切換的入口預(yù)留好方便后面擴(kuò)展。3.2 相機(jī)參數(shù)讀寫(xiě)背后的GenICam機(jī)制為什么Basler的SDK要用Parameters[xxx].SetValue這種寫(xiě)法而不是像普通C#類(lèi)那樣直接給屬性賦值這就要說(shuō)到GenICam標(biāo)準(zhǔn)。GenICam的核心是把相機(jī)內(nèi)部的寄存器抽象成一個(gè)個(gè)參數(shù)節(jié)點(diǎn)每個(gè)節(jié)點(diǎn)有名稱、類(lèi)型、取值范圍、訪問(wèn)權(quán)限。SDK通過(guò)這些節(jié)點(diǎn)和相機(jī)通信寫(xiě)參數(shù)時(shí)SDK會(huì)檢查值是否合法讀參數(shù)時(shí)返回相機(jī)當(dāng)前的真實(shí)值。這套機(jī)制的優(yōu)點(diǎn)是跨廠商通用缺點(diǎn)是初學(xué)時(shí)不直觀你得習(xí)慣用節(jié)點(diǎn)名去“碰”參數(shù)。舉例說(shuō)明你想知道當(dāng)前曝光時(shí)間是多少不能直接讀一個(gè)叫ExposureTime的屬性而要這樣double expTime camera.Parameters[PLCamera.ExposureTime].GetValue();你會(huì)發(fā)現(xiàn)哪怕剛打開(kāi)相機(jī)這個(gè)值也往往不是0而是相機(jī)內(nèi)部的默認(rèn)值。pylon會(huì)在Open時(shí)自動(dòng)同步一次參數(shù)所以GetValue返回的是相機(jī)里的真實(shí)狀態(tài)不是軟件緩存里的假值。還有一個(gè)容易被忽略的點(diǎn)讀參數(shù)之前最好先判斷一下參數(shù)是否可用。相機(jī)某些參數(shù)在特定狀態(tài)下會(huì)被鎖定比如采集過(guò)程中有的相機(jī)不允許改曝光直接SetValue會(huì)拋異常。穩(wěn)妥的做法是先判斷IsWritableIParameter expParam camera.Parameters[PLCamera.ExposureTime]; if (expParam.IsWritable) { expParam.SetValue(8000.0); }這樣寫(xiě)雖然啰嗦但實(shí)際項(xiàng)目里能少很多運(yùn)行時(shí)的意外崩潰。4. 圖像采集與保存的完整實(shí)現(xiàn)4.1 連續(xù)采集與單幀抓取的實(shí)現(xiàn)參數(shù)配好后真正重頭戲是取流。Basler取流模型是“拉流”模式相機(jī)把數(shù)據(jù)放到傳輸層緩存里應(yīng)用層調(diào)用RetrieveResult去取。先看連續(xù)采集的簡(jiǎn)版代碼camera.StartGrabbing(); using (IGrabResult result camera.StreamGrabber.RetrieveResult(1000, TimeoutHandling.ThrowException)) { if (result.GrabSucceeded) { Console.WriteLine(采集成功寬度: {0}, 高度: {1}, 像素格式: {2}, result.Width, result.Height, result.PixelTypeValue); } } camera.StopGrabbing();RetrieveResult的第一個(gè)參數(shù)是超時(shí)毫秒數(shù)第二個(gè)參數(shù)TimeoutHandling.ThrowException表示超時(shí)直接拋異常。實(shí)際項(xiàng)目里我更喜歡用TimeoutHandling.Return這樣超時(shí)后你自行判斷result是否有效不至于讓整個(gè)程序崩潰退出。這里有一個(gè)基本概念要理清StartGrabbing并不是“拍一張照片”的意思它更像一個(gè)總閘表示開(kāi)啟采集管線。真正的圖像數(shù)據(jù)是源源不斷進(jìn)入系統(tǒng)緩存的RetrieveResult只是從緩存隊(duì)列里取回離你最近的一幀。所以它天然適合連續(xù)預(yù)覽也適合軟觸發(fā)后立刻取回那一幀。如果需要實(shí)現(xiàn)“按一次拍一張”的軟觸發(fā)邏輯可以這樣寫(xiě)camera.Parameters[PLCamera.TriggerMode].SetValue(PLCamera.TriggerMode.On); camera.Parameters[PLCamera.TriggerSource].SetValue(PLCamera.TriggerSource.Software); camera.StartGrabbing(); // 觸發(fā)一次 camera.ExecuteSoftwareTrigger(); using (IGrabResult result camera.StreamGrabber.RetrieveResult(2000, TimeoutHandling.Return)) { if (result ! null result.GrabSucceeded) { // 處理當(dāng)前幀 } } camera.StopGrabbing();軟觸發(fā)的好處是采集節(jié)奏完全由程序控制不會(huì)出現(xiàn)連續(xù)采集時(shí)那種“處理不過(guò)來(lái)、緩存堆積”的情況。視覺(jué)檢測(cè)項(xiàng)目里絕大多數(shù)都會(huì)用軟觸發(fā)或硬觸發(fā)采集進(jìn)度和業(yè)務(wù)邏輯能完全對(duì)齊。4.2 圖像格式轉(zhuǎn)換與保存從GrabResult里拿到的數(shù)據(jù)是相機(jī)原始像素格式可能是Mono8、BayerRG8、YUV422等。直接保存成圖片前要轉(zhuǎn)成位圖能識(shí)別的格式。Basler提供ImageConverter來(lái)完成轉(zhuǎn)換using System.Drawing; using System.Drawing.Imaging; using Basler.Pylon; ImageConverter converter new ImageConverter(); converter.OutputPixelFormat PixelType.BGRA8packed; Bitmap bitmap new Bitmap(converter.Convert(result)); bitmap.Save(D:\test.png, ImageFormat.Png);這段代碼看似簡(jiǎn)單但有幾個(gè)點(diǎn)要提醒。第一ImageConverter每次轉(zhuǎn)換會(huì)分配內(nèi)存高頻采集時(shí)最好復(fù)用同一個(gè)converter實(shí)例不要每幀都new一個(gè)否則GC壓力很大。第二如果相機(jī)是黑白相機(jī)輸出像素格式可以選Mono8轉(zhuǎn)成BGRA8雖然也能顯示但數(shù)據(jù)量變成4倍性能上不劃算。第三Bitmap保存時(shí)要注意圖片格式BMP無(wú)損但體積大JPG有損但體積小工業(yè)場(chǎng)景通常用BMP或PNG避免壓縮干擾后續(xù)圖像算法。如果你需要把圖像交給OpenCV或Halcon處理而不是保存成圖片也有對(duì)應(yīng)的轉(zhuǎn)換方式。OpenCV的Mat可以由BitmapData逐行拷貝過(guò)去Halcon的HObject可以用像素指針構(gòu)造。這里面涉及內(nèi)存對(duì)齊的問(wèn)題新手容易碰到黑邊或者圖像歪斜通常是因?yàn)锽itmap的Stride和圖像寬度乘像素字節(jié)數(shù)不一致拷貝時(shí)按Stride逐行處理就能解決。另外連續(xù)保存圖像時(shí)建議統(tǒng)一命名規(guī)則比如用時(shí)間戳或幀號(hào)來(lái)區(qū)分避免文件名沖突。我自己常用DateTime.Now.ToString(yyyyMMdd_HHmmss_fff)加計(jì)數(shù)器的方式這樣保存出來(lái)的圖片順序清晰排錯(cuò)的時(shí)候?qū)Φ蒙稀?. 常見(jiàn)問(wèn)題與排查技巧實(shí)錄5.1 相機(jī)找不到、打不開(kāi)、被占用這是出現(xiàn)頻率最高的一類(lèi)問(wèn)題我把常見(jiàn)的現(xiàn)象、原因和處理方式整理成了一張表方便快速對(duì)照排查現(xiàn)象可能原因處理方式枚舉不到相機(jī)USB未插緊、驅(qū)動(dòng)未裝用pylon Viewer確認(rèn)是否識(shí)別重裝USB驅(qū)動(dòng)GigE相機(jī)枚舉到但打不開(kāi)IP不在同一網(wǎng)段將電腦網(wǎng)卡IP改為和相機(jī)同網(wǎng)段開(kāi)啟巨型幀打開(kāi)時(shí)報(bào)“設(shè)備被占用”相機(jī)正被pylon Viewer或其他進(jìn)程使用關(guān)閉pylon Viewer結(jié)束占用相機(jī)的進(jìn)程打開(kāi)時(shí)頻繁超時(shí)網(wǎng)線質(zhì)量差網(wǎng)絡(luò)擁塞換六類(lèi)網(wǎng)線直連關(guān)閉電腦無(wú)關(guān)網(wǎng)絡(luò)服務(wù)特別要提一下GigE相機(jī)的IP配置。很多新手把相機(jī)插上就等著自動(dòng)出圖但GigE相機(jī)默認(rèn)可能是DHCP或固定IP電腦網(wǎng)卡沒(méi)配好兩者根本不在一個(gè)網(wǎng)段自然打不開(kāi)。解決方法是打開(kāi)網(wǎng)絡(luò)適配器設(shè)置把電腦IP改成和相機(jī)同網(wǎng)段比如相機(jī)是192.168.1.10電腦就設(shè)192.168.1.100。這個(gè)配置在pylon Viewer里可以直接看Viewer能顯示相機(jī)當(dāng)前IP和MAC地址非常方便。5.2 取流超時(shí)、丟幀、圖像花屏取流問(wèn)題通常比連接問(wèn)題更頭疼。我排查這類(lèi)問(wèn)題的第一反應(yīng)是打開(kāi)pylon Viewer看同樣場(chǎng)景下相機(jī)是否穩(wěn)定出圖。如果Viewer里也丟幀說(shuō)明是傳輸鏈路或相機(jī)配置問(wèn)題如果Viewer正常只有自己寫(xiě)的代碼丟幀那基本就是代碼里處理圖像太慢緩存隊(duì)列滿了。USB3相機(jī)要特別注意供電和帶寬。有些電腦USB3口供電不足相機(jī)能枚舉出來(lái)但高分辨率下取流不穩(wěn)定。換一個(gè)原生USB3口或者使用帶供電的HUB往往能解決問(wèn)題。GigE相機(jī)則要檢查網(wǎng)卡中斷調(diào)節(jié)設(shè)置和巨型幀巨型幀能讓大幀的數(shù)據(jù)包數(shù)量減少顯著降低CPU開(kāi)銷(xiāo)。如果用了交換機(jī)還要確認(rèn)交換機(jī)支持并開(kāi)啟了巨型幀否則設(shè)置了也白搭。圖像花屏的情況多半是像素格式轉(zhuǎn)換錯(cuò)誤。例如相機(jī)輸出BayerRG8你按Mono8去解讀圖像就會(huì)出現(xiàn)明顯的橫條紋色彩錯(cuò)亂。遇到這種問(wèn)題先看pylon Viewer里顯示的Pixel Format再對(duì)照代碼里ImageConverter的輸出設(shè)置一般很快能定位。5.3 編譯時(shí)報(bào)“無(wú)法加載一個(gè)或多個(gè)請(qǐng)求的類(lèi)型”這個(gè)問(wèn)題被很多人反復(fù)問(wèn)過(guò)在這里我統(tǒng)一說(shuō)。運(yùn)行程序時(shí)突然報(bào)“無(wú)法加載一個(gè)或多個(gè)請(qǐng)求的類(lèi)型”通常不是代碼邏輯錯(cuò)誤而是程序集加載失敗。最常見(jiàn)的原因是Basler.Pylon.dll依賴了一些本地DLL而發(fā)布時(shí)沒(méi)帶上這些依賴或者程序輸出目錄找不到pylon的運(yùn)行時(shí)文件。解決辦法很簡(jiǎn)單把pylon安裝目錄里對(duì)應(yīng)架構(gòu)的DLL復(fù)制到程序輸出目錄或者用pylon的完整安裝讓運(yùn)行時(shí)注冊(cè)到系統(tǒng)路徑。另外檢查項(xiàng)目的目標(biāo)平臺(tái)如果是AnyCPU建議改成x64pylon的.NET DLL在x64環(huán)境下最穩(wěn)定。我自己的做法是項(xiàng)目引用里添加Basler.Pylon.dll之后把“復(fù)制本地”屬性設(shè)為T(mén)rue這樣生成時(shí)會(huì)自動(dòng)把DLL帶到輸出目錄減少運(yùn)行時(shí)的搜索麻煩。如果用了NuGet包管理也要確認(rèn)pylon相關(guān)的包版本和安裝的SDK版本一致版本錯(cuò)配同樣會(huì)觸發(fā)這類(lèi)加載錯(cuò)誤。6. 項(xiàng)目擴(kuò)展思路與多相機(jī)封裝6.1 從控制臺(tái)到上位機(jī)UI上面所有代碼都是控制臺(tái)示例但實(shí)際上位機(jī)項(xiàng)目不會(huì)在控制臺(tái)里看圖像。UI層需要把相機(jī)采集放在后臺(tái)線程然后通過(guò)跨線程安全的方式刷新界面。比如用Task.Run開(kāi)采集循環(huán)拿到Bitmap后用pictureBox.BeginInvoke回傳。一個(gè)常見(jiàn)的錯(cuò)誤是直接在UI線程里RetrieveResult持續(xù)拉流會(huì)卡死界面。即使只是單幀讀取RetrieveResult也可能阻塞幾十毫秒到幾秒用戶界面會(huì)明顯卡頓。所以采集線程和UI線程必須分開(kāi)這是C#上位機(jī)開(kāi)發(fā)的基本功。PictureBox控件雖然也支持直接賦值Image屬性但跨線程更新時(shí)要通過(guò)Invoke否則會(huì)拋出“線程間操作無(wú)效”的異常。6.2 多相機(jī)并行采集和SDK封裝如果你在一個(gè)項(xiàng)目里要接多臺(tái)相機(jī)前面的寫(xiě)法就得優(yōu)化。CameraFinder返回的列表就是天然的并行采集候選你可以為每臺(tái)相機(jī)創(chuàng)建獨(dú)立的采集線程或者用任務(wù)并行。每臺(tái)相機(jī)各開(kāi)各的StreamGrabber互不干擾。多相機(jī)場(chǎng)景下圖像和相機(jī)對(duì)應(yīng)關(guān)系非常重要。簡(jiǎn)單的做法是采集時(shí)把相機(jī)的序列號(hào)或者設(shè)備索引和圖像數(shù)據(jù)打包在一起存到業(yè)務(wù)對(duì)象里。這樣后續(xù)視覺(jué)處理時(shí)才知道當(dāng)前這張圖是哪臺(tái)相機(jī)拍的。再往后如果公司里有多個(gè)品牌的工業(yè)相機(jī)比如Basler、海康、大華混用我建議在業(yè)務(wù)層做一層抽象定義統(tǒng)一的相機(jī)操作接口包含Connect、StartGrab、GetFrame、Close等方法再為每個(gè)品牌寫(xiě)一個(gè)適配實(shí)現(xiàn)。這就是很多團(tuán)隊(duì)在談的“多款工業(yè)相機(jī)SDK封裝”Basler本身在GenICam標(biāo)準(zhǔn)上做得很好你封裝的時(shí)候可以省掉很多廠商定制邏輯。我實(shí)際做過(guò)的項(xiàng)目中這種封裝的最大收益是切換相機(jī)品牌時(shí)視覺(jué)算法層完全不用改只需要換底層適配器。項(xiàng)目初期的設(shè)計(jì)成本多一點(diǎn)但后期維護(hù)省下來(lái)的時(shí)間遠(yuǎn)大于投入。最后再說(shuō)一句個(gè)人體會(huì)這個(gè)項(xiàng)目從標(biāo)題看只是“讀取相機(jī)”四個(gè)字但真把這條鏈路跑通你其實(shí)已經(jīng)把工業(yè)相機(jī)開(kāi)發(fā)的骨架掌握了——設(shè)備枚舉、參數(shù)節(jié)點(diǎn)、觸發(fā)控制、取流緩存、格式轉(zhuǎn)換、異常排查這些能力在大部分視覺(jué)項(xiàng)目里都能復(fù)用。我第一次跑通時(shí)最大的感悟是別急著把代碼堆上去先理解pylon的取流模型再動(dòng)手寫(xiě)遇到問(wèn)題會(huì)順很多。希望這篇內(nèi)容能幫你少踩一些坑。本文還有配套的精品資源點(diǎn)擊獲取