QRCoder.NET vs IronBarcode : Comparaison de la bibliothèque de codes-barres C#

Conception avec QR uniquement

QRCoder sépare l'étape de création des données de l'étape de rendu. Un QRCodeGenerator produit un objet intermédiaire QRCodeData, qui est ensuite transmis à une classe de rendu. Ce modèle permet un contrôle précis du format de sortie, au prix d'objets supplémentaires :

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

// PNG bytes via PngByteQRCode
var pngQR = new PngByteQRCode(qrCodeData);
byte[] pngBytes = pngQR.GetGraphic(20); // 20px per module
File.WriteAllBytes("qr.png", pngBytes);

// SVG string via SvgQRCode
string svgContent = new SvgQRCode(qrCodeData).GetGraphic(10);
File.WriteAllText("qr.svg", svgContent);

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

// PNG bytes via PngByteQRCode
var pngQR = new PngByteQRCode(qrCodeData);
byte[] pngBytes = pngQR.GetGraphic(20); // 20px per module
File.WriteAllBytes("qr.png", pngBytes);

// SVG string via SvgQRCode
string svgContent = new SvgQRCode(qrCodeData).GetGraphic(10);
File.WriteAllText("qr.svg", svgContent);

Imports QRCoder
Imports System.IO

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)

' PNG bytes via PngByteQRCode
Dim pngQR As New PngByteQRCode(qrCodeData)
Dim pngBytes As Byte() = pngQR.GetGraphic(20) ' 20px per module
File.WriteAllBytes("qr.png", pngBytes)

' SVG string via SvgQRCode
Dim svgContent As String = New SvgQRCode(qrCodeData).GetGraphic(10)
File.WriteAllText("qr.svg", svgContent)

La méthode QRCodeGenerator.CreateQrCode est le seul point d'entrée pour la création de code - il n'y a pas de CreateCode128, pas de CreateDataMatrix, pas de CreateEAN13. La bibliothèque respecte pleinement son périmètre d'action prévu.

Comparaison détaillée des fonctionnalités

Approche QRCoder

QRCoder utilise un modèle en deux phases : QRCodeGenerator.CreateQrCode produit un objet intermédiaire QRCodeData codant les données et le niveau de correction des erreurs, et une classe de rendu distincte convertit cet objet intermédiaire dans le format de sortie souhaité. Le niveau ECC est un paramètre obligatoire sans valeur par défaut ; les développeurs doivent le choisir explicitement :

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

var qrCode = new PngByteQRCode(qrCodeData);
byte[] pngBytes = qrCode.GetGraphic(20); // pixels per module
File.WriteAllBytes("qr.png", pngBytes);

using QRCoder;
using System.IO;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.M
);

var qrCode = new PngByteQRCode(qrCodeData);
byte[] pngBytes = qrCode.GetGraphic(20); // pixels per module
File.WriteAllBytes("qr.png", pngBytes);

Imports QRCoder
Imports System.IO

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.M)

Dim qrCode As New PngByteQRCode(qrCodeData)
Dim pngBytes As Byte() = qrCode.GetGraphic(20) ' pixels per module
File.WriteAllBytes("qr.png", pngBytes)

Ce modèle présente l'avantage de réutiliser l'objet qrCodeData pour plusieurs formats de sortie sans régénérer les données du code. Les classes de rendu comprennent PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode, et BitmapByteQRCode, entre autres.

Approche IronBarcode

IronBarcode regroupe la génération et le rendu en une chaîne fluide sur la classe statique BarcodeWriter. Le paramètre BarcodeEncoding.QRCode sélectionne le format, et les méthodes de terminal telles que SaveAsPng ou ToPngBinaryData déterminent la sortie :

using IronBarCode;

// Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(400, 400)
    .SaveAsPng("qr.png");

using IronBarCode;

// Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode)
    .ResizeTo(400, 400)
    .SaveAsPng("qr.png");

Imports IronBarCode

' Single fluent call — no intermediate objects
BarcodeWriter.CreateBarcode("https://example.com", BarcodeEncoding.QRCode) _
    .ResizeTo(400, 400) _
    .SaveAsPng("qr.png")

Pour les cas nécessitant un contrôle explicite de la correction des erreurs, la classe QRCodeWriter fournit des options spécifiques au format :

using IronBarCode;

var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Medium
);
qr.SaveAsPng("qr.png");

using IronBarCode;

var qr = QRCodeWriter.CreateQrCode(
    "https://example.com",
    500,
    QRCodeWriter.QrErrorCorrectionLevel.Medium
);
qr.SaveAsPng("qr.png");

Imports IronBarCode

Dim qr = QRCodeWriter.CreateQrCode("https://example.com", 500, QRCodeWriter.QrErrorCorrectionLevel.Medium)
qr.SaveAsPng("qr.png")

Le guide de création de codes-barres 2D IronBarcode couvre tous les formats 2D pris en charge, notamment QR Code, DataMatrix, PDF417et Aztec, par le biais du même BarcodeWriter point d'entrée.

Approche QRCoder

L'intégration du logo Codeur QR passe par la classe QRCode renderer (distincte de PngByteQRCode), qui expose une surcharge GetGraphic acceptant un System.Drawing.Bitmap. Cela signifie que le code d'appel doit fonctionner avec System.Drawing directement pour charger le fichier du logo :

using QRCoder;
using System.Drawing;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.H // High ECC required when logo occludes part of the code
);

var qrCode = new QRCode(qrCodeData);
var logoBitmap = new Bitmap("logo.png");
var qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap);
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png);

using QRCoder;
using System.Drawing;

var qrGenerator = new QRCodeGenerator();
var qrCodeData = qrGenerator.CreateQrCode(
    "https://example.com",
    QRCodeGenerator.ECCLevel.H // High ECC required when logo occludes part of the code
);

var qrCode = new QRCode(qrCodeData);
var logoBitmap = new Bitmap("logo.png");
var qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap);
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png);

Imports QRCoder
Imports System.Drawing

Dim qrGenerator As New QRCodeGenerator()
Dim qrCodeData = qrGenerator.CreateQrCode("https://example.com", QRCodeGenerator.ECCLevel.H) ' High ECC required when logo occludes part of the code

Dim qrCode As New QRCode(qrCodeData)
Dim logoBitmap As New Bitmap("logo.png")
Dim qrBitmap = qrCode.GetGraphic(10, Color.Black, Color.White, logoBitmap)
qrBitmap.Save("qr-logo.png", System.Drawing.Imaging.ImageFormat.Png)

La personnalisation des couleurs suit un schéma similaire grâce aux paramètres GetGraphic de la surcharge darkColor et lightColor.

Approche IronBarcode

IronBarcode expose l'intégration de logo et les changements de couleur en tant que méthodes nommées sur l'objet de résultat QRCodeWriter. La méthode AddBrandLogo accepte un chemin de fichier, et ChangeBarCodeColor accepte une valeur Color :

using IronBarCode;
using System.Drawing;

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

// Colour customisation
var coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500);
coloredQr.ChangeBarCodeColor(Color.DarkBlue);
coloredQr.SaveAsPng("colored-qr.png");

using IronBarCode;
using System.Drawing;

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

// Colour customisation
var coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500);
coloredQr.ChangeBarCodeColor(Color.DarkBlue);
coloredQr.SaveAsPng("colored-qr.png");

Imports IronBarCode
Imports System.Drawing

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

' Colour customisation
Dim coloredQr = QRCodeWriter.CreateQrCode("https://example.com", 500)
coloredQr.ChangeBarCodeColor(Color.DarkBlue)
coloredQr.SaveAsPng("colored-qr.png")

Le guide de personnalisation du style de code QR couvre en détail la taille du logo, les combinaisons de couleurs et le contrôle de la zone silencieuse.

Approche QRCoder

QRCoder ne possède pas d'API de lecture de codes-barres. La classe QRCodeGenerator et toutes les classes de rendu sont des classes de génération uniquement. Il n'existe aucune méthode pour décoder un code QR à partir d'une image, d'un fichier ou d'un flux. Les applications qui doivent à la fois générer et lire des codes QR doivent ajouter une bibliothèque distincte — généralement ZXing .NET — avec sa propre API, son propre espace de noms et son propre cycle de maintenance :

// Codeur QR has no reading API.
// These methods do not exist:
//   qrGenerator.Decode("image.png");
//   QRCodeReader.Read("image.png");
//
// A separate library (e.g., ZXing.Net) is required for decoding.

// Codeur QR has no reading API.
// These methods do not exist:
//   qrGenerator.Decode("image.png");
//   QRCodeReader.Read("image.png");
//
// A separate library (e.g., ZXing.Net) is required for decoding.

' Codeur QR has no reading API.
' These methods do not exist:
'   qrGenerator.Decode("image.png")
'   QRCodeReader.Read("image.png")
'
' A separate library (e.g., ZXing.Net) is required for decoding.

Il s'agit d'un choix de conception, et non d'un oubli : Codeur QR est explicitement une bibliothèque de génération.

Approche IronBarcode

IronBarcode inclut une API de lecture dans le même package. BarcodeReader.Read accepte les fichiers images, les fichiers PDF, les flux et les objets System.Drawing.Bitmap. Il détecte automatiquement les formats de codes-barres sans que l'appelant ait besoin de préciser le format à rechercher, et renvoie tous les codes-barres trouvés dans l'image :

using IronBarCode;

// Reading a QR code — no separate library required
var results = BarcodeReader.Read("qr.png");
foreach (var result in results)
{
    Console.WriteLine(result.Text);        // decoded value
    Console.WriteLine(result.BarcodeType); // QRCode, Code128, EAN13, etc.
}

using IronBarCode;

// Reading a QR code — no separate library required
var results = BarcodeReader.Read("qr.png");
foreach (var result in results)
{
    Console.WriteLine(result.Text);        // decoded value
    Console.WriteLine(result.BarcodeType); // QRCode, Code128, EAN13, etc.
}

Imports IronBarCode

' Reading a QR code — no separate library required
Dim results = BarcodeReader.Read("qr.png")
For Each result In results
    Console.WriteLine(result.Text)        ' decoded value
    Console.WriteLine(result.BarcodeType) ' QRCode, Code128, EAN13, etc.
Next

Le guide de lecture des codes-barres à partir d'images couvre la lecture à partir de fichiers PDF, de documents multipages, de flux et d'images basse résolution ou bruitées via le même point d'entrée.

Approche QRCoder

QRCoder génère exclusivement des codes QR — c'est voulu. La méthode QRCodeGenerator.CreateQrCode est le seul point d'entrée de génération fourni par la bibliothèque. Les projets qui commencent avec des codes QR et qui nécessitent par la suite des étiquettes d'expédition Code 128, des codes produits EAN-13 ou des codes de conformité pharmaceutique Matrice de données doivent introduire une deuxième bibliothèque pour couvrir chaque format supplémentaire :

using QRCoder;

// Codeur QR is limited to QR — other formats require separate packages
var qrGenerator = new QRCodeGenerator();
var qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M);

// Code 128requires a different library (e.g., NetBarcode)
// Matrice de données requires yet another library
// Reading any format requires yet another library

using QRCoder;

// Codeur QR is limited to QR — other formats require separate packages
var qrGenerator = new QRCodeGenerator();
var qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M);

// Code 128requires a different library (e.g., NetBarcode)
// Matrice de données requires yet another library
// Reading any format requires yet another library

Imports QRCoder

' Codeur QR is limited to QR — other formats require separate packages
Dim qrGenerator As New QRCodeGenerator()
Dim qr = qrGenerator.CreateQrCode("scan-to-track", QRCodeGenerator.ECCLevel.M)

' Code 128 requires a different library (e.g., NetBarcode)
' Matrice de données requires yet another library
' Reading any format requires yet another library

Approche IronBarcode

IronBarcode couvre toutes les familles de formats à travers le même BarcodeWriter.CreateBarcode point d'entrée. Pour passer du code QR au Code 128à DataMatrix, il suffit de modifier le paramètre BarcodeEncoding - pas de paquets supplémentaires, pas de nouveaux espaces de noms, pas d'API distinctes :

using IronBarCode;

// All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode)
    .SaveAsPng("campaign-qr.png");

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product-code.png");

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-code.png");

using IronBarCode;

// All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode)
    .SaveAsPng("campaign-qr.png");

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128)
    .SaveAsPng("shipping-label.png");

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13)
    .SaveAsPng("product-code.png");

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix)
    .SaveAsPng("pharma-code.png");

Imports IronBarCode

' All formats — one API, one package
BarcodeWriter.CreateBarcode("scan-to-track", BarcodeEncoding.QRCode) _
    .SaveAsPng("campaign-qr.png")

BarcodeWriter.CreateBarcode("SHIP-12345", BarcodeEncoding.Code128) _
    .SaveAsPng("shipping-label.png")

BarcodeWriter.CreateBarcode("5901234123457", BarcodeEncoding.EAN13) _
    .SaveAsPng("product-code.png")

BarcodeWriter.CreateBarcode("LOT-ABC-123", BarcodeEncoding.DataMatrix) _
    .SaveAsPng("pharma-code.png")

Exigences de format : aller au-delà des QR codes

La plupart des exigences en matière de codes-barres commencent par les codes QR, et Codeur QR gère cette première étape de manière fiable. La tension apparaît lorsqu'un deuxième format entre en scène. Les équipes logistiques qui ont besoin d'étiquettes Code 128pour l'expédition, les opérations de vente au détail qui exigent des codes produits EAN-13, les flux de travail pharmaceutiques qui imposent Matrice de données pour la sérialisation — chaque nouveau format pousse une équipe à ajouter une nouvelle dépendance NuGet . Le coût d'intégration de chaque bibliothèque supplémentaire comprend un nouvel espace de noms à apprendre, un nouveau cycle de publication à surveiller et un nouveau point de conflit de versions potentiel lors des mises à niveau .NET .

La lecture des codes-barres devient nécessaire

Une application qui génère des codes QR sortants pour une campagne est un système de génération uniquement. Une application qui traite également les expéditions entrantes, vérifie les codes produits à l'arrivée ou valide les billets lors d'un événement est un système de génération et de lecture. De par sa conception, Codeur QR ne possède aucune capacité de lecture ; cette lacune doit être comblée par une seconde bibliothèque. L'introduction d'une bibliothèque de lecture modifie considérablement l'empreinte d'intégration du sous-système de codes-barres, en particulier si la bibliothèque de lecture impose ses propres exigences de spécification de format ou contraintes de sécurité des threads.

Charge de maintenance de plusieurs bibliothèques

Le schéma d'accumulation naturel d'un projet basé sur Codeur QR suit un chemin prévisible : Codeur QR pour la génération de QR codes, une bibliothèque de codes-barres 1D pour les étiquettes d'expédition, une bibliothèque de lecture pour le décodage. Chaque bibliothèque possède sa propre documentation, son propre rythme de versionnage et son propre historique des changements importants. Une mise à jour mineure de la version .NET pour une bibliothèque peut coïncider avec une modification incompatible dans une autre. Les équipes qui gèrent cette accumulation sur plusieurs années indiquent que le coût caché ne réside pas dans l'intégration initiale, mais dans les frais de maintenance cumulatifs sur plusieurs cycles de mise à niveau.

Prise en charge des documents PDF

Il n'est pas possible avec Codeur QR de générer des codes-barres à intégrer dans des rapports PDF, ni d'extraire des codes-barres de documents PDF entrants dans un pipeline de traitement de documents. La prise en charge des fichiers PDF nécessite soit une bibliothèque PDF complète avec fonctionnalités de codes-barres, soit une combinaison dédiée de bibliothèques. Les équipes qui développent des flux de travail axés sur les documents (traitement des factures, rapports de conformité, génération d'étiquettes à partir de modèles PDF) constatent que le périmètre de Codeur QR recoupe les exigences des PDF dès le début du cycle de vie d'un projet.

Format de chaîne PayloadGenerator

Les classes d'aide de Codeur QR PayloadGenerator produisent des chaînes conformes aux normes publiques de charge utile de code QR. Le format WiFi, par exemple, produit WIFI:T:WPA;S:NetworkName;P:Password;;. Ces chaînes de caractères peuvent être construites directement dans Code-barres IronBarcode sans classe d'assistance, car le format est une norme publique documentée par la spécification du code QR. Les équipes qui utilisent beaucoup de PayloadGenerator devraient prévoir d'écrire de petites méthodes d'aide statiques qui reproduisent la construction de la chaîne.

Cartographie des énumérations ECCLevel

QRCoder utilise QRCodeGenerator.ECCLevel avec les valeurs L, M, Q, H. Code-barres IronBarcode utilise QRCodeWriter.QrErrorCorrectionLevel avec les valeurs Low, Medium, Quartile, et Highest. Le mappage est direct, mais les références d'énumération doivent être mises à jour sur tous les sites d'appel. Là où Codeur QR exigeait une sélection ECC explicite sur chaque appel CreateQrCode, Code-barres IronBarcode applique une valeur par défaut judicieuse lorsque le chemin BarcodeWriter.CreateBarcode est utilisé.

Suppression de la classe de rendu

Les classes de rendu de Codeur QR - PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode, QRCode - deviennent inutiles après la migration. Code-barres IronBarcode intègre le rendu dans la chaîne fluide sur GeneratedBarcode, de sorte que le modèle d'objet de rendu intermédiaire n'est pas reporté. Le code qui instancie ces classes de rendu peut être remplacé par des appels de méthodes terminales sur le résultat BarcodeWriter.