Dynamsoft Barcode Reader vs IronBarcode : Comparaison de la bibliothèque de codes-barres C#

Comprendre le lecteur de codes-barres Dynamsoft

L'architecture de Dynamsoft reflète son origine dans le domaine des appareils photo. La séquence de démarrage nécessite une validation de licence en ligne, le modèle de paramétrage inclut des valeurs de temporisation optimisées pour le traitement des images en temps réel, et l'API expose des concepts tels que DeblurLevel qui existent spécifiquement pour les conditions de mise au point variable et de flou de mouvement d'une caméra portable :

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

Il s'agit d'une API bien conçue pour son usage. Le paramètre Timeout = 100 est utile lorsque vous traitez 30 images par seconde à partir d'une caméra et que vous ne pouvez pas vous permettre de consacrer 500 ms à une seule image. Pour un serveur traitant un PDF téléchargé, un délai d'attente de 100 ms est une contrainte inutile qui peut entraîner des échecs de lecture sur les codes-barres plus denses.

La conception basée sur les instances - new BarcodeReader(), reader.Dispose()- suit la sémantique des sessions de caméra : vous ouvrez une session, traitez les cadres, fermez la session. Pour le traitement des fichiers, ce cycle de vie ajoute du code répétitif sans avantage.

Le problème du PDF

Dynamsoft Barcode Reader ne prend pas en charge nativement le format PDF. Lorsque l'entrée est un fichier PDF, votre code doit d'abord convertir chaque page en image, puis transmettre cette image à Dynamsoft. Cela nécessite une bibliothèque de rendu PDF distincte — PdfiumViewer est couramment utilisée — qui ajoute une dépendance NuGet , une dépendance binaire native (pdfium.dll sous Windows ou libpdfium sous Linux) et une boucle de rendu autour de chaque opération PDF :

// 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

Cela implique trois dépendances (Dynamsoft, PdfiumViewer et un binaire natif spécifique à la plateforme), une boucle de rendu par page et une surcharge mémoire importante pour les documents comportant de nombreuses pages.

IronBarcode lit directement à partir d'un fichier PDF :

// 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

Un seul appel. Aucun lecteur PDF. Pas de boucle par page. Pas de binaire natif spécifique à la plateforme pour la prise en charge des fichiers PDF.

Complexité de la licence

La validation des licences en ligne est simple lorsque le serveur a accès à Internet. Lorsque ce n'est pas le cas — ou lorsque les politiques réseau exigent l'autorisation explicite des hôtes sortants — la surface d'échec de la validation augmente :

// 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

L'octroi de licences hors ligne avec Dynamsoft nécessite un flux de travail distinct. Vous appelez BarcodeReader.OutputLicenseToString() pour récupérer l'UUID de l'appareil, envoyez cet UUID au support Dynamsoft pour recevoir un fichier de licence spécifique à l'appareil, puis activez en utilisant InitLicenseFromLicenseContent :

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

Dans un environnement Docker où les conteneurs sont éphémères et où les UUID changent à chaque déploiement, cela crée un travail opérationnel continu. Chaque lancement de conteneur peut nécessiter un nouvel UUID enregistré auprès du support Dynamsoft.

L'activation de la licence Code-barres IronBarcode est une tâche unique évaluée localement :

// 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"

Aucun code d'erreur à vérifier. Aucune dépendance au réseau. Aucune inscription par appareil. Cette même ligne fonctionne sur une machine de développement, un pipeline CI/CD, un conteneur Docker et un serveur isolé du réseau.

Cas d'utilisation de l'appareil photo et des fichiers

En toute honnêteté, il faut savoir que Dynamsoft et Code-barres IronBarcode sont optimisés pour des scénarios principaux différents. Le tableau ci-dessous illustre clairement cela plutôt que de déclarer une bibliothèque universellement meilleure :

Comprendre IronBarcode

IronBarcode est une bibliothèque .NET permettant à la fois de générer et de lire des codes-barres. L'API est statique — pas d'instances, pas d'appels de suppression, pas de cycle de vie de session. L'activation de la licence est locale. La prise en charge des fichiers PDF est intégrée :

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

La génération est tout aussi simple :

// 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()

Comparaison des fonctionnalités

Référence de mappage d'API

Pour les équipes qui utilisent du code Dynamsoft et qui ont besoin de comprendre comment les concepts se traduisent :

Quand les équipes changent

Traitement de documents côté serveur, et non numérisation par appareil photo. Le scénario de migration le plus fréquent est celui d'une équipe ayant choisi Dynamsoft pour sa réputation, l'ayant intégré, puis ayant constaté que l'API centrée sur la prise en charge des appareils photo et le manque de compatibilité avec les PDF rendaient les flux de travail de traitement de documents complexes. La lecture des codes-barres à partir de PDF téléchargés dans une application Web est un cas d'utilisation fondamental qui nécessite des solutions de contournement dans Dynamsoft, mais qui se résume à un seul appel dans IronBarcode.

Environnements réseau isolés ou restreints. Les institutions financières, les systèmes de santé et les déploiements gouvernementaux interdisent souvent les connexions Internet sortantes depuis les serveurs d'applications. La validation des licences en ligne de Dynamsoft échoue dans ces environnements. Le flux de travail UUID hors ligne des appareils est fonctionnel, mais il ajoute une surcharge liée à la dépendance au support. Dans ces environnements, les équipes migrent souvent vers Code-barres IronBarcode précisément parce que la validation des licences ne comporte aucun composant réseau.

Docker et Kubernetes : conteneurs éphémères. Les déploiements conteneurisés où les instances augmentent et diminuent fréquemment rendent la gestion des licences hors ligne par appareil ingérable. Chaque nouveau conteneur pourrait avoir un UUID différent en fonction de l'infrastructure. La clé de licence d'IronBarcode fonctionne comme une variable d'environnement standard, sans enregistrement par instance.

Il est nécessaire de pouvoir générer des données et de les lire. Dynamsoft est en lecture seule. Les applications qui doivent générer des étiquettes de code-barres, imprimer des codes QR pour les produits ou créer des manifestes d'expédition avec des codes-barres intégrés nécessitent une deuxième bibliothèque. Dans ce genre de situation, les équipes optent souvent pour Code-barres IronBarcode afin d'éviter de gérer deux dépendances de codes-barres distinctes.

Empreinte opérationnelle simplifiée. La suppression du serveur de licences Dynamsoft de la liste des dépendances externes accessibles, la suppression de la bibliothèque de rendu PDF et le remplacement de la gestion des instances par des appels statiques réduisent les risques d'erreurs en production.

Conclusion

Dynamsoft Barcode Reader est une bibliothèque de haute qualité parfaitement adaptée à son cas d'utilisation prévu : la lecture de codes-barres en temps réel par caméra, notamment dans les applications mobiles. Les algorithmes sont parfaitement adaptés aux conditions de la numérisation manuelle : éclairage variable, flou de mouvement, occlusion partielle. Si tel est votre cas d'utilisation, Dynamsoft est un concurrent sérieux.

Pour le traitement de documents côté serveur (lecture des codes-barres dans les PDF, génération d'étiquettes de codes-barres, exécution dans des environnements isolés ou déploiement dans des conteneurs Docker éphémères), l'architecture de la bibliothèque engendre des difficultés à chaque étape. La validation de licence en ligne, l'absence de prise en charge des PDF, les paramètres de délai d'expiration optimisés pour l'appareil photo et le flux de travail hors ligne basé sur l'UUID de l'appareil sont autant de conséquences d'une conception axée sur l'utilisation avec un appareil photo mobile. Ce ne sont pas des insectes ; Ce sont des choix de conception délibérés pour un contexte différent.

IronBarcode est conçu pour le contexte côté document et côté serveur. La validation des licences locales, la lecture native des PDF, l'API statique et la prise en charge de la génération sont autant de fonctionnalités de premier ordre et non des solutions de contournement. La décision de migration dépend de l'environnement dans lequel vos codes-barres sont stockés.