Wymagania dotyczące specyfikacji typu

Metoda BarcodeScanner.Scan() w Spire.Barcode nie posiada przeciążenia przyjmującego tylko scieżkę do pliku. Każda operacja odczytu wymaga, aby kod wywołujący zadeklarował format kodu kreskowego z wyprzedzeniem. W przypadku przepływów pracy opartych na jednym formacie jest to wykonalne, ale w przypadku przetwarzania dokumentów o mieszanych formatach powoduje to pętlę iteracji kandydatów:

// Spire.Barcode: multi-format detection iterates through candidate types
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

// Spire.Barcode: multi-format detection iterates through candidate types
BarcodeScanner scanner = new BarcodeScanner();
var candidates = new[] { BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417 };

string foundValue = null;
foreach (var type in candidates)
{
    string[] found = scanner.Scan("barcode.png", type);
    if (found.Length > 0)
    {
        foundValue = found[0];
        break;
    }
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim candidates = {BarCodeType.Code128, BarCodeType.QRCode, BarCodeType.DataMatrix, BarCodeType.EAN13, BarCodeType.PDF417}

Dim foundValue As String = Nothing
For Each type In candidates
    Dim found As String() = scanner.Scan("barcode.png", type)
    If found.Length > 0 Then
        foundValue = found(0)
        Exit For
    End If
Next

Każdy typ dodany do tablicy kandydatów oznacza dodatkowy przebieg skanowania. Wszelkie formaty nieobecne na liście są pomijane bez powiadomienia. Programista jest odpowiedzialny za prowadzenie wyczerpującego wykazu typów oraz ponowne testowanie za każdym razem, gdy do procesu wprowadzany jest nowy format.

Szczegółowe porównanie funkcji

Podejście Spire.BarCode

Metoda BarcodeScanner.Scan() w Spire.Barcode wymaga na każdej wywołaniu parametru BarCodeType. Wywołanie typu pojedynczego jest właściwe, gdy format jest znany i zagwarantowany:

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

foreach (string value in results)
{
    Console.WriteLine(value);
}

// Spire.Barcode — type is mandatory
BarcodeScanner scanner = new BarcodeScanner();
string[] results = scanner.Scan("barcode.png", BarCodeType.Code128);

foreach (string value in results)
{
    Console.WriteLine(value);
}

Imports Spire.Barcode

Dim scanner As New BarcodeScanner()
Dim results As String() = scanner.Scan("barcode.png", BarCodeType.Code128)

For Each value As String In results
    Console.WriteLine(value)
Next

Gdy format nie jest znany z góry, jedynym dostępnym podejściem jest iteracja przez typy kandydujące. Każda iteracja to pełne skanowanie, a każdy format nieobecny na liście jest pomijany bez powiadomienia. Wynik to string[], który nie przekazuje żadnych informacji o typie, więc dalsze kierowanie na podstawie formatu wymaga dodatkowego zarządzania stanem przez wywołującego.

Podejście IronBarcode

Metoda BarcodeReader.Read() w IronBarcode nie wymaga parametru typu. Biblioteka automatycznie wykrywa format we wszystkich obsługiwanych symbolikach w jednym przebiegu. Odczyt BARCODE-ów z obrazów to pojedyncze wywołanie metody, niezależnie od tego, ile różnych formatów może zawierać źródło:

// IronBarcode: automatic format detection
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

// IronBarcode: automatic format detection
var results = BarcodeReader.Read("barcode.png");

foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

Imports IronBarCode

' IronBarcode: automatic format detection
Dim results = BarcodeReader.Read("barcode.png")

For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

Każdy obiekt wynikowy zawiera Format, Value oraz metadane dotyczące pozycji. Trasowanie w dół oparte na formacie nie wymaga dodatkowego stanu — typ jest obecny w samym wyniku.

Spire.BarCode Free Tier

FreeSpire.BarCode umieszcza duży znak wodny z informacją o wersji na wygenerowanych obrazach kodów kreskowych. Znak wodny zakrywa BARCODE w sposób, który sprawia, że nie nadaje się on do użytku produkcyjnego i uniemożliwia rzetelną ocenę jakości generowania. Wydajność skanowania jest celowo obniżona w wersji darmowej, co oznacza, że pomiary przepustowości wykonane podczas oceny nie odzwierciedlają rzeczywistej wydajności komercyjnej wersji Spire.BARCODE. Pakiet darmowy wymaga również klucza rejestracyjnego uzyskanego od E-iceblue, zanim okna dialogowe z ostrzeżeniami zostaną wyłączone podczas działania. Zestaw symboli dostępny w wersji bezpłatnej stanowi podzbiór oferty komercyjnej. Ograniczenia te łącznie oznaczają, że ocena oparta na FreeSpire.BarCode nie odzwierciedla dokładnie tego, co oferuje produkt komercyjny.

Tryb próbny IronBarcode

Wersja próbna IronBarcode to pakiet licencyjny używany bez klucza licencyjnego. Aplikacja Reading działa z pełną prędkością, obsługując wszystkie symbole i bez żadnych ograniczeń w działaniu. Opcje szybkości czytania i dokładności działają identycznie w trybie próbnym i licencjonowanym. Wygenerowany BARCODE w trybie próbnym zawiera niewielki znak wodny na krawędzi obrazu; nie zasłania samego kodu kreskowego. Zachowanie mierzone podczas oceny IronBarcode jest tym samym zachowaniem, które trafia do produkcji.

Podejście Spire.BarCode

Spire.BarCode nie posiada wbudowanej funkcji odczytu plików PDF. Aby wyodrębnić kody kreskowe z pliku PDF, programista musi zainstalować oddzielny pakiet Spire.PDF, zakupić oddzielną licencję Spire.PDF oraz napisać ręczny kod iteracji stron i ekstrakcji obrazów przed rozpoczęciem skanowania kodów kreskowych:

// Spire.Barcode + Spire.PDF: separate package and license required
using Spire.Pdf;

var pdf = new PdfDocument();
pdf.LoadFromFile("document.pdf");

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required for each scan call
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

// Spire.Barcode + Spire.PDF: separate package and license required
using Spire.Pdf;

var pdf = new PdfDocument();
pdf.LoadFromFile("document.pdf");

var scanner = new BarcodeScanner();
foreach (PdfPageBase page in pdf.Pages)
{
    var images = page.ExtractImages();
    foreach (var image in images)
    {
        // BarCodeType is still required for each scan call
        string[] results = scanner.Scan(image, BarCodeType.QRCode);
    }
}

Imports Spire.Pdf

Dim pdf As New PdfDocument()
pdf.LoadFromFile("document.pdf")

Dim scanner As New BarcodeScanner()
For Each page As PdfPageBase In pdf.Pages
    Dim images = page.ExtractImages()
    For Each image In images
        ' BarCodeType is still required for each scan call
        Dim results As String() = scanner.Scan(image, BarCodeType.QRCode)
    Next
Next

Ten wzorzec wymaga dwóch pakietów NuGet, dwóch umów licencyjnych oraz kodu do zarządzania stronami napisanego przez programistów. Jeśli BarCodes są osadzone w treści wektorowej, a nie w obrazach rastrowych w pliku PDF, metoda wyodrębniania obrazów może je całkowicie pominąć.

Podejście IronBarcode

IronBarcode obsługuje pliki PDF natywnie, bez żadnych dodatkowych zależności. Odczytywanie kodów kreskowych z dokumentów PDF to jedno wywołanie metody wykorzystujące to samo API BarcodeReader.Read() używane dla plików obrazów. Numery stron są zawarte w każdym obiekcie wyniku:

// IronBarcode: native PDF reading from the same Read() method
var results = BarcodeReader.Read("document.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}");
}

// IronBarcode: native PDF reading from the same Read() method
var results = BarcodeReader.Read("document.pdf");

foreach (var barcode in results)
{
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}");
}

Imports IronBarcode

' IronBarcode: native PDF reading from the same Read() method
Dim results = BarcodeReader.Read("document.pdf")

For Each barcode In results
    Console.WriteLine($"Page {barcode.PageNumber}: {barcode.Format} = {barcode.Value}")
Next

Nie jest wymagane ręczne wyodrębnianie stron, dodatkowy pakiet ani zakup dodatkowej licencji.

Podejście Spire.BarCode

Model generacji w Spire.Barcode opiera się na zmiennym obiekcie konfiguracyjnym BarcodeSettings. Programista inicjuje ustawienia, przypisuje indywidualne wlasciwości, przekazuje obiekt ustawień do BarCodeGenerator, następnie wywołuje GenerateImage():

// Spire.Barcode generation
using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "12345678";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("barcode.png", ImageFormat.Png);

// Spire.Barcode generation
using Spire.Barcode;

BarcodeSettings settings = new BarcodeSettings();
settings.Type = BarCodeType.Code128;
settings.Data = "12345678";
settings.ShowText = true;
settings.TextMargin = 5;
settings.BarHeight = 60;
settings.Unit = GraphicsUnit.Pixel;

BarCodeGenerator generator = new BarCodeGenerator(settings);
Image barcodeImage = generator.GenerateImage();
barcodeImage.Save("barcode.png", ImageFormat.Png);

Imports Spire.Barcode
Imports System.Drawing
Imports System.Drawing.Imaging

Dim settings As New BarcodeSettings()
settings.Type = BarCodeType.Code128
settings.Data = "12345678"
settings.ShowText = True
settings.TextMargin = 5
settings.BarHeight = 60
settings.Unit = GraphicsUnit.Pixel

Dim generator As New BarCodeGenerator(settings)
Dim barcodeImage As Image = generator.GenerateImage()
barcodeImage.Save("barcode.png", ImageFormat.Png)

Obiekt ustawień, który może ulegać zmianom, oznacza, że konfiguracje mogą być przypadkowo udostępniane między wywołaniami, gdy pojedyncza instancja jest ponownie wykorzystywana w wielu operacjach generowania. Klasa generatora dodaje dodatkowy etap instancjonowania, który nie zawiera własnej logiki konfiguracyjnej.

Podejście IronBarcode

IronBarcode wykorzystuje statyczną metodę fabryczną z opcjonalnym łańcuchem płynnym. Nie ma obiektu ustawień ani instancji generatora do zarządzania:

//IronBarcode generation
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

//IronBarcode generation
using IronBarCode;

BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .SaveAsPng("barcode.png");

// With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("barcode.png");

Imports IronBarCode

' IronBarcode generation
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .SaveAsPng("barcode.png")

' With sizing:
BarcodeWriter.CreateBarcode("12345678", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("barcode.png")

Kody QR z niestandardowymi logo są dostępne we wszystkich poziomach licencji IronBarcode:

var qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-with-logo.png");

var qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest);
qr.AddBrandLogo("logo.png");
qr.SaveAsPng("qr-with-logo.png");

Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
qr.AddBrandLogo("logo.png")
qr.SaveAsPng("qr-with-logo.png")

Przetwarzanie dokumentów o mieszanym formacie

Zespoły, które zaczynają od jednego znanego formatu BARCODE, często zauważają, że z czasem różnorodność formatów BARCODE rośnie. Aplikacja magazynowa, która zaczynała od etykiet Code128, może otrzymywać dostawy od dostawców korzystających z kodów DataMatrix, GS1-128 lub QR. Każdy nowy format wprowadzony do przepływu pracy wymaga aktualizacji tablicy kandydatów w pętli odgadywania typu, ponownego przetestowania logiki wykrywania oraz potwierdzenia, że żaden istniejący format nie został wyparowany przez kolejność iteracji. Kiedy różnorodność formatów osiąga punkt, w którym nakłady na utrzymanie tej pętli stają się powtarzającym się kosztem rozwoju, zespoły oceniają, czy automatyczne wykrywanie całkowicie wyeliminowałoby to obciążenie.

Integracja z PDF

W aplikacjach obsługujących duże ilości dokumentów często zdarza się, że BarCodes muszą być wyodrębniane z plików PDF, a nie z pojedynczych obrazów. W przepływie pracy Spire.BarCode przejście to wymaga nabyćia licencji Spire.PDF, zintegrowania drugiego pakietu oraz napisania infrastruktury do iteracji stron i wyodrębniania obrazów, zanim będzie można przystąpić do odczytu kodów kreskowych. Zespoły, które nie przewidziały tego wymogu przy początkowym zakupie, muszą teraz zarządzać dwiema licencjami na produkty i dwoma interfejsami API w celu wykonania zadania, które koncepcyjnie należy do odczytu kodów kreskowych. Odkrycie, że obsługa plików PDF wymaga osobnego zakupu, jest częstym powodem ponownej oceny wyboru produktu.

Ograniczenia dotyczące bezpłatnego poziomu

Zespoły, które przetestowały FreeSpire.BarCode, a następnie zakupiły licencję komercyjną, czasami zgłaszają, że produkt komercyjny zachowuje się inaczej niż sugerowały to wyniki testów. Jest to zamierzone działanie: bezpłatna wersja celowo obniża wydajność odczytu i ogranicza zestaw symboli, co oznacza, że testy porównawcze i testy pokrycia formatów przeprowadzone podczas oceny nie mają zastosowania w przypadku wdrożenia komercyjnego. Kiedy zespół odkrywa tę rozbieżność po zakupie, często szuka alternatyw, których zachowanie w wersji próbnej jest reprezentatywne dla zachowania w środowisku produkcyjnym.

Zmniejszenie liczby produktów

Organizacje, które standaryzują swój stos technologiczny, czasami identyfikują Spire.BarCode jako jeden z elementów rosnącego asortymentu produktów E-iceblue, z których każdy ma własny koszt licencji i cykl odnowienia. Jeśli głównym motorem działania Spire.BarCode jest odczytywanie kodów kreskowych w ramach procesu przetwarzania dokumentów — a nie głęboka integracja z Spire.Doc lub Spire.XLS — zespoły oceniają, czy pojedyncza, samodzielna biblioteka kodów kreskowych zmniejszyłaby zarówno złożoność licencjonowania, jak i zakres wsparcia technicznego.

Usunięcie parametru BarCodeType

Każde wywołanie scanner.Scan() w kodzie Spire.Barcode niesie argument BarCodeType. Zastąpienie tych wywołań przez BarcodeReader.Read() całkowicie usuwa parametr typu. Pętle zgadywane przez typ — foreach bloki, które przechodzą przez wartość kandydującą BarCodeType — mogą być w pełni usunięte; pojedyncze wywołanie BarcodeReader.Read() zastępuje całą pętlę.

Aktualizacja typu zwracanej wartości

Metoda Scan() w Spire.Barcode zwraca string[].IronBarcode zwraca kolekcję BarcodeResults. Miejsca wywołań, które przypisują się do string[] albo przekazują wyniki do metod oczekujących tego typu, wymagają aktualizacji. Wyodrębnianie wartości jako tablicy wykorzystuje .Select(r => r.Value).ToArray(); dostęp do pierwszego wyniku jest możliwy przez .First()?.Value.

Usunięcie pakietu Spire.PDF

Jeśli Spire.PDF zostal zainstalowany wyłącznie do wsparcia ekstrakcji kodów kreskowych z plików PDF, to może być usunięty po migracji do IronBarcode. Wszystkie importy using Spire.Pdf; oraz bloki ręcznej iteracji stron są zastępowane przez pojedyncze wywołanie BarcodeReader.Read("file.pdf"). Jeśli Spire.PDF jest używany do innych operacji na dokumentach niż ekstrakcja kodów kreskowych, to warto go zachować, a jedynie zastąpić ścieżki kodu związane z kodami kreskowymi.

Zmiany w przestrzeni nazw

Zastąp using Spire.Barcode; przez using IronBarCode;. Enum BarCodeType jest zastępowany przez BarcodeEncoding do generacji i nie wymaga odpowiednika do odczytu. Inicjalizacja licencji zmienia się z Spire.License.LicenseProvider.SetLicenseKey() na pojedyncze przypisanie wlasciwosci IronBarCode.License.LicenseKey podczas uruchamiania aplikacji.