如何使用 C# 從影像讀取 BarCode

IronBarcode 在 C# 中使用 BarcodeReader.Read() 只需一行代碼便可從圖像中讀取條碼，支援多種圖像格式，包括 PNG、JPEG、GIF、BMP、TIFF 和 SVG，並提供可自訂的選項以提高效能和精確度。

IronBarcode 的一個關鍵特性是它能夠開箱即用地讀取多種影像格式的條碼。 IronBarcode目前支援以下影像格式：

• 可縮放向量圖形 (SVG)
• 聯合影像專家小組 (JPEG)
• 可攜式網路圖形 (PNG)
• 圖形交換格式 (GIF)
• 標籤影像檔案格式 (TIFF) 點陣圖影像檔（BMP）

This is made possible with the help of our open source library, IronDrawing. 如需 支援的條碼格式（包括一維和二維類型）的完整清單，請查看我們全面的說明文件。

快速入門：幾秒鐘內從圖像中讀取條碼

只需簡單呼叫 IronBarCode.BarcodeReader.Read() 即可直接從 PNG、JPEG、GIF、BMP 和 TIFF 等影像檔案格式中擷取條碼資料。 立即開始使用－無需複雜設置，即可立即見效。

最小工作流程（5 個步驟）

1. 下載用於從映像中讀取條碼的 C# 庫
2. 使用Read方法從各種影像格式讀取條碼值
3. 使用BarcodeReaderOptions類別配置讀取設定
4. 使用CropArea屬性指定影像中的條碼區域
5. 透過設定ExpectBarcodeTypes屬性來指定要讀取的條碼類型。

如何直接從影像讀取 BarCode？ 以下是如何使用 IronBarcode 進行條碼讀取。 有關 [ 在 C# / .NET 中讀取 BarCode](https://ironsoftware.com/csharp/barcode/tutorials/reading-barcodes/) 的全面教學，包括 PDF 處理和批次作業的進階技術，請造訪我們的詳細指南： ```csharp :path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-images-1.cs ```

想知道樣品中的條碼值是什麼嗎？試試這段程式碼片段吧！ 要使用 IronBarcode，首先需要做的是透過 Microsoft Visual Studio NuGet 套件管理器將 IronBarcode 庫安裝到您的專案中，如下圖所示。 這將允許您存取 IronBarcode 的 `BarcodeReader.Read()` 方法來直接讀取條碼影像。 IronBarcode 提供了簡單易用的功能，使用者只需使用`BarcodeReader.Read()`即可讀取專案中已包含的映像文件，只需將**文件名稱**字串或**文件路徑**字串作為該方法的參數即可。 最佳實踐是在方法中指定檔案路徑時使用字串字面量"@"，以避免在檔案路徑字串中新增多個轉義字元"\\"。 在`BarcodeReader.Read()`方法呼叫的末端附加`Values()`方法，以將條碼值作為`System.String[]`物件取得。 若要將結果輸出到控制台，可以使用`foreach`循環遍歷儲存在`string[]`陣列中的值，並在迴圈區塊內呼叫`Console.WriteLine()`方法，並將迭代器變數作為參數。 IronBarcode 能夠讀取一維條碼格式 (`Codabar`, `Code128`, `Code39`, `Code93`, `EAN13`, `EAN18`、`ITF`, `MSI`, `UPCA`, `UPCE`) 以及二維條碼格式 (`Aztec`, `DataMatrix`, `QRCode`) 的各種圖像格式。

如何配置條碼閱讀器選項以獲得更好的性能？ 條碼讀取速度太慢？ 圖片中的條碼是否太小，導致 IronBarcode 無法讀取？ 只想讀取影像的特定區域？ 想從包含多種條碼的圖像中只讀取特定類型的條碼嗎？ 想提高整體閱讀能力嗎？ `BarcodeReaderOptions` 允許使用者調整或調整條碼讀取器的行為，以解決所有這些問題。 有關 [ 設定 BarCode 閱讀器選項](https://ironsoftware.com/csharp/barcode/examples/barcode-reader-settings-csharp/)的詳細範例，請查看我們的綜合指南。以下章節將逐一討論 `BarcodeReaderOptions` 中所有可用的可調整屬性。

如何指定要讀取圖片的哪個區域？ `CropArea`是`BarcodeReaderOptions`中`IronSoftware.Drawing.CropRectangle`類型的屬性，允許使用者指定 IronBarcode 應該讀取的影像區域。 這有助於提高讀取效能，因為條碼讀取器無需掃描整個影像來尋找條碼，同時由於讀取區域已指定，讀取精度也得以提高。 進一步瞭解如何[指定作物區域](https://ironsoftware.com/csharp/barcode/how-to/set-crop-region/)以獲得最佳效能。 要設定`CropArea`屬性，只需實例化新的`Rectangle`類型對象，並將矩形的座標、寬度和長度指定為參數即可。 接受的測量單位為像素 (px)。 ```csharp // Example of setting CropArea var cropArea = new IronSoftware.Drawing.Rectangle(x: 100, y: 100, width: 300, height: 300); var options = new BarcodeReaderOptions() { CropArea = cropArea }; ```

為了加快讀取速度，我應該指定哪些 BarCode 類型？ 預設情況下，IronBarcode 中所有支援的條碼都會以影像形式掃描。 不過，如果使用者知道有哪些類型的條碼可用，或是想要在影像中讀取，設定此屬性為只讀取特定類型的條碼，將可大幅提升讀取效能與精確度，因為條碼讀取器不需要遍歷條碼集合來解釋和讀取條碼。 要使用此屬性，只需將`ExpectBarcodeTypes`設定為`BarcodeEncoding`枚舉的某個欄位即可。 以下是IronBarcode支援的每種條碼類型的範例。 ```csharp // Example: Expect only QR codes and Code128 var options = new BarcodeReaderOptions() { ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128 }; ``` 以下是條碼類型列表，以及前面提供的範例和解釋。

何時應該停用多重條碼讀取？ IronBarcode 預設會掃描影像中所有可用的條碼，包括掃描整個影像檔案並將讀取的條碼值新增至字串陣列中。 但是，如果使用者不希望讀取影像檔案中的多個條碼，使用者可以將此屬性設為**false** ，這樣條碼讀取器在找到條碼值後就會停止掃描。 這將再次提高 IronBarcode 的效能和讀取速度。 有關 [ 讀取多個 BarCode](https://ironsoftware.com/csharp/barcode/how-to/read-multiple-barcodes/) 的詳細資訊，請參閱我們的專用指南。

影像篩選器如何改善條碼辨識？ `BarcodeReaderOptions`可以新增的屬性之一是影像過濾器集合。 影像濾波器對於預處理輸入到 IronBarcode 的原始影像非常重要。 若要套用`BarcodeReaderOptions`中的影像濾鏡，使用者必須先初始化並指定要使用的`ImageFilter`集合。 如需有關 [ 影像修正](https://ironsoftware.com/csharp/barcode/how-to/image-correction/)技術 (包括濾鏡應用程式) 的全面指導，請造訪我們的教學。

如何優化線程以獲得更好的效能？ IronBarcode 讓使用者啟用和調整並行執行緒執行的數量，從而提高處理速度和效率。 並行執行緒是指在不同的處理器核心上同時執行多個執行緒。 IronBarcode 中`MaxParallelThread`屬性的預設值為 4。使用者可以根據機器的性能和資源量進行調整。

我應該啟用多執行緒處理嗎？ 此特性使 IronBarcode 能夠並行讀取多個影像。 `Multithreaded`的預設值為**true** ，因此會自動管理多個線程，以提高批次條碼讀取任務的效能。

為什麼要移除假陽性讀數？ 此屬性可消除所有誤報的條碼讀取結果。 假陽性條碼讀取是指條碼值的錯誤讀取，但卻被辨識為有效。 這可能是由於排序過程中的錯誤，或是條碼標籤或準備過程中的錯誤所造成的。 因此，將`RemoveFalsePositive`設為 true 將消除誤報的條碼讀數，從而提高條碼讀取準確率。 但是，如果使用者為了追求效能而犧牲準確性，則將此屬性設為**false**會有所幫助。此屬性的預設值為**true** 。

哪些掃描模式適用於不同的使用個案？ 定義 IronBarcode 如何掃描和偵測影像中的條碼。 -**自動**：讀取條碼時，會自動進行影像預處理，並配置最佳的讀取器選項。 為獲得最佳效果和性能，建議採用此方法。 - **OnlyDetectionModel** ：掃描影像中的條碼，並傳回其位置的**IronSoftware.Drawing.PointF**陣列。 此模式無法讀取偵測到的條碼； 它只會傳回每個條碼的位置。 - **MachineLearningScan** ：使用機器學習偵測掃描影像中的條碼並讀取它們。 - **OnlyBasicScan** ：讀取條碼，無需機器學習偵測、自動影像預處理或讀取器選項配置。 This option can be used with IronBarCode.Slim alone.

閱讀速度設定如何影響精確度？ 顧名思義， **"速度"**屬性使用戶能夠進一步優化 IronBarcode 閱讀器的效能。 與**RemoveFalsePositive**屬性類似，調整此屬性會降低準確性，但會提高效能。 如需深入瞭解 [讀取速度選項](https://ironsoftware.com/csharp/barcode/how-to/reading-speed-options/)，包括效能基準，請參閱我們的詳細指南。它接受**ReadingSpeed**枚數，共有 4 個等級，如下所示： -**速度更快**：可實現最快的條碼讀取速度，但會降低準確性。 該過程跳過了影像預處理，經常導致條碼結果為空。 僅當輸入影像清晰銳利時才使用此設定。 -**平衡**：**建議**將`Speed`屬性設定為此模式。 它透過嘗試對影像進行輕微處理，使條碼區域更加清晰，從而在準確性和讀取性能之間取得平衡，使條碼讀取器能夠檢測到它。 大多數情況下，這種設定足以讓 IronBarcode 讀取條碼影像並產生準確的輸出。 -**詳細**：如果使用`ReadingSpeed.Balanced`設定無法從讀取中產生條碼值，使用者可以選擇使用`ReadingSpeed.Detailed` 。 IronBarcode 將對影像進行中等處理，以進一步清楚顯示條碼區域，以便條碼閱讀器能夠偵測到條碼。 此設定對於檢測較小或不太清晰的條碼影像非常有用。 - **ExtremeDetail** ：由於此設定會佔用大量 CPU 資源，因此**最不**建議使用。 將對條碼影像進行大量處理，以便閱讀器能夠讀取條碼。 建議使用者在選擇此設定之前，先對影像進行預處理/應用濾鏡。

何時應該使用 Code39 延伸模式？ 此設定允許以擴展模式讀取和解釋 Code39 類型的條碼，其中將套用完整的 ASCII 字元集。 將`UseCode39ExtendedMode`設為**true**將能夠更準確地讀取 Code39 條碼。

如何使用自訂選項實現進階條碼讀取功能？ 現在我們已經瞭解了所有使用者可以調整的選項，不論是為了增加效能或精確度，以下是如何在程式碼中應用這些選項。 下面的程式碼片段展示了 `BarcodeReaderOptions` 的全面用法： ```csharp using IronBarCode; using IronSoftware.Drawing; using System; using System.Linq; // Create custom reader options var options = new BarcodeReaderOptions() { // Specify expected barcode types for better performance ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128 | BarcodeEncoding.Code39, // Define specific area to scan (x, y, width, height in pixels) CropArea = new Rectangle(100, 100, 500, 400), // Set reading speed to balance accuracy and performance Speed = ReadingSpeed.Balanced, // Enable multithreading for better performance Multithreaded = true, MaxParallelThreads = 4, // Remove false positives for accuracy RemoveFalsePositive = true, // Enable Code39 extended mode if needed UseCode39ExtendedMode = true, // Set scan mode ScanMode = BarcodeReaderScanMode.Auto, // Add image filters for better recognition ImageFilters = new ImageFilterCollection() { new SharpenFilter(), new InvertFilter(), new ContrastFilter() } }; // Read barcodes with custom options var results = BarcodeReader.Read(@"C:\path\to\your\barcode-image.png", options); // Process results if (results.Any()) { foreach (var barcode in results) { Console.WriteLine($"Barcode Type: {barcode.BarcodeType}"); Console.WriteLine($"Value: {barcode.Value}"); Console.WriteLine($"Confidence: {barcode.Confidence}%"); Console.WriteLine($"Position: X={barcode.X}, Y={barcode.Y}"); Console.WriteLine("---"); } } else { Console.WriteLine("No barcodes found in the image."); } ``` 從程式碼片段中我們可以看出，要使用`BarcodeReaderOptions`我們必須先對其進行初始化，然後根據上面所述的屬性確定並調整`BarcodeReaderOptions`的屬性。 初始化後的`BarcodeReaderOptions`可以與圖像檔案一起作為參數傳遞給`BarcodeReader.Read()`方法。這樣，從影像中讀取條碼時， `BarcodeReaderOptions`中的所有設定都會被套用。 如果您遇到[條碼無法識別](https://ironsoftware.com/csharp/barcode/troubleshooting/barcode-not-recognized/)的問題，我們的疑難排解指南提供了常見問題的解決方案和提高條碼掃描準確性的技巧。