Comment corriger l'orientation d'un BarCode en C

Quel code dois-je utiliser pour mettre en œuvre AutoRotate?

: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);

Imports IronBarCode
Imports System

Private myOptionsExample As New BarcodeReaderOptions() With {.AutoRotate = True}

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

' Print out the value
Console.WriteLine(results(0).Value)

La fonctionnalité AutoRotate utilise des algorithmes avancés d'apprentissage automatique pour détecter automatiquement l'orientation du BARCODE. Cela s'avère particulièrement utile lorsqu'il s'agit de multiples codes-barres dans une seule image ou lorsqu'il s'agit de traiter des lots d'images avec des orientations variables.

Travailler avec différents angles de rotation

La correction d'orientation d'IronBarcode gère divers angles de rotation de manière transparente. Voici un exemple qui démontre la lecture de codes-barres à différents angles de rotation :

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

Imports IronBarCode
Imports System
Imports System.Collections.Generic

' Process multiple rotated images
Dim rotatedImages As New List(Of String) From {"rotate20.png", "rotate45.png", "rotate90.png"}
Dim options As New BarcodeReaderOptions With {
    .AutoRotate = True,
    ' Combine with other reading optimizations
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = False
}

For Each imagePath In rotatedImages
    Dim results = BarcodeReader.Read(imagePath, options)
    If results.Length > 0 Then
        Console.WriteLine($"Image: {imagePath} - Barcode Value: {results(0).Value}")
        Console.WriteLine($"Barcode Type: {results(0).BarcodeType}")
        Console.WriteLine($"Rotation Applied: {results(0).WasRotated}")
    End If
Next

Considérations de performance

Bien que AutoRotate soit activé par défaut, comprendre ses implications en termes de performances permet d'optimiser votre flux de travail de lecture de BarCodes. La fonctionnalité fonctionne efficacement avec les options de vitesse de lecture d'IronBarcode, ce qui vous permet d'équilibrer la précision et la performance en fonction des besoins de votre application.

Pour les applications nécessitant un traitement à haute vitesse, vous pouvez combiner AutoRotate avec d'autres techniques d'optimisation :

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

Dim fastReadOptions As New BarcodeReaderOptions With {
    .AutoRotate = True,
    .Speed = ReadingSpeed.Faster,
    ' Specify expected barcode types to improve performance
    .ExpectBarcodeTypes = BarcodeEncoding.QRCode Or BarcodeEncoding.Code128,
    ' Define crop region if barcode location is predictable
    .CropArea = New System.Drawing.Rectangle(100, 100, 300, 300)
}

Intégration avec les fonctions de correction d'image

AutoRotate fonctionne de manière transparente avec les filtres de correction d'image d'IronBarcode. Lorsque vous avez affaire à des images de mauvaise qualité qui sont également tournées, vous pouvez appliquer plusieurs corrections :

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);

Imports System

Dim advancedOptions As New BarcodeReaderOptions With {
    .AutoRotate = True,
    ' Apply additional image corrections
    .ImageFilters = New ImageFilterCollection From {
        New AdaptiveThresholdFilter(),
        New BrightnessFilter(1.2F),
        New ContrastFilter(1.5F)
    }
}

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

Bonnes pratiques pour la correction de l'orientation

1. Comportement par défaut : Étant donné que AutoRotate est activé par défaut, vous n'avez généralement pas besoin de le définir explicitement, sauf si vous l'avez désactivé précédemment ou si vous souhaitez vous assurer qu'il est bien actif.

2. Combinaison avec les régions de recadrage : Lorsque vous utilisez des régions de recadrage pour améliorer les performances, assurez-vous que la zone de recadrage est suffisamment grande pour accueillir le code-barres pivoté.

3. Traitement multithread : AutoRotate est thread-safe et fonctionne bien avec les opérations asynchrones et multithread, ce qui le rend adapté aux applications de traitement de BarCodes à haut volume.

4. Considérations spécifiques au format : bien que AutoRotate fonctionne avec tous les formats de BARCODEs pris en charge, certains formats tels que PDF417 et Data Matrix peuvent bénéficier d'options supplémentaires spécifiques au format.

Dans de nombreux cas, corriger la rotation peut ne pas être suffisant, et un filtre est requis. Apprenez à utiliser les filtres d'image dans l'article suivant : "Comment utiliser les filtres de correction d'image."