如何使用 C# 從影像中讀取條碼

如何直接從影像中讀取條碼？

以下是如何使用IronBarcode進行條碼讀取。 如需了解有關在 C# / .NET中讀取條碼的全面教程，包括 PDF 處理和批量操作的高級技巧，請訪問我們的詳細指南：

:path=/static-assets/barcode/content-code-examples/how-to/read-barcodes-from-images-1.cs

using IronBarCode;
using System;

var myBarcode = BarcodeReader.Read(@"image_file_path.jpg"); //image file path

foreach (var item in myBarcode)
{
    Console.WriteLine(item.ToString());
}

想知道樣品中的條碼值是什麼嗎？試試這段程式碼片段吧！

要使用IronBarcode ，首先需要做的是透過 Microsoft Visual Studio NuGet套件管理器將IronBarcode庫安裝到您的專案中，如下圖所示。 這將允許您存取 IronBarcode 的 BarcodeReader.Read() 方法，直接讀取條碼影像。

IronBarcode提供了簡單易用的功能，使用者只需使用 BarcodeReader.Read() 即可讀取專案中已包含的映像文件，方法是將檔案名稱字串或檔案路徑字串作為方法的參數。 最佳實踐是在方法中指定檔案路徑時使用字串字面量"@"，以避免在檔案路徑字串中新增多個轉義字元"\"。

在 BarcodeReader.Read() 方法呼叫的末尾附加 Values() 方法，以取得條碼值作為 System.String[] 物件。

若要將結果輸出到控制台，可以使用循環遍歷數組中儲存的值，並在循環區塊內呼叫迭代器變數作為參數的方法。

IronBarcode能夠讀取各種影像格式的一維條碼格式(Codabar, Code128, Code39, Code93, EAN13, Code93, EAN13, EAN18@, @ MSI, UPCA, Aztec, DataMatrix, QRCode)。

如何配置條碼閱讀器選項以獲得更好的效能？

條碼讀取速度太慢？ 圖片中的條碼太小，導致IronBarcode無法讀取嗎？ 只想讀取影像的特定區域？ 想從包含多種條碼的圖像中只讀取特定類型的條碼嗎？ 想提高整體閱讀能力嗎？

BarcodeReaderOptions 允許使用者調整或修改條碼閱讀器的行為，以解決所有這些問題。 有關設定條碼閱讀器選項的詳細範例，請參閱我們的完整指南。以下各節將逐一討論 BarcodeReaderOptions 中所有可調節的屬性。

// Example of setting CropArea
var cropArea = new IronSoftware.Drawing.Rectangle(x: 100, y: 100, width: 300, height: 300);
var options = new BarcodeReaderOptions()
{
    CropArea = cropArea
};

// Example of setting CropArea
var cropArea = new IronSoftware.Drawing.Rectangle(x: 100, y: 100, width: 300, height: 300);
var options = new BarcodeReaderOptions()
{
    CropArea = cropArea
};

// Example: Expect only QR codes and Code128
var options = new BarcodeReaderOptions()
{
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};

// Example: Expect only QR codes and Code128
var options = new BarcodeReaderOptions()
{
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128
};

如何實現具有自訂選項的高級條碼讀取？

現在我們已經了解了用戶可以調整的所有選項，無論是為了提高效能還是準確性，接下來我們將介紹如何在程式碼中應用它們。 以下程式碼片段示範了 BarcodeReaderOptions 的全面用法：

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.");
}

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 中的所有設定。

如果您遇到條碼無法識別的問題，我們的故障排除指南提供了常見問題的解決方案和提高條碼掃描準確性的技巧。