Comparação entre QRCoder.NET e IronBarcode: Bibliotecas de código de barras em C#

Design exclusivo para QR Code

O QRCoder separa a etapa de criação de dados da etapa de renderização. Um QRCodeGenerator produz um objeto intermediário QRCodeData, que é então passado para uma classe de renderização. Esse padrão oferece controle preciso sobre o formato de saída, ao custo de objetos adicionais:

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)

O método QRCodeGenerator.CreateQrCode é o único ponto de entrada para a criação de código — não existe CreateCode128, nem CreateDataMatrix, nem CreateEAN13. A biblioteca cumpre integralmente o seu objetivo.

Comparação Detalhada de Recursos

Abordagem do QRCoder

O QRCoder usa um padrão de duas fases: QRCodeGenerator.CreateQrCode produz um objeto intermediário QRCodeData que codifica os dados e o nível de correção de erros, e uma classe de renderização separada converte esse intermediário no formato de saída desejado. O nível ECC é um parâmetro obrigatório sem valor padrão — os desenvolvedores devem escolhê-lo explicitamente:

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)

Esse padrão tem a vantagem de reutilizar o objeto qrCodeData para vários formatos de saída sem regenerar os dados do código. As classes de renderização incluem PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode e BitmapByteQRCode, entre outras.

Abordagem do IronBarcode

IronBarcode condensa a geração e a renderização em uma cadeia fluida na classe estática BarcodeWriter. O parâmetro BarcodeEncoding.QRCode seleciona o formato, e métodos de terminal como SaveAsPng ou ToPngBinaryData determinam a saída:

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

Para casos que exigem controle explícito de correção de erros, a classe QRCodeWriter fornece opções específicas de formato:

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

O guia de criação de código de barras 2D do IronBarcode abrange todos os formatos 2D suportados, incluindo QR Code, DataMatrix, PDF417 e Aztec, através do mesmo ponto de entrada BarcodeWriter.

Abordagem do QRCoder

A incorporação do logotipo QRCoder é feita através da classe de renderização QRCode (diferente de PngByteQRCode), que expõe uma sobrecarga GetGraphic que aceita um System.Drawing.Bitmap. Isso significa que o código de chamada deve funcionar diretamente com System.Drawing para carregar o arquivo de logotipo:

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)

A personalização de cores segue um padrão semelhante através dos parâmetros GetGraphic da sobrecarga darkColor e lightColor.

Abordagem do IronBarcode

IronBarcode expõe a incorporação de logotipos e alterações de cores como métodos nomeados no objeto de resultado QRCodeWriter. O método AddBrandLogo aceita um caminho de arquivo e o método ChangeBarCodeColor aceita um valor 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")

O guia de personalização do código QR aborda detalhadamente o tamanho do logotipo, as combinações de cores e o controle da zona de silêncio.

Abordagem do QRCoder

O QRCoder não possui uma API de leitura de código de barras. A classe QRCodeGenerator e todas as classes de renderização são somente para geração. Não existe método para decodificar um código QR a partir de uma imagem, arquivo ou fluxo de dados. Aplicações que precisam gerar e ler códigos QR devem adicionar uma biblioteca separada — normalmente ZXing .NET — com sua própria API, seu próprio namespace e seu próprio ciclo de manutenção:

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

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

' QRCoder 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.

Essa é uma decisão de projeto, não um descuido — o QRCoder é explicitamente uma biblioteca de geração.

Abordagem do IronBarcode

OIronBarcodeinclui uma API de leitura no mesmo pacote. BarcodeReader.Read aceita arquivos de imagem, arquivos PDF, fluxos e objetos System.Drawing.Bitmap. Ele detecta automaticamente os formatos de código de barras sem exigir que o usuário especifique qual formato procurar e retorna todos os códigos de barras encontrados na imagem:

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

O guia de leitura de código de barras a partir de imagens abrange a leitura de PDFs, documentos com várias páginas, fluxos de dados e imagens de baixa resolução ou com ruído, tudo através do mesmo ponto de entrada.

Abordagem do QRCoder

O QRCoder gera exclusivamente códigos QR — isso é intencional. O método QRCodeGenerator.CreateQrCode é o único ponto de entrada de geração que a biblioteca fornece. Projetos que começam com códigos QR e posteriormente exigem etiquetas de envio Code 128, códigos de produto EAN-13 ou códigos de conformidade farmacêutica DataMatrix devem introduzir uma segunda biblioteca para abranger cada formato adicional:

using QRCoder;

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

// Código 128 requires a different library (e.g., NetBarcode)
// DataMatrix requires yet another library
// Reading any format requires yet another library

using QRCoder;

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

// Código 128 requires a different library (e.g., NetBarcode)
// DataMatrix requires yet another library
// Reading any format requires yet another library

Imports QRCoder

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

' Código 128 requires a different library (e.g., NetBarcode)
' DataMatrix requires yet another library
' Reading any format requires yet another library

Abordagem do IronBarcode

IronBarcode abrange todas as famílias de formatos através do mesmo ponto de entrada BarcodeWriter.CreateBarcode. A transição do código QR para o Código 128 e, posteriormente, para o DataMatrix, requer apenas a alteração do parâmetro BarcodeEncoding — sem pacotes adicionais, sem novos namespaces, sem APIs separadas:

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

Os requisitos de formato vão além do QR Code.

A maioria das necessidades de códigos de barras começa com códigos QR, e o QRCoder lida com esse escopo inicial de forma confiável. A tensão surge quando um segundo formato entra na conversa. Equipes de logística que precisam de etiquetas Código 128 para envio, operações de varejo que exigem códigos de produto EAN-13, fluxos de trabalho farmacêuticos que exigem DataMatrix para serialização — cada novo formato leva uma equipe a adicionar mais uma dependência do NuGet . O custo de integração de cada biblioteca adicional inclui um novo namespace para aprender, um novo ciclo de lançamento para monitorar e um novo ponto de potencial conflito de versão em atualizações do .NET .

A leitura de códigos de barras torna-se necessária

Um aplicativo que gera códigos QR para uma campanha é um sistema somente de geração. Um aplicativo que também processa remessas de entrada, verifica códigos de produtos na chegada ou valida ingressos em um evento é um sistema de geração e leitura. O QRCoder não possui capacidade de leitura por design — essa lacuna precisa ser preenchida por uma segunda biblioteca. A introdução de uma biblioteca de leitura altera consideravelmente a complexidade da integração do subsistema de código de barras, especialmente se a biblioteca de leitura impuser requisitos de especificação de formato ou restrições de segurança de threads próprias.

Ônus de manutenção de múltiplas bibliotecas

O padrão natural de acumulação para um projeto baseado em QRCoder segue um caminho previsível: QRCoder para geração de QR codes, uma biblioteca de códigos de barras 1D para etiquetas de envio e uma biblioteca de leitura para decodificação. Cada biblioteca possui sua própria documentação, seu próprio ciclo de versionamento e seu próprio histórico de alterações que causam incompatibilidade. Uma atualização de versão do .NET que seja considerada pequena para uma biblioteca pode coincidir com uma alteração que cause incompatibilidade em outra. As equipes que gerenciam esse acúmulo ao longo dos anos relatam que o custo oculto não está na integração inicial, mas sim no aumento dos custos de manutenção em vários ciclos de atualização.

Suporte para documentos PDF

Com o QRCoder, não é possível gerar códigos de barras para incorporar em relatórios PDF ou extrair códigos de barras de documentos PDF recebidos em um fluxo de processamento de documentos. O suporte a PDF requer uma biblioteca completa de PDF com recursos de código de barras ou uma combinação dedicada de bibliotecas. Equipes que desenvolvem fluxos de trabalho centrados em documentos — como processamento de faturas, relatórios de conformidade e geração de etiquetas a partir de PDFs com modelos predefinidos — descobrem que o escopo do QRCoder coincide com os requisitos de PDF logo no início do ciclo de vida de um projeto.

Formato de string do PayloadGenerator

As classes auxiliares PayloadGenerator do QRCoder produzem strings que estão em conformidade com os padrões públicos de payload de código QR. O formato WiFi, por exemplo, produz WIFI:T:WPA;S:NetworkName;P:Password;;. Essas strings podem ser construídas diretamente noIronBarcodesem uma classe auxiliar, já que o formato é um padrão público documentado pela especificação do código QR. Equipes com muitos usos de PayloadGenerator devem planejar escrever pequenos métodos auxiliares estáticos que repliquem a construção da string.

Mapeamento de enumeração ECCLevel

O QRCoder usa QRCodeGenerator.ECCLevel com os valores L, M, Q, H.IronBarcodeusa QRCodeWriter.QrErrorCorrectionLevel com os valores Low, Medium, Quartile e Highest. O mapeamento é direto, mas as referências de enumeração devem ser atualizadas em todos os locais de chamada. Enquanto o QRCoder exigia a seleção explícita de ECC em cada chamada CreateQrCode, oIronBarcodeaplica um valor padrão sensato quando o caminho BarcodeWriter.CreateBarcode é usado.

Remoção da classe de renderização

As classes de renderização do QRCoder — PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode, QRCode — tornam-se desnecessárias após a migração.IronBarcodeincorpora a renderização na cadeia fluente em GeneratedBarcode, portanto o padrão de objeto de renderização intermediário não é mantido. O código que instancia essas classes de renderização pode ser substituído por chamadas de método terminal no resultado BarcodeWriter.