Jak naprawić orientację kodu kreskowego w C#

Updated: 4 czerwca 2026

IronBarcode automatycznie koryguje orientację kodu kreskowego za pomocą wbudowanej funkcji AutoRotate, która wykrywa i odczytuje kody kreskowe pod każdym kątem bez ręcznej rotacji obrazu, zapewniając dokładne odczytywanie kodów kreskowych nawet z przechylonych lub obróconych obrazów.

Orientacja kodu kreskowego odnosi się do kąta, pod jakim kod kreskowy jest drukowany lub wyświetlany na produkcie lub dokumencie. Można go dostosować do różnych kątów, aby spełniał różne wymagania dotyczące układu i projektu. Najczęstsza orientacja to pozioma, gdzie kod kreskowy jest wyrównany od lewej do prawej, co stanowi standardowy i najbardziej rozpowszechniony format. Dowolna orientacja z kątem różnym od zera stanowi wyzwanie dla bibliotek w kwestii wykrywania i pobierania wartości. IronBarcode oferuje automatyczną korekcję orientacji do wykrywania dowolnych niezerowych orientacji dla kodów kreskowych i kodów QR.

Szybki start: Korekcja orientacji obrazu w jednej linii

Oto jak łatwo możesz skorygować orientację: jedna linia kodu używająca opcji AutoRotate IronBarcode—włączonej domyślnie—aby dokładnie odczytać kody kreskowe nawet, gdy obrazy są obrócone.

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

2Skopiuj i uruchom ten fragment kodu.

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

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

3Wdrożenie do testowania w środowisku produkcyjnym

Rozpocznij używanie IronBarcode w swoim projekcie już dziś z darmową wersją próbną

Minimalny proces (5 kroków)

Pobierz bibliotekę C# do naprawy orientacji kodu kreskowego
Ustaw właściwość AutoRotate na true
Zaimportuj docelowe kody kreskowe i kody QR
Odczytaj kody kreskowe i kody QR przy użyciu opcji odczytu
Pobierz wynikową wartość kodu kreskowego

Jak naprawić orientację kodu kreskowego w mojej aplikacji?

Aby zastosować automatyczną korekcję orientacji, ustaw właściwość AutoRotate w BarcodeReaderOptions na true. Ta właściwość jest domyślnie ustawiona na true, więc nie musisz nic robić. Odczytanie jakiegokolwiek obrazu kodu kreskowego o niezerowej orientacji powinno działać od razu.

Funkcja AutoRotate jest szczególnie przydatna przy pracy z różnymi formatami kodów kreskowych w tym QR code, Data Matrix oraz tradycyjne kody kreskowe liniowe. Niezależnie od tego, czy odczytujesz kody kreskowe z obrazów, czy skanujesz z dokumentów PDF, korekcja orientacji zapewnia niezawodne wyniki.

Użyjmy poniższego obrazu jako naszego przykładu. Pobierz poniższe próbki obrazów z obrotem 20° i 45°.

Kod kreskowy obrócony o 20 stopni zgodnie z ruchem wskazówek zegara, pokazujący pionowe paski pod kątem do testowania orientacji

Obrót 20°

Barcode rotated 45 degrees showing diagonal orientation requiring correction

Obrót 45°

Jakiego kodu potrzebuję, aby wdrożyć AutoRotate?

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)

Funkcja AutoRotate wykorzystuje zaawansowane algorytmy uczenia maszynowego do automatycznego wykrywania orientacji kodu kreskowego. To szczególnie cenne przy pracy z wieloma kodami kreskowymi na jednym obrazie lub przy przetwarzaniu partii obrazów z różnymi orientacjami.

Praca z różnymi kątami obrotu

Korekcja orientacji IronBarcode radzi sobie bezproblemowo z różnymi kątami obrotu. Oto przykład, który pokazuje odczytywanie kodów kreskowych pod różnymi kątami obrotu:

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

Rozważania dotyczące wydajności

Pomimo że AutoRotate jest włączone domyślnie, zrozumienie jego wpływu na wydajność pomoże zoptymalizować twoje przepływy pracy z odczytywaniem kodów kreskowych. Funkcja działa efektywnie z opcjami prędkości odczytu IronBarcode, umożliwiając równoważenie dokładności i wydajności w zależności od potrzeb Twojej aplikacji.

Dla aplikacji wymagających szybkiej obróbki, możesz łączyć AutoRotate z innymi technikami optymalizacji:

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

Integracja z funkcjami korekcji obrazu

AutoRotate działa bez zakłóceń z filtrami korekcji obrazu IronBarcode. W przypadku słabej jakości obrazów, które są również obrócone, można zastosować wiele korekcji:

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)

Najlepsze praktyki dotyczące korekcji orientacji

Zachowanie domyślne: Ponieważ AutoRotate jest domyślnie włączone, zazwyczaj nie musisz go wyraźnie ustawiać, chyba że wcześniej je wyłączyłeś lub chcesz upewnić się, że jest aktywne.
Łączenie z obszarami przycinania: Używając obszarów przycinania w celu poprawy wydajności, upewnij się, że obszar przycinania jest wystarczająco duży, aby pomieścić obrócony kod kreskowy.
Przetwarzanie wielowątkowe: AutoRotate jest bezpieczne dla wątków i dobrze współpracuje z operacjami asynchronicznymi i wielowątkowymi, co czyni je odpowiednim dla aplikacji przetwarzających duże ilości kodów kreskowych.
Rozważania specyficzne dla formatu: Chociaż AutoRotate działa ze wszystkimi obsługiwanymi formatami kodów kreskowych, niektóre formaty jak PDF417 i Data Matrix mogą skorzystać z dodatkowych opcji specyficznych dla formatu.

W wielu przypadkach korekcja obrotu może nie być wystarczająca i wymagany jest filtr. Dowiedz się, jak używać filtrów obrazu w następującym artykułe: "Jak używać filtrów korekcji obrazu."

Często Zadawane Pytania

Jak naprawić obrócone obrazy BarCode w mojej aplikacji C#?

IronBarcode automatycznie koryguje obrócone obrazy kodów kreskowych za pomocą wbudowanej funkcji AutoRotate. Wystarczy ustawić AutoRotate na true w BarcodeReaderOptions (funkcja jest domyślnie włączona), a biblioteka wykryje i odczyta kody kreskowe pod dowolnym kątem bez konieczności ręcznego obracania.

Jakie orientacje BarCodes można automatycznie korygować?

Funkcja AutoRotate w IronBarcode może wykrywać i korygować wszelkie orientacje inne niż zero stopni, w tym obroty o 20°, 45°, 90°, 180° i 270°. Funkcja ta działa z różnymi formatami kodów kreskowych, w tym kodami QR, Data Matrix i tradycyjnymi kodami liniowymi.

Czy muszę pisać specjalny kod, aby obsłużyć pochylone BarCodes?

Nie jest wymagany żaden specjalny kod. Właściwość AutoRotate klasy IronBarcode jest domyślnie włączona, więc korekcja orientacji działa od razu. Wystarczy jedna linijka kodu: var result = IronBarCode.BarcodeReader.Read("rotatedImage.png");

Czy korekcja orientacji działa w przypadku dokumentów PDF?

Tak, funkcja AutoRotate w IronBarcode działa bez zarzutu podczas skanowania kodów kreskowych zarówno z dokumentów PDF, jak i obrazów. Korekcja orientacji zapewnia niezawodne wyniki niezależnie od formatu źródłowego.

Jaka technologia stoi za automatycznym wykrywaniem orientacji?

IronBarcode wykorzystuje zaawansowane algorytmy uczenia maszynowego do automatycznego wykrywania orientacji kodów kreskowych. To inteligentne podejście zapewnia dokładny odczyt kodów kreskowych nawet z przechylonych lub obróconych obrazów bez konieczności ręcznej interwencji.

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

Czat z zespołem inżynierów teraz

Autor tekstów technicznych

Curtis Chau posiada tytuł licencjata z informatyki (Uniwersytet Carleton) i specjalizuje się w front-endowym rozwoju, z ekspertką w Node.js, TypeScript, JavaScript i React. Pasjonuje się tworzeniem intuicyjnych i estetycznie przyjemnych interfejsów użytkownika, Curtis cieszy się pracą z nowoczesnymi frameworkami i tworzeniem dobrze zorganizowanych, atrakcyjnych wizualnie podręczników.

...

Czytaj więcej