Dynamsoft Barkod Okuyucu vs IronBarcode: C# Barkod Kütüphanesi Karşılaştırması

Dynamsoft Barcode Reader'ı Anlamak

Dynamsoft'un mimarisi kamera kökenini yansıtır. Başlangıç dizisi çevrimiçi bir lisans aktivasyonu gerektirir, ayar modeli, gerçek zamanlı kare işleme için uygun zaman aşımı değerlerini içerir ve API, elde taşınabilir kameranın değişken odak ve hareket bulanıklığı koşullarına ayarlı ayarları açığa çıkarır:

// Dynamsoft: license activation required at startup
using Dynamsoft.CVR;
using Dynamsoft.DBR;
using Dynamsoft.License;
using Dynamsoft.Core;

// LicenseManager.InitLicense performs an online activation on first run
int errorCode = LicenseManager.InitLicense("YOUR-DYNAMSOFT-LICENSE-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.EC_OK)
    throw new InvalidOperationException($"License activation failed: {errorMsg}");

using var router = new CaptureVisionRouter();

// Settings tuned for camera frame processing
SimplifiedCaptureVisionSettings settings = router.GetSimplifiedSettings(
    PresetTemplate.PT_READ_BARCODES);
settings.BarcodeSettings.ExpectedBarcodesCount = 1; // single barcode per frame
settings.Timeout = 100;                              // 100ms suits a 30fps pipeline
router.UpdateSettings(PresetTemplate.PT_READ_BARCODES, settings);

// Dynamsoft: license activation required at startup
using Dynamsoft.CVR;
using Dynamsoft.DBR;
using Dynamsoft.License;
using Dynamsoft.Core;

// LicenseManager.InitLicense performs an online activation on first run
int errorCode = LicenseManager.InitLicense("YOUR-DYNAMSOFT-LICENSE-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.EC_OK)
    throw new InvalidOperationException($"License activation failed: {errorMsg}");

using var router = new CaptureVisionRouter();

// Settings tuned for camera frame processing
SimplifiedCaptureVisionSettings settings = router.GetSimplifiedSettings(
    PresetTemplate.PT_READ_BARCODES);
settings.BarcodeSettings.ExpectedBarcodesCount = 1; // single barcode per frame
settings.Timeout = 100;                              // 100ms suits a 30fps pipeline
router.UpdateSettings(PresetTemplate.PT_READ_BARCODES, settings);

Imports Dynamsoft.CVR
Imports Dynamsoft.DBR
Imports Dynamsoft.License
Imports Dynamsoft.Core

' Dynamsoft: license activation required at startup

' LicenseManager.InitLicense performs an online activation on first run
Dim errorCode As Integer = LicenseManager.InitLicense("YOUR-DYNAMSOFT-LICENSE-KEY", errorMsg:=Nothing)
If errorCode <> CType(EnumErrorCode.EC_OK, Integer) Then
    Throw New InvalidOperationException($"License activation failed: {errorMsg}")
End If

Using router As New CaptureVisionRouter()

    ' Settings tuned for camera frame processing
    Dim settings As SimplifiedCaptureVisionSettings = router.GetSimplifiedSettings(PresetTemplate.PT_READ_BARCODES)
    settings.BarcodeSettings.ExpectedBarcodesCount = 1 ' single barcode per frame
    settings.Timeout = 100                              ' 100ms suits a 30fps pipeline
    router.UpdateSettings(PresetTemplate.PT_READ_BARCODES, settings)
End Using

Bu amacı için iyi tasarlanmış bir API'dır. Timeout = 100 ayarı, bir kameradan saniyede 30 kare işlediğinizde ve tek bir karede 500ms harcayamayacağınızda mantıklıdır. Yüklenen bir PDF'yi işleyen bir sunucu için, 100ms zaman aşımı işe yaramaz ve daha yoğun barkodlarda okumaların başarısız olmasına sebep olabilir.

Yönlendirici ve oturum tasarımı — new CaptureVisionRouter(), router.Dispose() — kamera oturumu semantiklerini takip eder: bir yönlendirici açarsınız, kareler işlersiniz, atarsınız. Dosya işleme için, bu yaşam döngüsü yararı olmayan gereksiz kod ekler.

PDF Sorunu

Dynamsoft Barcode Reader bazı PDF girdilerini doğrudan Windows yapılarında kabul edebilir, ancak çapraz platform dağıtımları için birçok ekip hala her PDF sayfasını CaptureVisionRouter.Capture'ye geçmeden önce bir resme önceden çevirir. Bu genellikle ayrı bir PDF işleme kütüphanesini — yaygın olarak PdfiumViewer kullanılır — entegre eder, bu da bir NuGet bağımlılığı, platforma özel yerel bir binary bağımlılığı (Windows'da pdfium.dll veya Linux'ta libpdfium) ve her PDF işlemi etrafında bir render döngüsü ekler:

// Dynamsoft PDF processing — typical cross-platform pattern with PdfiumViewer
// dotnet add package PdfiumViewer
using PdfiumViewer;
using System.Drawing.Imaging;
using Dynamsoft.CVR;
using Dynamsoft.DBR;

public List<string> ReadBarcodesFromPdf(string pdfPath)
{
    var results = new List<string>();

    using (var pdfDoc = PdfDocument.Load(pdfPath))
    using (var router = new CaptureVisionRouter())
    {
        for (int page = 0; page < pdfDoc.PageCount; page++)
        {
            // Render each page at 300 DPI
            using var image = pdfDoc.Render(page, 300, 300, true);
            using var ms = new MemoryStream();
            image.Save(ms, ImageFormat.Png);
            byte[] imageBytes = ms.ToArray();

            // Now pass rendered image bytes to the Capture Vision Router
            CapturedResult result = router.Capture(imageBytes,
                PresetTemplate.PT_READ_BARCODES);
            foreach (var item in result.GetDecodedBarcodesResult().GetItems())
                results.Add(item.GetText());
        }
    }

    return results;
}

// Dynamsoft PDF processing — typical cross-platform pattern with PdfiumViewer
// dotnet add package PdfiumViewer
using PdfiumViewer;
using System.Drawing.Imaging;
using Dynamsoft.CVR;
using Dynamsoft.DBR;

public List<string> ReadBarcodesFromPdf(string pdfPath)
{
    var results = new List<string>();

    using (var pdfDoc = PdfDocument.Load(pdfPath))
    using (var router = new CaptureVisionRouter())
    {
        for (int page = 0; page < pdfDoc.PageCount; page++)
        {
            // Render each page at 300 DPI
            using var image = pdfDoc.Render(page, 300, 300, true);
            using var ms = new MemoryStream();
            image.Save(ms, ImageFormat.Png);
            byte[] imageBytes = ms.ToArray();

            // Now pass rendered image bytes to the Capture Vision Router
            CapturedResult result = router.Capture(imageBytes,
                PresetTemplate.PT_READ_BARCODES);
            foreach (var item in result.GetDecodedBarcodesResult().GetItems())
                results.Add(item.GetText());
        }
    }

    return results;
}

Imports PdfiumViewer
Imports System.Drawing.Imaging
Imports Dynamsoft.CVR
Imports Dynamsoft.DBR
Imports System.IO

Public Function ReadBarcodesFromPdf(pdfPath As String) As List(Of String)
    Dim results As New List(Of String)()

    Using pdfDoc = PdfDocument.Load(pdfPath)
        Using router = New CaptureVisionRouter()
            For page As Integer = 0 To pdfDoc.PageCount - 1
                ' Render each page at 300 DPI
                Using image = pdfDoc.Render(page, 300, 300, True)
                    Using ms As New MemoryStream()
                        image.Save(ms, ImageFormat.Png)
                        Dim imageBytes As Byte() = ms.ToArray()

                        ' Now pass rendered image bytes to the Capture Vision Router
                        Dim result As CapturedResult = router.Capture(imageBytes, PresetTemplate.PT_READ_BARCODES)
                        For Each item In result.GetDecodedBarcodesResult().GetItems()
                            results.Add(item.GetText())
                        Next
                    End Using
                End Using
            Next
        End Using
    End Using

    Return results
End Function

Bu, üç bağımlılığın (Dynamsoft, PdfiumViewer ve platforma özel yerel bir binary), sayfa başına bir render döngüsü ve sayfa sayısıyla ölçeklenen bellek yükü oluşturur.

IronBarcode doğrudan bir PDF dosyasından okur:

// IronBarcode: PDF is native — no extra library, no render loop
// NuGet: dotnet add package BarCode
var results = BarcodeReader.Read("invoice.pdf");
foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

// IronBarcode: PDF is native — no extra library, no render loop
// NuGet: dotnet add package BarCode
var results = BarcodeReader.Read("invoice.pdf");
foreach (var result in results)
{
    Console.WriteLine($"{result.Format}: {result.Value}");
}

Imports IronBarCode

' IronBarcode: PDF is native — no extra library, no render loop
' NuGet: dotnet add package BarCode
Dim results = BarcodeReader.Read("invoice.pdf")
For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

Tek bir çağrı. PDF renderine ihtiyaç yok. Sayfa başına döngü yok. PDF desteği için platforma özgü yerel bir ikili yok.

Lisans Karmaşıklığı

Sunucunun internet erişimi olduğunda çevrimiçi lisans aktivasyonu basittir. Olmadığında — veya ağ politikaları dışa doğru ev sahiplerinin açıkça beyaz listeye alınmasını gerektirdiğinde — doğrulama başarısızlık yüzeyi büyür:

// Dynamsoft: error code pattern required
int errorCode = LicenseManager.InitLicense("YOUR-DYNAMSOFT-LICENSE-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.EC_OK)
{
    // Possible causes: network timeout, license server unreachable,
    // invalid key, expired key, activation quota exceeded, etc.
    throw new InvalidOperationException($"Dynamsoft license failed [{errorCode}]: {errorMsg}");
}

// Dynamsoft: error code pattern required
int errorCode = LicenseManager.InitLicense("YOUR-DYNAMSOFT-LICENSE-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.EC_OK)
{
    // Possible causes: network timeout, license server unreachable,
    // invalid key, expired key, activation quota exceeded, etc.
    throw new InvalidOperationException($"Dynamsoft license failed [{errorCode}]: {errorMsg}");
}

Imports System

' Dynamsoft: error code pattern required
Dim errorCode As Integer = LicenseManager.InitLicense("YOUR-DYNAMSOFT-LICENSE-KEY", errorMsg)
Dim errorMsg As String
If errorCode <> CType(EnumErrorCode.EC_OK, Integer) Then
    ' Possible causes: network timeout, license server unreachable,
    ' invalid key, expired key, activation quota exceeded, etc.
    Throw New InvalidOperationException($"Dynamsoft license failed [{errorCode}]: {errorMsg}")
End If

Dynamsoft ile çevrimdışı lisanslama ayrı bir iş akışıdır. Bağlantılı bir makinede, bir lisans paketi almak için başlangıçta çevrimiçi bir aktivasyon gerçekleştirilir, saklanır ve ardından bu paketi InitLicenseFromLicenseContent üzerinden tekrar oynatarak çevrimdışı makine aktive edilir:

// Dynamsoft offline license — replay a pre-fetched license bundle
int errorCode = LicenseManager.InitLicenseFromLicenseContent(
    licenseContent, out string errorMsg);
if (errorCode != (int)EnumErrorCode.EC_OK)
    throw new InvalidOperationException($"Offline activation failed: {errorMsg}");

// Dynamsoft offline license — replay a pre-fetched license bundle
int errorCode = LicenseManager.InitLicenseFromLicenseContent(
    licenseContent, out string errorMsg);
if (errorCode != (int)EnumErrorCode.EC_OK)
    throw new InvalidOperationException($"Offline activation failed: {errorMsg}");

Imports System

' Dynamsoft offline license — replay a pre-fetched license bundle
Dim errorCode As Integer = LicenseManager.InitLicenseFromLicenseContent(licenseContent, errorMsg)
Dim errorMsg As String = Nothing
If errorCode <> CType(EnumErrorCode.EC_OK, Integer) Then
    Throw New InvalidOperationException($"Offline activation failed: {errorMsg}")
End If

Bu yolla elde edilen lisans paketlerinin bir sona erme penceresi (genellikle günler ila bir yıl) vardır ve süreleri dolmadan önce yenilenmeleri gerekir, bu da bir bağlı makinenin iş akışına periyodik olarak katılması gerektiği anlamına gelir.

IronBarcode lisans etkinleştirmesi yerel olarak değerlendirilen tek bir atama:

// IronBarCode: local validation, no network required
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// IronBarCode: local validation, no network required
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

' IronBarCode: local validation, no network required
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

Kontrol edilecek hata kodu yok. Ağ bağımlılığı yok. Hiçbir lisans-paketi yenileme döngüsü yok. Aynı satır, bir geliştirme makinesinde, bir CI/CD çalışmasında, bir Docker konteynerında ve izole bir sunucuda çalışır.

Kamera vs Dosya Kullanım Durumları

Dynamsoft ve IronBarcode farklı birincil senaryolar için optimize edilmiştir. Aşağıdaki tablo, bu durumu evrensel olarak daha iyi bir kütüphane ilan etmek yerine açıklar:

IronBarcode Anlama

IronBarcode hem barkod üretimi hem de okuma için bir .NET kütüphanesidir. API statiktir — örnek yok, imha çağrısı yok, oturum yaşam döngüsü yok. Lisans etkinleştirmesi yereldir. PDF desteği dahili olarak sağlanmıştır:

// NuGet: dotnet add package BarCode
using IronBarCode;

// License — local validation, no network call
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Read from an image file
var results = BarcodeReader.Read("label.png");
foreach (var result in results)
    Console.WriteLine($"{result.Format}: {result.Value}");

// Read from a PDF — native, no extra library
var pdfResults = BarcodeReader.Read("manifest.pdf");

// Read with options for high-accuracy or high-throughput scenarios
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
   MaxParallelThreads= 4
};
var multiResults = BarcodeReader.Read("multi-barcode-sheet.png", options);

// NuGet: dotnet add package BarCode
using IronBarCode;

// License — local validation, no network call
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY";

// Read from an image file
var results = BarcodeReader.Read("label.png");
foreach (var result in results)
    Console.WriteLine($"{result.Format}: {result.Value}");

// Read from a PDF — native, no extra library
var pdfResults = BarcodeReader.Read("manifest.pdf");

// Read with options for high-accuracy or high-throughput scenarios
var options = new BarcodeReaderOptions
{
    Speed = ReadingSpeed.Balanced,
    ExpectMultipleBarcodes = true,
   MaxParallelThreads= 4
};
var multiResults = BarcodeReader.Read("multi-barcode-sheet.png", options);

Imports IronBarCode

' License — local validation, no network call
IronBarCode.License.LicenseKey = "YOUR-LICENSE-KEY"

' Read from an image file
Dim results = BarcodeReader.Read("label.png")
For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

' Read from a PDF — native, no extra library
Dim pdfResults = BarcodeReader.Read("manifest.pdf")

' Read with options for high-accuracy or high-throughput scenarios
Dim options As New BarcodeReaderOptions With {
    .Speed = ReadingSpeed.Balanced,
    .ExpectMultipleBarcodes = True,
    .MaxParallelThreads = 4
}
Dim multiResults = BarcodeReader.Read("multi-barcode-sheet.png", options)

Üretim de aynı şekilde basittir:

// Generate Code 128
BarcodeWriter.CreateBarcode("SHIP-7734-X", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("shipping-label.png");

// Generate QR with error correction and embedded logo
QRCodeWriter.CreateQrCode("https://track.example.com/7734", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .AddBrandLogo("company-logo.png")
    .SaveAsPng("tracking-qr.png");

// Get bytes for HTTP response
byte[] bytes = BarcodeWriter.CreateBarcode("ITEM-001", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .ToPngBinaryData();

// Generate Code 128
BarcodeWriter.CreateBarcode("SHIP-7734-X", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .SaveAsPng("shipping-label.png");

// Generate QR with error correction and embedded logo
QRCodeWriter.CreateQrCode("https://track.example.com/7734", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest)
    .AddBrandLogo("company-logo.png")
    .SaveAsPng("tracking-qr.png");

// Get bytes for HTTP response
byte[] bytes = BarcodeWriter.CreateBarcode("ITEM-001", BarcodeEncoding.Code128)
    .ResizeTo(400, 100)
    .ToPngBinaryData();

Imports System

' Generate Code 128
BarcodeWriter.CreateBarcode("SHIP-7734-X", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .SaveAsPng("shipping-label.png")

' Generate QR with error correction and embedded logo
QRCodeWriter.CreateQrCode("https://track.example.com/7734", 500, QRCodeWriter.QrErrorCorrectionLevel.Highest) _
    .AddBrandLogo("company-logo.png") _
    .SaveAsPng("tracking-qr.png")

' Get bytes for HTTP response
Dim bytes As Byte() = BarcodeWriter.CreateBarcode("ITEM-001", BarcodeEncoding.Code128) _
    .ResizeTo(400, 100) _
    .ToPngBinaryData()

Özellik Karşılaştırması

API Eşleme Başvurusu

Dynamsoft kodu olan ve kavramların nasıl çeviri yapıldığını anlaması gereken ekipler için:

Takımlar Geçiş Yaptığında

Sunucu tarafı belge işleme, kamera taraması değil. En yaygın geçiş senaryosu, itibar temelinde Dynamsoft'u seçen, entegre eden ve ardından kamera merkezli API ve PDF işleme adımının belge işleme iş akışlarını uygunsuz hale getirdiğini keşfeden bir takımdır. Web uygulamasında yüklenen PDF'lerden barkod okuma, Dynamsoft'ta ekstra işlem gerektiren ancak IronBarcode'da tek bir çağrı olan temel bir kullanım örneğidir.

İzole veya sınırlı ağ ortamları. Finansal kurumlar, sağlık sistemleri ve hükümet konuşlandırmaları genellikle uygulama sunucularından dışa doğru internet bağlantılarını yasaklar. Dynamsoft'un çevrimiçi etkinleştirmesi, çevrimdışı lisans paketi iş akışı olmadan bu ortamlarda çalışmaz, bu da operasyonel adımlar ekler. Bu ortamlardaki ekipler, özel lisans doğrulamasında ağ bileşeni olmadığı için sıklıkla IronBarcode'a geçiş yaparlar.

Docker ve Kubernetes geçici konteynerler. Sık sık ölçeklenen konteyner tabanlı dağıtımlar, yinelenen lisans paketi yenilemelerini yönetmeyi zorlaştırır. IronBarcode'un lisans anahtarı, örneğe bağlı kayıt olmaksızın standart bir ortam değişkeni olarak çalışır.

Okumanın yanı sıra üretim ihtiyacı.Dynamsoft Barcode Readerpaketi sadece okuyucudur. Barkod etiketleri üretmesi, ürünler için QR kodları yazdırması veya gömülü barkodlarla gönderi manifestoları oluşturması gereken uygulamalar ikinci bir kütüphane gerektirir. Bu durumda olan ekipler, iki ayrı barkod bağımlılığı yönetimini önlemek için genellikle IronBarcode'a konsolide olur.

Basitleştirilmiş operasyonel ayak izi. Dynamsoft lisans sunucusunu erişilmesi gereken dış bağımlılıklar listesinden kaldırmak, PDF işleme kütüphanesini çıkarmak ve yönlendirici yaşam döngüsü yönetimini statik çağrılarla değiştirmek, üretimde yanlış gidebilecek şeylerin sayısını azaltır.

Sonuç

Dynamsoft Barcode Reader, özellikle mobil uygulamalarda, gerçek zamanlı kamera tabanlı barkod tarama için tasarlanmış yüksek kaliteli bir kütüphanedir. Algoritmalar, elde taşınan taramalar için değişken aydınlatma, hareket bulanıklığı ve kısmi örtülme koşulları için iyi ayarlanmıştır. Eğer bu kullanım durumunuzsa, Dynamsoft iyi rekabet eder.

Sunucu tarafı belge işleme için — PDF'lerden barkod okuma, barkod etiketleri oluşturma, izole ortamlarda çalıştırma veya Docker geçici konteynerlerinde dağıtma — kitaplığın mimarisi, her adımda daha fazla kurulum gerektiriyor. Çevrimiçi lisans etkinleştirme, çapraz platform PDF işleme deseni, kameraya optimize edilmiş zaman aşımı ayarları ve çevrimdışı lisans paketi iş akışı, mobil kamera kullanımı için oluşturmanın sonuçlarıdır. Bunlar hata değildir; farklı bir bağlam için kasıtlı tasarım seçimleridir.

IronBarcode, belge ve sunucu tarafı bağlamı için inşa edilmiştir. Yerel lisans doğrulama, yerel PDF okuma, statik API ve üretim desteği, çalışmak için çözümler yerine birinci sınıf özelliklerdir. Karar, barkodlarınızın gerçekten hangi ortamda yaşadığına bağlıdır.