IronBarcode 操作指南 指定裁剪區域 如何在 C# 中定義條碼裁切區域以加快讀取速度</#35;。 Hairil Hasyimi Bin Omar 更新:2026年1月10日 下載 IronBarcode NuGet 下載 DLL 下載 開始免費試用 法學碩士副本 法學碩士副本 將頁面複製為 Markdown 格式,用於 LLMs 在 ChatGPT 中打開 請向 ChatGPT 諮詢此頁面 在雙子座打開 請向 Gemini 詢問此頁面 在 Grok 中打開 向 Grok 詢問此頁面 打開困惑 向 Perplexity 詢問有關此頁面的信息 分享 在 Facebook 上分享 分享到 X(Twitter) 在 LinkedIn 上分享 複製連結 電子郵件文章 This article was translated from English: Does it need improvement? Translated View the article in English 使用 IronSoftware.Drawing.Rectangle 定義裁切區域,將 IronBarcode 的掃描區域限制在特定的圖像區域,顯著提高條碼讀取性能,並通過只集中在相關區域來減少錯誤。 <! -- --> <!--說明:說明程式碼概念的圖表或截圖 --> IronBarcode 中最重要的功能之一是指定 裁剪區域的能力。 此功能可讓 IronBarcode 使用 IronSoftware.Drawing.Rectangle 物件,僅讀取影像中 Crop Region 所指定的特定條碼或區域。 使用此功能不僅能減少閱讀錯誤,還能提升閱讀效能。 此技術在處理 多頁文件或條碼位置可預測的高解析度影像時特別有價值。 在處理具有多個 BarCode 或複雜背景的影像時,定義裁切區域對於優化您的 條碼讀取速度變得至關重要。 透過限制掃描區域,您可以達到比掃描整個影像快 5 倍的處理速度,同時也能減少非 BarCode 元素所造成的誤判。 快速入門:定義和應用作物區域以更快地讀取條碼 只需幾秒鐘即可建立裁剪矩形並將其匯入 IronBarcode—無需額外設置,操作便捷。 了解使用BarcodeReaderOptions將掃描範圍限制在特定影像區域是多麼容易。 立即開始使用 NuGet 建立 PDF 檔案: 使用 NuGet 套件管理器安裝 IronBarcode PM > Install-Package BarCode 複製並運行這段程式碼。 var results = IronBarCode.BarcodeReader.Read("image.png", new IronBarCode.BarcodeReaderOptions { CropArea = new IronSoftware.Drawing.Rectangle(x: 50, y: 100, width: 300, height: 150) }); 部署到您的生產環境進行測試 立即開始在您的專案中使用 IronBarcode,免費試用! 免費試用30天 ### 最小工作流程(5 個步驟) 下載用於讀取條碼的 C# 庫 在影像中尋找裁剪區域的座標和大小 從座標創建裁剪區域 使用Read方法偵測並讀取條碼 將裁剪區域物件傳遞給方法 如何在影像中找出裁切區域座標和大小? <! -- --> --> <!--說明:說明程式碼概念的圖表或截圖 --> 有許多方法可以找出影像中某一點的座標。 一種方法是使用電腦上的 Paint 應用程式載入圖片。 若要取得裁切區域的第一個座標,請將遊標移到首選的第一個位置,即Rectangle的左上角,然後從螢幕左下角的應用程式取得 x、y 座標。 然後,找出第二個點,即Rectangle的右下角。 請參考下圖以便更清楚地理解。 對於更進階的情況,您也可以考慮使用 GIMP 或 Photoshop 等影像編輯軟體,這些軟體提供精確的像素座標和測量工具。 有些開發人員偏好使用線上座標搜尋工具,或建立簡單的 HTML/JavaScript 公用程式,在影像懸停時顯示滑鼠座標。 設定作物區域參考 我可以使用哪些工具來確定座標? 然後可以將座標值用作Rectangle物件的屬性。 物體的寬度可以定義為x2 - x1 ,高度可以定義為y2 - y1 。 在處理 BarCode 影像時,必須瞭解坐標從左上角 (0,0) 開始,並隨著向右 (x 軸) 和向下 (y 軸) 移動而增加。 幾種坐標判定方法包括 內建作業系統工具:Windows 繪圖、macOS 預覽 瀏覽器開發工具:檢查網路影像上的元素 專業軟體:Adobe Photoshop、GIMP 自訂公用程式:簡單的座標檢視器應用程式 IronBarcode的調試功能:匯出處理過的影像與座標覆蓋圖 如何從座標計算矩形尺寸? 有了兩個角點之後,計算尺寸就很簡單了。 矩形需要四個參數:x 座標、y 座標、寬度和高度。 以下是如何正確實作裁切區域: :path=/static-assets/barcode/content-code-examples/how-to/set-crop-region-instantiate-CropRegion.cs using IronBarCode; int x1 = 62; int y1 = 29; int x2 = 345; int y2 = 522; IronSoftware.Drawing.Rectangle crop1 = new IronSoftware.Drawing.Rectangle(x: x1, y: y1, width: x2-x1, height: y2-y1); Imports IronBarCode Private x1 As Integer = 62 Private y1 As Integer = 29 Private x2 As Integer = 345 Private y2 As Integer = 522 Private crop1 As New IronSoftware.Drawing.Rectangle(x:= x1, y:= y1, width:= x2-x1, height:= y2-y1) $vbLabelText $csharpLabel 此坐標系統可與 IronBarcode 的圖像修正功能無縫配合,讓您只需在圖像的特定區域套用濾鏡。 如何套用 CropRegion 和讀取 BarCode? 一旦您定義了您想要 IronBarcode 讀取的 CropRegions,您可以將此物件套用到 BarcodeReaderOptions 中,作為其中一個屬性,以及其他設定。 然後可以將其用作BarcodeReader.Read()方法中的參數。 以下程式碼片段展示了這個過程: BarcodeReaderOptions 接受哪些參數? BarcodeReaderOptions 類提供條碼讀取過程的全面控制。 除了作物區之外,您還可以設定: 速度最佳化:使用速度設定在精確度和效能之間取得平衡 條碼類型:指定要搜尋的確切格式 (支援的格式) 影像濾鏡:針對偏斜或損壞的 BarCode 套用修正功能 多執行緒:啟用平行處理以獲得更佳效能 旋轉處理:自動偵測旋轉的 BarCode 如何處理來自一個裁剪區域的多個 BarCode 結果? 當掃描包含多個條碼的裁切區域時,IronBarcode 會返回一個結果集合。 每個結果都包含寶貴的元資料,包括作物區域內的確切位置、條碼類型和解碼值。 以下是如何實施全面的作物區域處理: :path=/static-assets/barcode/content-code-examples/how-to/set-crop-region-apply-CropRegion.cs using IronBarCode; using System; int x1 = 62; int y1 = 29; int x2 = 345; int y2 = 522; IronSoftware.Drawing.Rectangle crop1 = new IronSoftware.Drawing.Rectangle(x: x1, y: y1, width: x2 - x1, height: y2 - y1); BarcodeReaderOptions options = new BarcodeReaderOptions() { CropArea = crop1 }; var result = BarcodeReader.Read("sample.png", options); foreach (var item in result) { Console.WriteLine(item.Value); } Imports IronBarCode Imports System Private x1 As Integer = 62 Private y1 As Integer = 29 Private x2 As Integer = 345 Private y2 As Integer = 522 Private crop1 As New IronSoftware.Drawing.Rectangle(x:= x1, y:= y1, width:= x2 - x1, height:= y2 - y1) Private options As New BarcodeReaderOptions() With {.CropArea = crop1} Private result = BarcodeReader.Read("sample.png", options) For Each item In result Console.WriteLine(item.Value) Next item $vbLabelText $csharpLabel 從上面的程式碼片段中,我們使用了BarcodeReaderOptions物件中實例化的Rectangle作為CropArea屬性。 然後,我們將此BarcodeReaderOptions物件作為BarcodeReader.Read()方法的參數,將 CropArea 套用至映像並讀取其中的條碼。 進階作物區域技術 對於生產應用程式,請考慮這些進階策略: 1.動態裁剪區域:根據文件範本或 OCR 結果計算裁切區域 2.多重區域:在單一影像中處理多個裁切區域,以進行複雜的佈局 3.效能最佳化:結合裁切區域與 async 處理,以獲得最大的吞吐量 4.錯誤處理:當在預期的區域找不到 BarCode 時,實施後備策略 在處理 PDF 文件時,您可以將裁切區域套用至特定頁面,大幅縮短大型檔案的處理時間。 這對於發票、運送標籤或條碼位置標準化的表格特別有用。 作物區域定義的最佳實務 為了讓作物區的效益最大化: 加入襯墊:在預期的 BarCode 位置周圍加入 10-20 像素,以顧及細微的差異。 徹底測試:驗證裁剪區域在整個文件集中的工作情況 文件座標:為您的應用程式保留一份常見作物區域的參考表 考慮縮放比例:考慮不同的影像解析度或 DPI 設定 監控效能:追蹤處理時間以驗證作物區域的效能 對於需要 容錯的應用程式,請執行兩段式方法:先掃描裁切區域,如果在預期的區域內找不到條碼,則退回到全圖像掃描。 結論 定義裁切區域是優化 .NET 應用程式中 BarCode 讀取效能的強大技術。 透過將掃描範圍限制在特定區域,您可以大幅提升速度,同時減少誤報。 無論您是處理 單一影像或批次作業,裁切區域都能提供生產環境所需的精準度和效能。 常見問題解答 什麼是 BarCode 裁切區域,為什麼要使用它? 條碼裁剪區域是 IronBarcode 在圖像中集中掃描的特定區域。通過使用IronSoftware.Drawing.Rectangle定義裁剪區域,您可以實現高達5倍的條碼讀取速度,同時通過限制掃描到您圖像的相關區域來減少錯誤。 如何定義條碼讀取的裁切區域? 您可以在 IronBarcode 中定義一個裁切區域,方法是建立一個具有特定座標 (x, y) 和尺寸 (寬度, 高度) 的 IronSoftware.Drawing.Rectangle 物件,然後在呼叫讀取方法時將其傳給 BarcodeReaderOptions.CropArea 屬性。 使用裁剪區域可望改善哪些效能? 與掃描整個圖像相比,IronBarcode 的裁剪區域功能可將條碼讀取性能提高 5 倍。這在處理多頁文件或條碼位置可預測的高解析度影像時尤其有利。 如何找到我的作物區域的正確坐標? 您可以使用 Microsoft Paint、GIMP 或 Photoshop 等影像編輯軟體找出裁切區域座標。只需開啟您的圖像,將游標移至所需區域的左上角,記下 x,y 坐標,然後尋找右下角坐標,即可確定 IronBarcode 中 Rectangle 的寬度和高度。 何時使用作物區特別有利? IronBarcode 中的裁剪區域在處理具有多個條碼的圖像、複雜背景、多頁文件或條碼位置一致且可預測的高解析度圖像時尤其有價值。 Hairil Hasyimi Bin Omar 立即與工程團隊聊天 軟體工程師 就像所有優秀的工程師一樣,Hairil 也是一位狂熱的學習者。他不斷精進 C#、Python 和 Java 的知識,利用這些知識為整個 Iron Software 的團隊成員增加價值。Hairil 從馬來西亞的 Universiti Teknologi MARA 大學加入 Iron Software 團隊,畢業於該校的化學與流程工程學系,並取得學士學位。 準備好開始了嗎? Nuget 下載 2,070,733 | 版本: 2026.2 剛剛發布 免費 NuGet 下載 總下載量:2,070,733 查看許可證