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

Updated: 4 Haziran 2026

IronBarcode, dahili AutoRotate özelliğini kullanarak barkod yönünü otomatik olarak düzeltir ve manuel resim döndürmeye gerek kalmadan herhangi bir açıda barkodları tespit eder ve okur, eğik veya döndürülmüş görüntülerden bile doğru barkod okumanın sağlanmasını garanti eder.

Barkod yönü, bir barkodun bir ürün ya da belge üstüne basılı veya görüntülenmiş olduğu açıyı ifade eder. Çeşitli açıları ayarlayarak farklı yerleşim ve tasarım gereksinimlerine uygun hale getirilebilir. En yaygın yönlendirme, barkodun soldan sağa hizalandığı, standart ve en yaygın kullanılan format olan yatay yönlendirmedir. Sıfır olmayan herhangi bir yönlendirme açısı, kütüphaneler için değeri tespit etme ve alma açısından zorluk teşkil eder. IronBarcode, barkodlar ve QR kodları için sıfır olmayan yönleri tespit etmek amacıyla otomatik yönlendirme düzeltmesi sunar.

Hızlı Başlangıç: Tek satırda otorotasyon görüntü düzeltmesi

İşte yönü nasıl kolayca düzeltebileceğiniz: IronBarcode'un varsayılan olarak etkinleştirilmiş olan AutoRotate seçeneğini kullanarak, resimler döndüğünde bile barkodları doğru bir şekilde okumak için yalnızca bir satır kod.

1Install IronBarcode with NuGet Package Manager
PM > Install-Package BarCode
```
Install-Package BarCode
```

2Bu kod parçacığını kopyalayın ve çalıştırın.

var result = IronBarCode.BarcodeReader.Read("rotatedImage.png", new IronBarCode.BarcodeReaderOptions { AutoRotate = true });

var result = IronBarCode.BarcodeReader.Read("rotatedImage.png", new IronBarCode.BarcodeReaderOptions { AutoRotate = true });

3Canlı ortamınızda test için dağıtım yapın

Ücretsiz deneme ile bugün projenizde IronBarcode kullanmaya başlayın

Asgari İş Akışı (5 adım)

Barkod yönlendirmesini düzeltmek için C# kütüphanesini indirin
AutoRotate özelliğini true olarak ayarlayın
Hedeflenmiş barkodları ve QR kodlarını içe aktarın
Okuma seçeneğiyle barkodları ve QR kodlarını okuyun
Sonuçta ortaya çıkan barkod değerini alın

Uygulama İçerisinde Barkod Yönlendirmesini Nasıl Düzeltirim?

Otomatik yön düzeltmeyi uygulamak için BarcodeReaderOptions içindeki AutoRotate özelliğini true olarak ayarlayın. Bu özellik varsayılan olarak true'dur, bu yüzden bir şey yapmanız gerekmez. Sıfır olmayan yönlendirilmiş bir barkod görüntüsünü okumak, kutudan çıktığı gibi çalışmalıdır.

AutoRotate özelliği, QR kodları, Data Matrix ve geleneksel linear barkodlar da dahil olmak üzere çeşitli barkod formatları ile çalışırken özellikle faydalıdır. İster görüntülerden barkod okuyun ister PDF belgelerinden tarayın, yönlendirme düzeltmesi güvenilir sonuçlar sağlar.

Aşağıdaki görüntüyü örneğimiz olarak kullanalım. Aşağıdaki 20° döndürme ve 45° döndürme örnek görüntülerini indirin.

Yönlendirme testi için saat yönünde 20 derece döndürülmüş, açılı dikey şeritler gösteren barkod

20° Döndürme

Barcode rotated 45 degrees showing diagonal orientation requiring correction

45° Döndürme

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

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

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)

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, barkod yönünü otomatik olarak tespit etmek için gelişmiş makine öğrenimi algoritmalarını kullanır. 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($"Barcode Rotation: {results[0].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($"Barcode Rotation: {results[0].Rotation}");
    }
}

Performans Hususları

AutoRotate varsayılan olarak etkinleştirilmiş olmasına rağmen, performans etkilerini anlamak barkod okuma işlemi iş akışınızı optimize etmeye 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şlem gerektiren uygulamalar için, AutoRotate diğer optimize 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)
}

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 filtreleri ile sorunsuz ç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)

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

Varsayılan Davranış: AutoRotate varsayılan olarak etkin olduğundan, genellikle bunu önceden devre dışı bırakmadıysanız veya etkin olduğundan emin olmak istemiyorsanız açıkça ayarlamanız gerekmez.
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.
Çok İzlekli İşleme: AutoRotate izlek güvenlidir ve async ve çok izlekli işlemler ile iyi çalışır, bu da onu yüksek hacimli barkod işleme uygulamaları için uygun hale getirir.
Formata Özgü Dikkat Edilmesi Gerekenler: AutoRotate tüm desteklenen barkod formatları ile çalışırken, PDF417 ve Data Matrix gibi bazı formatlar ek formata özgü seçeneklerden fayda görebilir.

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."

Sıkça Sorulan Sorular

C# uygulamamda döndürülmüş barkod görüntülerini nasıl düzeltirim?

IronBarcode, yerleşik AutoRotate özelliği ile döndürülmüş barkod görüntülerini otomatik olarak düzeltir. Sadece BarkodReaderOptions'ta AutoRotate'yi true olarak ayarlayın (varsayılan olarak açık) ve kütüphane barkodları manuel döndürme gerektirmeden herhangi bir açıda algılar ve okur.

Hangi barkod yönlendirmeleri otomatik olarak düzeltilebilir?

IronBarcode'un AutoRotate özelliği, 20°, 45°, 90°, 180°, ve 270° döndürmeler dahil olmak üzere sıfır olmayan herhangi bir derece yönlenmesini algılayabilir ve düzeltebilir. Bu özellik QR kodları, Veri Matrisi ve geleneksel lineer barkodlar dahil çeşitli barkod formatları ile çalışır.

Eğimli barkodları ele almak için özel bir kod yazmam gerekiyor mu?

Özel bir kod gerekmez. IronBarcode'un AutoRotate özelliği varsayılan olarak etkinleştirilmiş olduğundan, yönlendirme düzeltmesi kutudan çıktığı gibi çalışır. Sadece bir satır kod yeterlidir: var result = IronBarCode.BarcodeReader.Read("dönmüşImage.png");

Yönlendirme düzeltmesi PDF belgeleri ile çalışabilir mi?

Evet, IronBarcode'un AutoRotate özelliği, PDF belgelerindeki barkodları tararken olduğu kadar görüntülerde de sorunsuz şekilde çalışır. Yönlendirme düzeltmesi, kaynak format ne olursa olsun güvenilir sonuçlar sağlar.

Otomatik yönlenme algılama hangi teknoloji ile güçlendirilmiştir?

IronBarcode, barkod yönlenmesini otomatik olarak algılamak için gelişmiş makine öğrenmesi algoritmaları kullanır. Bu akıllı yaklaşım, elle müdahale olmadan eğimli veya döndürülmüş görüntülerden bile doğru barkod okumayı sağlar.

Is the AutoRotate feature in IronBarcode thread-safe?

Yes, the AutoRotate feature is thread-safe and is compatible with asynchronous and multithreaded operations, making it suitable for high-volume barcode processing applications.

What should I consider when using crop regions with the AutoRotate feature?

When using crop regions with AutoRotate, ensure that the crop area is large enough to accommodate the rotated barcode. This helps improve performance without compromising the accuracy of barcode detection.

Can I improve barcode reading from poor quality images using IronBarcode?

Yes, IronBarcode offers image correction features, such as Adaptive Threshold, Brightness, and Contrast filters, which can be used alongside AutoRotate to improve the reading of poor quality and rotated images.

How does IronBarcode handle different barcode formats with the AutoRotate feature?

IronBarcode's AutoRotate feature supports various barcode formats, including QR codes, Data Matrix, and traditional linear barcodes. For some formats like PDF417, additional format-specific options may enhance readability.

Is there any need to manually activate the AutoRotate feature in IronBarcode?

Typically, there is no need to manually activate the AutoRotate feature as it is enabled by default. You would only need to set it explicitly if it has been previously disabled or if you want to ensure its activation.

Curtis Chau

Mühendislik ekibiyle şimdi sohbet edin

Teknik Yazar

Curtis Chau, Bilgisayar Bilimleri alanında Lisans Derecesine (Carleton Üniversitesi) sahip ve Node.js, TypeScript, JavaScript ve React konularında uzmanlaşmış ön uç geliştirmeyle ilgileniyor. Sezgisel ve estetik açıdan hoş kullanıcı arayüzleri oluşturma tutkunu, Curtis modern çerçevelerle çalışmayı ve iyi yapılandırılmış, görsel olarak çekici kılavuzlar oluşturmayı seviyor.

...

Daha Fazla Oku