Como corrigir a orientação do código de barras em C

Que código preciso para implementar o 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)

O recurso AutoRotate utiliza algoritmos avançados de aprendizado de máquina para detectar automaticamente a orientação do código de barras. Isso é especialmente valioso quando se lida com múltiplos códigos de barras em uma única imagem ou ao processar lotes de imagens com orientações variadas.

Trabalhando com diferentes ângulos de rotação

A correção de orientação do IronBarcode lida com vários ângulos de rotação de forma perfeita. Aqui está um exemplo que demonstra a leitura de códigos de barras em diferentes ângulos de rotação:

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

Considerações sobre o desempenho

Embora o código AutoRotate esteja ativado por padrão, entender suas implicações de desempenho ajuda a otimizar seu fluxo de trabalho de leitura de código de barras. O recurso funciona de forma eficiente com as opções de velocidade de leitura do IronBarcode, permitindo equilibrar precisão e desempenho de acordo com as necessidades do seu aplicativo.

Para aplicações que exigem processamento de alta velocidade, você pode combinar AutoRotate com outras técnicas de otimização:

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

Integração com Recursos de Correção de Imagem

AutoRotate funciona perfeitamente com os filtros de correção de imagem do IronBarcode. Ao lidar com imagens de baixa qualidade que também estão rodadas, você pode aplicar várias correções:

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)

Melhores Práticas para Correção de Orientação

1. Comportamento padrão : Como AutoRotate está ativado por padrão, normalmente você não precisa configurá-lo explicitamente, a menos que o tenha desativado anteriormente ou queira garantir que esteja ativo.

2. Combinando com Regiões de Corte: Ao usar regiões de corte para melhorar o desempenho, certifique-se de que a área de corte seja grande o suficiente para acomodar o código de barras rodado.

3. Processamento multithread : AutoRotate é thread-safe e funciona bem com operações assíncronas e multithread, tornando-o adequado para aplicações de processamento de código de barras de alto volume.

4. Considerações específicas do formato : Embora o AutoRotate funcione com todos os formatos de código de barras suportados, alguns formatos, como PDF417 e Data Matrix, podem se beneficiar de opções adicionais específicas do formato.

Em muitos casos, corrigir a rotação pode não ser suficiente e um filtro é necessário. Saiba como usar filtros de imagem no artigo a seguir: "Como usar Filtros de Correção de Imagem."