Barcode Yönlendirmesi C#'da Nasıl Düzeltilir

AutoRotate Özelliğini Uygulamak için Hangi Kodu Kullanmalıyım?

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

AutoRotate özelliği, barcode yönünü otomatik olarak algılamak için gelişmiş makine öğrenme algoritmalarını kullanır. Bu, tek bir görüntüdeki birden fazla barcode ile uğraşırken veya farklı yönlendirmelere sahip görüntülerin toplu işini işlerken özellikle değerlidir.

Farklı Döndürme Açıları ile Çalışma

IronBarcode'un yönlendirme düzeltmesi, çeşitli döndürme açılarını sorunsuz bir şekilde ele alır. İşte farklı döndürme açılarında barcode'ları okumanın gösterildiği bir örnek:

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

Performans Dikkatleri

Varsayılan olarak AutoRotate etkinleştirilmişken, performans etkilerini anlamak barkod okuma iş akışınızı optimize etmenize yardımcı olur. Özellik, IronBarcode'un okuma hızı seçenekleri ile verimli bir şekilde çalışır, uygulamanızın ihtiyaçlarına göre doğruluk ve performans arasında bir denge kurmanıza izin verir.

Yüksek hızlı işlem gerektiren uygulamalar için AutoRotate'yi diğer optimizasyon teknikleri ile birleştirebilirsiniz:

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

Görüntü Düzeltme Özellikleri ile Entegrasyon

AutoRotate, IronBarcode'un görüntü düzeltme filtreleriyle sorunsuz çalışır. Döndürülmüş ve aynı zamanda düşük kaliteli görüntülerle uğraşırken, birden fazla düzeltmeyi uygulayabilirsiniz:

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)

Yönlendirme Düzeltmesi için En İyi Uygulamalar

1. Varsayılan Davranış: AutoRotate varsayılan olarak etkinleştirildiğinden, daha önce devre dışı bırakmadıkça veya etkin olduğundan emin olmak istemediğiniz sürece genellikle açıkça ayarlamanız gerekmez.

2. Kırpma Bölgeleri ile Birleştirme: Performansı artırmak için kırpma bölgelerini kullanırken, kırpma alanının döndürülmüş barcode'u karşılayacak kadar büyük olduğundan emin olun.

3. Çok İşlemli İşleme: AutoRotate, iplik güvenlidir ve yüksek hacimli barcode işleme uygulamaları için uygun hale getirerek eş zamanlı ve çok iş parçacıklı işlemlerle iyi çalışır.

4. Format-Specifik Hususlar: AutoRotate tüm desteklenen barkod formatları ile çalışırken, PDF417 ve Data Matrix gibi bazı formatlar ek format-specifik seçeneklerden fayda sağlayabilir.

Pek çok durumda, döndürmeyi düzeltmek yeterli olmayabilir ve bir filtre gereklidir. Aşağıdaki makaleden resim filtrelerini nasıl kullanacağınızı öğrenin: "Resim Düzeltme Filtrelerini Nasıl Kullanılır."