Jak naprawić orientację kodu kreskowego w C
IronBarcode automatycznie koryguje orientację kodu kreskowego dzięki wbudowanej funkcji AutoRotate, która wykrywa i odczytuje kody kreskowe pod dowolnym kątem bez ręcznego obracania obrazu, zapewniając dokładne odczytywanie kodów nawet z przekrzywionych 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 z wykorzystaniem opcji AutoRotate IronBarcode — domyślnie włączonej — do dokładnego odczytywania kodów kreskowych, nawet gdy obrazy są obrócone.
-
Install IronBarcode with NuGet Package Manager
PM > Install-Package BarCode -
Skopiuj i uruchom ten fragment kodu.
var result = IronBarCode.BarcodeReader.Read("rotatedImage.png", new IronBarCode.BarcodeReaderOptions { AutoRotate = true }); -
Wdroż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
- Set the `AutoRotate` property to 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 kodami QR, Data Matrix i tradycyjnymi liniowymi kodami kreskowymi. 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. Download the following 20° rotation and 45° rotation sample images.
Obrót 20°
Obrót 45°
Jakiego kodu potrzebuję, aby wdrożyć 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)
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($"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
Rozważania dotyczące wydajności
Chociaż AutoRotate jest domyślnie włączone, zrozumienie jego wpływu na wydajność pomoże zoptymalizować Twój przepływ 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 szybkiego przetwarzania można połą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)
}
Integracja z funkcjami korekcji obrazu
AutoRotate działa bezproblemowo 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)
Najlepsze praktyki dotyczące korekcji orientacji
-
Domyślne zachowanie: Ponieważ
AutoRotatejest domyślnie włączone, zazwyczaj nie musisz go eksplicytnie ustawzać, chyba że wyłączyłeś je wcześniej 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 bezpieczny w użyciu z wątków i dobrze współpracuje z operacjami asynchronicznymi i wielowątkowymi, dzięki czemu jest odpowiedni dla aplikacji przetwarzających duże ilości kodów kreskowych.
- Rozważania specyficzne dla formatu: Chociaż
AutoRotatedziała ze wszystkimi obsługiwanymi formatami kodów kreskowych, niektóre formaty, takie jak PDF417 i Data Matrix, mogą wymagać 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 artykule: "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.

