如何在 C# 中修復條碼方向

我需要編寫哪些程式碼來實現自動旋轉功能？

:path=/static-assets/barcode/content-code-examples/how-to/image-orientation-correct-autorotate.cs

using IronBarCode;
using System;

BarcodeReaderOptions myOptionsExample = new BarcodeReaderOptions()
{
    // Turn on auto rotation in ML detection
    AutoRotate = true,
};

var results = BarcodeReader.Read("rotate20.png", myOptionsExample);

// Print out the value
Console.WriteLine(results[0].Value);

自動旋轉功能利用先進的機器學習演算法自動偵測條碼方向。 當處理單一影像中的多個條碼或處理方向各異的大量影像時，這一點尤其有價值。

使用不同的旋轉角度

IronBarcode 的方向校正功能可以無縫處理各種旋轉角度。 以下範例示範如何從不同旋轉角度讀取條碼：

using IronBarCode;
using System;
using System.Collections.Generic;

// Process multiple rotated images
var rotatedImages = new List<string> { "rotate20.png", "rotate45.png", "rotate90.png" };
var options = new BarcodeReaderOptions
{
    AutoRotate = true,
    // Combine with other reading optimizations
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = false
};

foreach (var imagePath in rotatedImages)
{
    var results = BarcodeReader.Read(imagePath, options);
    if (results.Length > 0)
    {
        Console.WriteLine($"Image: {imagePath} - Barcode Value: {results[0].Value}");
        Console.WriteLine($"Barcode Type: {results[0].BarcodeType}");
        Console.WriteLine($"Rotation Applied: {results[0].WasRotated}");
    }
}

using IronBarCode;
using System;
using System.Collections.Generic;

// Process multiple rotated images
var rotatedImages = new List<string> { "rotate20.png", "rotate45.png", "rotate90.png" };
var options = new BarcodeReaderOptions
{
    AutoRotate = true,
    // Combine with other reading optimizations
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = false
};

foreach (var imagePath in rotatedImages)
{
    var results = BarcodeReader.Read(imagePath, options);
    if (results.Length > 0)
    {
        Console.WriteLine($"Image: {imagePath} - Barcode Value: {results[0].Value}");
        Console.WriteLine($"Barcode Type: {results[0].BarcodeType}");
        Console.WriteLine($"Rotation Applied: {results[0].WasRotated}");
    }
}

性能考量

雖然 AutoRotate 預設啟用，但了解其效能影響有助於最佳化條碼讀取工作流程。 此功能可與 IronBarcode 的讀取速度選項有效搭配使用，讓您可以根據應用程式的需求平衡準確性和效能。

對於需要高速處理的應用，您可以將 AutoRotate 與其他最佳化技術結合使用：

var fastReadOptions = new BarcodeReaderOptions
{
    AutoRotate = true,
    Speed = ReadingSpeed.Faster,
    // Specify expected barcode types to improve performance
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128,
    // Define crop region if barcode location is predictable
    CropArea = new System.Drawing.Rectangle(100, 100, 300, 300)
};

var fastReadOptions = new BarcodeReaderOptions
{
    AutoRotate = true,
    Speed = ReadingSpeed.Faster,
    // Specify expected barcode types to improve performance
    ExpectBarcodeTypes = BarcodeEncoding.QRCode | BarcodeEncoding.Code128,
    // Define crop region if barcode location is predictable
    CropArea = new System.Drawing.Rectangle(100, 100, 300, 300)
};

與影像校正功能集成

AutoRotate 與 IronBarcode 的影像校正濾鏡完美相容。 處理品質差且旋轉過的影像時，您可以套用多種校正方法：

var advancedOptions = new BarcodeReaderOptions
{
    AutoRotate = true,
    // Apply additional image corrections
    ImageFilters = new ImageFilterCollection
    {
        new AdaptiveThresholdFilter(),
        new BrightnessFilter(1.2f),
        new ContrastFilter(1.5f)
    }
};

var results = BarcodeReader.Read("low-quality-rotated-barcode.jpg", advancedOptions);

var advancedOptions = new BarcodeReaderOptions
{
    AutoRotate = true,
    // Apply additional image corrections
    ImageFilters = new ImageFilterCollection
    {
        new AdaptiveThresholdFilter(),
        new BrightnessFilter(1.2f),
        new ContrastFilter(1.5f)
    }
};

var results = BarcodeReader.Read("low-quality-rotated-barcode.jpg", advancedOptions);

定向矯正的最佳實踐

1.預設行為：由於 AutoRotate 預設啟用，因此通常不需要明確設置，除非您之前已停用它或想要確保它處於活動狀態。

2.與作物區域結合：當使用作物區域來提高性能時，確保作物區域足夠大，可以容納旋轉的條碼。

3.多執行緒處理：AutoRotate 是執行緒安全的，並且能夠很好地處理非同步和多執行緒操作，因此適用於大批量條碼處理應用程式。

4.格式特定考量：雖然 AutoRotate 適用於所有支援的條碼格式，但某些格式（如 PDF417 和 Data Matrix）可能需要額外的格式特定選項。

在許多情況下，校正旋轉可能不夠，需要使用濾鏡。 請閱讀以下文章"如何使用影像校正濾鏡"來學習如何使用影像濾鏡。