Barcode Yönünü C# ile Nasıl Düzeltebilirim?

AutoRotate'u Uygulamak İçin Hangi Koda İhtiyacım Var?

: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, gelişmiş makine öğrenimi algoritmalarını kullanarak BarCode'un yönünü otomatik olarak algılar. Bu, tek bir görüntüde birden fazla barkod ile çalışırken veya çeşitli yönlendirmelere sahip görüntü gruplarını 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 işler. Aşağıda farklı döndürme açılarında barkod okuma işlemini gösteren bir örnek var:

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 Hususları

AutoRotate varsayılan olarak etkindir, ancak bunun performans üzerindeki etkilerini anlamak, BARCODE okuma iş akışınızı optimize etmenize yardımcı olur. Özellik, IronBarcode'un okuma hızı seçenekleriyle verimli bir şekilde çalışır ve böylece uygulamanızın ihtiyaçlarına göre doğruluk ve performans arasında denge kurmanıza olanak tanır.

Yüksek hızlı işleme gerektiren uygulamalar için, AutoRotate'yi diğer optimizasyon teknikleriyle 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 bir şekilde çalışır. Düşük kaliteli ve aynı zamanda döndürülmüş görüntülerle çalışırken, çoklu düzeltmeler 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üzeltme İçin En İyi Uygulamalar

1. Varsayılan Davranış: AutoRotate varsayılan olarak etkin olduğundan, daha önce devre dışı bırakmadıysanız veya etkin olduğundan emin olmak istemiyorsanız, genellikle bunu açıkça ayarlamanıza gerek yoktur.

2. Kesme Bölgeleriyle Birleştirme: Performansı artırmak için kesme bölgeleri kullanırken, döndürülmüş barkodu yerleştirmek için kesme alanının yeterince büyük olduğundan emin olun.

3. Çok İş Parçacıklı İşleme: AutoRotate iş parçacığı güvenlidir ve asenkron ve çok iş parçacıklı işlemlerle iyi çalışır, bu da onu yüksek hacimli BARCODE işleme uygulamaları için uygun hale getirir.

4. Formata Özgü Hususlar: AutoRotate, desteklenen tüm BarCode formatlarıyla çalışsa da, PDF417 ve Data Matrix gibi bazı formatlar için formata özgü ek seçenekler faydalı olabilir.

Birçok durumda, döndürmenin düzeltilmesi yeterli olmayabilir ve bir filtre gerekli olabilir. Görüntü filtrelerini kullanmayı şu makalede öğrenin: "Görüntü Düzeltme Filtrelerini Kullanma."