Cómo corregir la orientación de un código de barras en C

¿Qué código necesito para implementar 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 función AutoRotate utiliza algoritmos avanzados de aprendizaje automático para detectar automáticamente la orientación del código de barras. Esto es especialmente valioso cuando se trabaja con múltiples códigos de barras en una sola imagen o cuando se procesan lotes de imágenes con distintas orientaciones.

Trabajar con diferentes ángulos de rotación

La corrección de orientación de IronBarcode maneja varios ángulos de rotación a la perfección. He aquí un ejemplo que demuestra la lectura de códigos de barras en diferentes ángulos de rotación:

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

Consideraciones sobre el rendimiento

Aunque AutoRotate está habilitado por defecto, entender sus implicaciones de rendimiento ayuda a optimizar el flujo de trabajo de lectura de códigos de barras. La función funciona eficazmente con las opciones de velocidad de lectura de IronBarcode, lo que le permite equilibrar la precisión y el rendimiento en función de las necesidades de su aplicación.

Para aplicaciones que requieren procesamiento de alta velocidad, puedes combinar AutoRotate con otras técnicas de optimización:

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

Integración con funciones de corrección de imágenes

AutoRotate funciona a la perfección con los filtros de corrección de imagen de IronBarcode. Cuando se trata de imágenes de mala calidad que además están giradas, se pueden aplicar múltiples correcciones:

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)

Bestes prácticas para la corrección de orientación

1. Comportamiento Predeterminado: Dado que AutoRotate está habilitado por defecto, normalmente no necesitas configurarlo explícitamente a menos que lo hayas deshabilitado previamente o quieras asegurarte de que esté activo.

2. Combinación con regiones de recorte: Cuando utilice regiones de recorte para mejorar el rendimiento, asegúrese de que el área de recorte es lo suficientemente grande como para acomodar el código de barras rotado.

3. Procesamiento Multihilo: AutoRotate es seguro para múltiples hilos y funciona bien con operaciones asíncronas y multihilo, lo que lo hace apto para aplicaciones de procesamiento de códigos de barras de alto volumen.

4. Consideraciones Específicas de Formato: Aunque AutoRotate funciona con todos los formatos de códigos de barras compatibles, algunos formatos como PDF417 y Data Matrix pueden beneficiarse de opciones adicionales específicas para el formato.

En muchos casos, corregir la rotación puede no ser suficiente, y se requiere un filtro. Aprende a utilizar filtros de imagen en el siguiente artículo: "Cómo usar los filtros de corrección de imágenes."