Dynamsoft Barkod Okuyucu ve 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 lisans doğrulaması gerektirir, ayar modeli gerçek zamanlı kare işleme için optimize edilmiş zaman aşımı değerlerini içerir ve API, elde taşınan bir kameranın değişken odak ve hareket bulanıklığı koşulları için özel olarak var olan DeblurLevel gibi kavramları ortaya çıkarır:

// Dynamsoft: license server call required at startup
using Dynamsoft.DBR;

// This call contacts Dynamsoft's license server — fails in air-gapped environments
int errorCode = BarcodeReader.InitLicense("YOUR-LICENSE-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.DBR_OK)
    throw new InvalidOperationException($"License validation failed: {errorMsg}");

var reader = new BarcodeReader();

// Settings tuned for camera frame processing
var settings = reader.GetRuntimeSettings();
settings.DeblurLevel = 5;          // compensates for camera motion blur
settings.ExpectedBarcodesCount = 1; // camera focus: one barcode at a time
settings.Timeout = 100;             // 100ms — optimized for 30fps video pipeline
reader.UpdateRuntimeSettings(settings);

// Dynamsoft: license server call required at startup
using Dynamsoft.DBR;

// This call contacts Dynamsoft's license server — fails in air-gapped environments
int errorCode = BarcodeReader.InitLicense("YOUR-LICENSE-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.DBR_OK)
    throw new InvalidOperationException($"License validation failed: {errorMsg}");

var reader = new BarcodeReader();

// Settings tuned for camera frame processing
var settings = reader.GetRuntimeSettings();
settings.DeblurLevel = 5;          // compensates for camera motion blur
settings.ExpectedBarcodesCount = 1; // camera focus: one barcode at a time
settings.Timeout = 100;             // 100ms — optimized for 30fps video pipeline
reader.UpdateRuntimeSettings(settings);

Imports Dynamsoft.DBR

' Dynamsoft: license server call required at startup
' This call contacts Dynamsoft's license server — fails in air-gapped environments
Dim errorCode As Integer = BarcodeReader.InitLicense("YOUR-LICENSE-KEY", errorMsg:=Nothing)
If errorCode <> CType(EnumErrorCode.DBR_OK, Integer) Then
    Throw New InvalidOperationException($"License validation failed: {errorMsg}")
End If

Dim reader As New BarcodeReader()

' Settings tuned for camera frame processing
Dim settings = reader.GetRuntimeSettings()
settings.DeblurLevel = 5          ' compensates for camera motion blur
settings.ExpectedBarcodesCount = 1 ' camera focus: one barcode at a time
settings.Timeout = 100             ' 100ms — optimized for 30fps video pipeline
reader.UpdateRuntimeSettings(settings)

Bu, amacına uygun olarak iyi tasarlanmış bir API'dir. Timeout = 100 ayarı, bir kameradan saniyede 30 kare işliyorsanız ve tek bir kare için 500ms harcayacak durumda değilseniz anlamlıdır. Yüklenen bir PDF'yi işleyen bir sunucu için, 100ms zaman aşımı, hiçbir amaca hizmet etmeyen bir kısıtlama olup, daha yoğun barkodlarda okumaların başarısız olmasına neden olabilir.

Oturum temelli tasarım — new BarcodeReader(), reader.Dispose() — kamera oturum semantiklerini takip eder: bir oturum açar, kareleri işlersiniz, oturumu kapatırsınız. Dosya işlemede, bu yaşam döngüsü, fayda sağlamayan bir şablon ekler.

PDF Sorunu

Dynamsoft Barcode Reader'ın yerel PDF desteği yok. Girdi bir PDF dosyası olduğunda, kodunuzun önce her sayfayı görüntüye render etmesi, sonra o görüntüyü Dynamsoft'a geçmesi gerekir. Bu, ayrı bir PDF render kutuphanesi gerektirir — genellikle PdfiumViewer kullanılır — bu da bir NuGet bağımlılığı, bir yerel ikili bağımlılığı (Windows'ta pdfium.dll veya Linux'ta libpdfium) ve her PDF işlemi etrafında bir render döngüsü ekler:

// Dynamsoft PDF processing — requires PdfiumViewer (external dependency)
// dotnet add package PdfiumViewer
// dotnet add package PdfiumViewer.Native.x86_64.v8-xfa (platform-specific)
using PdfiumViewer;
using System.Drawing.Imaging;
using Dynamsoft.DBR;

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

    using (var pdfDoc = PdfDocument.Load(pdfPath))
    {
        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 Dynamsoft
            TextResult[] barcodes = reader.DecodeFileInMemory(imageBytes, "");
            foreach (var b in barcodes)
                results.Add(b.BarcodeText);
        }
    }

    return results;
}

// Dynamsoft PDF processing — requires PdfiumViewer (external dependency)
// dotnet add package PdfiumViewer
// dotnet add package PdfiumViewer.Native.x86_64.v8-xfa (platform-specific)
using PdfiumViewer;
using System.Drawing.Imaging;
using Dynamsoft.DBR;

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

    using (var pdfDoc = PdfDocument.Load(pdfPath))
    {
        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 Dynamsoft
            TextResult[] barcodes = reader.DecodeFileInMemory(imageBytes, "");
            foreach (var b in barcodes)
                results.Add(b.BarcodeText);
        }
    }

    return results;
}

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

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

    Using pdfDoc = PdfDocument.Load(pdfPath)
        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 Dynamsoft
                    Dim barcodes As TextResult() = reader.DecodeFileInMemory(imageBytes, "")
                    For Each b In barcodes
                        results.Add(b.BarcodeText)
                    Next
                End Using
            End Using
        Next
    End Using

    Return results
End Function

Bu, üç bağımlılık (Dynamsoft, PdfiumViewer ve platforma özgü yerel bir ikili), sayfa başına bir render döngüsü, ve birçok sayfaya sahip belgeler için önemli bir bellek yüküdür.

IronBarcode doğrudan bir PDF dosyasından okuma yapar:

// IronBarcode: PDF is native — no extra library, no render loop
// NuGet: dotnet add package IronBarcode
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 IronBarcode
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 IronBarcode
Dim results = BarcodeReader.Read("invoice.pdf")
For Each result In results
    Console.WriteLine($"{result.Format}: {result.Value}")
Next

Tek arama. PDF yürütücüsü yok. Sayfa başına döngü yok. PDF desteği için platforma özel yerel ikili yok.

Lisans Karmaşıklığı

Çevrimiçi lisans doğrulaması, sunucunun internet erişimi olduğunda basittir. Olmadığında — veya ağ politikaları giden barındırıcıların açık bir şekilde listeye alınmasını gerektirdiğinde — doğrulama başarısızlık yüzeyi alanı büyür:

// Dynamsoft: error code pattern required
int errorCode = BarcodeReader.InitLicense("YOUR-LICENSE-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.DBR_OK)
{
    // Handle: network timeout, license server unreachable, invalid key,
    // expired key, device count exceeded, etc.
    throw new InvalidOperationException($"Dynamsoft license failed [{errorCode}]: {errorMsg}");
}

// Dynamsoft: error code pattern required
int errorCode = BarcodeReader.InitLicense("YOUR-LICENSE-KEY", out string errorMsg);
if (errorCode != (int)EnumErrorCode.DBR_OK)
{
    // Handle: network timeout, license server unreachable, invalid key,
    // expired key, device count exceeded, etc.
    throw new InvalidOperationException($"Dynamsoft license failed [{errorCode}]: {errorMsg}");
}

Imports System

' Dynamsoft: error code pattern required
Dim errorCode As Integer = BarcodeReader.InitLicense("YOUR-LICENSE-KEY", errorMsg:=Nothing)
If errorCode <> CType(EnumErrorCode.DBR_OK, Integer) Then
    ' Handle: network timeout, license server unreachable, invalid key,
    ' expired key, device count exceeded, etc.
    Throw New InvalidOperationException($"Dynamsoft license failed [{errorCode}]: {errorMsg}")
End If

Dynamsoft ile çevrimdışı lisanslama, ayrı bir iş akışı gerektirir. Cihaz UUID'sini almak için BarcodeReader.OutputLicenseToString() çağrısı yaparsınız, o UUID'yi Dynamsoft desteğine cihaz spesifik bir lisans dosyası almak için gönderir, ardından InitLicenseFromLicenseContent kullanarak etkinleştirirsiniz:

// Dynamsoft offline license — device UUID required
string uuid = BarcodeReader.OutputLicenseToString();
// Send uuid to Dynamsoft support → receive licenseContent string
int errorCode = BarcodeReader.InitLicenseFromLicenseContent("YOUR-LICENSE-KEY", licenseContent, uuid, out string errorMsg);

// Dynamsoft offline license — device UUID required
string uuid = BarcodeReader.OutputLicenseToString();
// Send uuid to Dynamsoft support → receive licenseContent string
int errorCode = BarcodeReader.InitLicenseFromLicenseContent("YOUR-LICENSE-KEY", licenseContent, uuid, out string errorMsg);

' Dynamsoft offline license — device UUID required
Dim uuid As String = BarcodeReader.OutputLicenseToString()
' Send uuid to Dynamsoft support → receive licenseContent string
Dim errorCode As Integer = BarcodeReader.InitLicenseFromLicenseContent("YOUR-LICENSE-KEY", licenseContent, uuid, errorMsg)

Kapların geçici ve UUID'lerin her dağıtımda değiştiği bir Docker ortamında, bu sürekli operasyonel çalışmalara yol açar. Her kap başlatıldığında potansiyel olarak yeni bir UUID'nin Dynamsoft desteği ile kayıt edilmesi gerekebilir.

IronBarcode lisans aktivasyonu, yerelde değerlendirilen tek bir atamadır:

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

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

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

Kontrol edilecek hata kodu yok. Ağ bağımlılığı yok. Cihaz-başına kaydı yok. Aynı satır bir geliştirme makinesinde, bir CI/CD hattında, bir Docker konteynerında ve izole edilmiş bir sunucuda çalışır.

Kamera vs Dosya Kullanım Senaryoları

Buradaki dürüst çerçeve, Dynamsoft ve IronBarcode'un farklı birincil senaryolar için optimize edilmiş olmasıdır. Aşağıdaki tablo, bir kütüphaneyi evrensel olarak daha iyi ilan etmek yerine bunu açıkça anlatıyor:

IronBarcode'u Anlamak

IronBarcode, hem barkod oluşturma hem de okuma için bir .NET kütüphanesidir. API statiktir — örnek yok, dispose çağrısı yok, oturum yaşam döngüsü yok. Lisans aktivasyonu yereldir. PDF desteği yerleşiktir:

// NuGet: dotnet add package IronBarcode
using IronBarCode;

// License — local validation, no network call
IronBarCode.License.LicenseKey = "YOUR-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 IronBarcode
using IronBarCode;

// License — local validation, no network call
IronBarCode.License.LicenseKey = "YOUR-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-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)

Oluşturma eşit derecede 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 Eslestirme Referansi

Dynamsoft koduna sahip olan ve kavramların nasıl çevrildiğini anlaması gereken ekipler için:

Takımlar Ne Zaman Geçiş Yapar

Sunucu-tarafı belge işleme, kamera taraması değil. En yaygın göç senaryosu, itibarına dayalı olarak Dynamsoft seçen, entegre eden ve ardından kamera-merkezli API ve PDF eksikliğinin belge işleme iş akışlarını zorlaştırdığını keşfeden bir ekiptir. Bir web uygulamasında yüklenen PDF'lerden barkod okuma, Dynamsoft'ta geçici çözümler gerektiren ancak IronBarcode'da tek bir çağrı olan temel kullanım senaryosudur.

İzole veya kısıtlı ağ ortamları. Finansal kurumlar, sağlık sistemleri ve hükümet dağıtımları genellikle uygulama sunucularından giden internet bağlantılarını yasaklar. Dynamsoft'un çevrimiçi lisans doğrulaması bu ortamlarda başarısız olur. Çevrimdışı cihaz UUID iş akışı işlevseldir ancak destek bağımlılığı yükü ekler. Bu ortamlardaki ekipler genellikle lisans doğrulamanın ağ bileşeni olmadığı için IronBarcode'ye geçer.

Docker ve Kubernetes geçici konteynerlar. Sık sık ölçeklenen kap tabanlı dağıtımlar cihaz tabanlı çevrimdışı lisansı yönetilemez hale getirir. Her yeni konteyner alt yapıya bağlı olarak farklı bir UUID'ye sahip olabilir. IronBarcode'ın lisans anahtarı, her örnek için özel bir kayıt gerektirmeyen standart bir ortam değişkeni olarak çalışır.

Hem oluşturma hem de okuma ihtiyaçı. Dynamsoft sadece-okuma özelliğine sahiptir. Barkod etiketleri oluşturması, ürünler için QR kodları basması veya gömülü barkodlarla sevk manifetoları yaratması gereken uygulamalar, ikinci bir kütüphaneye ihtiyaç duyar. Bu durumdaki ekipler genellikle iki ayrı barkod bağımlılığını yönetmekten kaçınmak için IronBarcode'da birleştirir.

Basitleştirilmiş operasyonel ayak izi. Üretimde yanlış gidebilecek şeylerin sayısını azaltmak için erişilebilir olması gereken dış bağımlılıklar listesinden Dynamsoft lisans sunucusunu, PDF işleme kütüphanesini kaldırmak ve örnek yönetimini statik çağrılarla değiştirmek.

Sonuç

Dynamsoft Barcode Reader, gerçek zamanlı kamera tabanlı barkod taraması, özellikle mobil uygulamalarda, için tasarlanmış yüksek kaliteli bir kütüphanedir. Algoritmalar elde taşınan tarama koşullarına — değişken aydınlatma, hareket bulanıklığı, kısmi örtülme — iyi uyarlanmış. Bu sizin kullanım alanınızsa, Dynamsoft iyi rekabet eder.

Sunucu tarafı belge işleme için — PDF'lerden barkod okuma, barkod etiketleri oluşturma, izole ortamlarda çalışma veya geçici Docker konteynerlerine dağıtım — kütüphanenin mimarisi her adımda sürtünme yaratır. Çevrimiçi lisans doğrulama, eksik PDF desteği, kamera için optimize edilmiş zaman aşımı ayarları ve cihaz UUID çevrimdışı iş akışı, mobil kamera kullanımı için inşa edilmenin sonuçlarıdır. Bunlar hata değil; farklı bir bağlam için kasıtlı tasarım tercihleridir.

IronBarcode belge ve sunucu tarafı bağlam için inşa edilmiştir. Yerel lisans doğrulama, doğal PDF okuma, statik API ve oluşturma desteği tümü birinci sınıf özelliklerdir, geçici çözümler değil. Geçiş kararı, barkodlarınızın hangi ortamda bulunduğuna bağlı.