Design exclusivo para QR Code

QRCoder separa a etapa de criação de dados da etapa de renderização. Um(a) QRCodeGenerator produz um(a) objeto intermediário QRCodeData, que então é passado para uma classe renderizadora. 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 criação de código — não há CreateCode128, não há CreateDataMatrix, não há CreateEAN13. A biblioteca cumpre integralmente o seu objetivo.

Comparação Detalhada de Recursos

Abordagem do QRCoder

OQRCoderusa um padrão de duas fases: QRCodeGenerator.CreateQrCode produz um objeto intermediário QRCodeData codificando os dados e o nível de correção de erro, e uma classe renderizadora 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)

Este padrão tem a vantagem de reutilizar o objeto qrCodeData para múltiplos formatos de saída sem regenerar os dados do código. As classes de renderizador incluem PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode e BitmapByteQRCode, entre outros.

Abordagem do IronBarcode

O IronBarcode une geração e renderização em uma cadeia fluente na classe estática BarcodeWriter. O parâmetro BarcodeEncoding.QRCode seleciona o formato, e métodos terminais, 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 requerem controle explícito da correção de erro, 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 cobre todos os formatos 2D suportados incluindo Código QR, DataMatrix,PDF417e asteca através do mesmo ponto de entrada BarcodeWriter.

Abordagem do QRCoder

A incorporação de logotipos noQRCoderé feita através da classe de renderizador QRCode (diferente de PngByteQRCode), que expõe uma sobrecarga GetGraphic que aceita um(a) System.Drawing.Bitmap. Isso significa que o código de chamada deve trabalhar com System.Drawing diretamente para carregar o arquivo do 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 da sobrecarga GetGraphic com os parâmetros darkColor e lightColor.

Abordagem do IronBarcode

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

OQRCodernão possui uma API de leitura de código de barras. A classe QRCodeGenerator e todas as classes de renderizador são apenas 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:

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

//QRCoderhas 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 — oQRCoderé explicitamente uma biblioteca de geração.

Abordagem do IronBarcode

O IronBarcode inclui 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.Value);       // decoded value
    Console.WriteLine(result.Format);      // 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.Value);       // decoded value
    Console.WriteLine(result.Format);      // 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.Value)       ' decoded value
    Console.WriteLine(result.Format)      ' 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

OQRCodergera 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êuticaDataMatrixdevem introduzir uma segunda biblioteca para abranger cada formato adicional:

using QRCoder;

//QRCoderis 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)
//DataMatrixrequires yet another library
// Reading any format requires yet another library

using QRCoder;

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

O IronBarcode cobre todas as famílias de formato através do mesmo ponto de entrada BarcodeWriter.CreateBarcode. Mudar de código QR para o Código 128 para oDataMatrixrequer 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 oQRCoderlida 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 exigemDataMatrixpara 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. OQRCodernã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 emQRCodersegue um caminho previsível:QRCoderpara 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 doQRCodercoincide 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 doQRCoderproduzem 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 no IronBarcode sem 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 a escrita de pequenos métodos auxiliares estáticos que replicam a construção de strings.

Mapeamento de enumeração ECCLevel

QRCoder usa QRCodeGenerator.ECCLevel com os valores L, M, Q, H. O IronBarcode usa 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. Onde oQRCoderrequeria seleção explícita de ECC em cada chamada CreateQrCode, o IronBarcode aplica um padrão sensato quando o caminho BarcodeWriter.CreateBarcode é usado.

Remoção da classe de renderização

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