El diseño solo con código QR

QRCoder separa el paso de creación de datos del paso de representación. Un QRCodeGenerator produce un objeto intermedio QRCodeData, que luego se pasa a una clase renderizadora. Este patrón ofrece un control preciso sobre el formato de salida a costa de añadir objetos adicionales:

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)

El método QRCodeGenerator.CreateQrCode es el único punto de entrada para la creación de código — no hay CreateCode128, no hay CreateDataMatrix, no hay CreateEAN13. La biblioteca se ajusta completamente a su propósito original.

Comparación detallada de características

Enfoque de código QR

QRCoder utiliza un patrón de dos fases: QRCodeGenerator.CreateQrCode produce un objeto intermedio QRCodeData que codifica los datos y el nivel de corrección de errores, y una clase renderizadora separada convierte ese intermedio en el formato de salida deseado. El nivel ECC es un parámetro obligatorio sin valor predeterminado; los desarrolladores deben elegirlo explícitamente:

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 patrón tiene el beneficio de reutilizar el objeto qrCodeData para múltiples formatos de salida sin regenerar los datos del código. Las clases renderizadoras incluyen PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode, y BitmapByteQRCode, entre otros.

Enfoque IronBarcode

IronBarcode combina generación y representación en una cadena fluente en la clase estática BarcodeWriter. El parámetro BarcodeEncoding.QRCode selecciona el formato, y los métodos terminales como SaveAsPng o ToPngBinaryData determinan la salida:

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 los casos que requieren control explícito de la corrección de errores, la clase QRCodeWriter proporciona opciones específicas del 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")

La guía de creación de códigos de barras 2D de IronBarcode cubre todos los formatos 2D soportados incluyendo Código QR, DataMatrix, PDF417y azteca a través del mismo punto de entrada BarcodeWriter.

Enfoque de código QR

La inserción de logotipo en Codificador de códigos QR se realiza a través de la clase renderizadora QRCode (distinta de PngByteQRCode), que expone una sobrecarga GetGraphic que acepta un System.Drawing.Bitmap. Esto significa que el código de llamada debe trabajar con System.Drawing directamente para cargar el archivo 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)

La personalización de color sigue un patrón similar a través de la sobrecarga GetGraphic y los parámetros darkColor y lightColor.

Enfoque IronBarcode

IronBarcode expone la inserción de logotipo y los cambios de color como métodos nombrados en el objeto de resultado QRCodeWriter. El método AddBrandLogo acepta una ruta de archivo, y ChangeBarCodeColor acepta un 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")

La guía de personalización del código QR abarca en detalle el tamaño del logotipo, las combinaciones de colores y el control de la zona silenciosa.

Enfoque de código QR

QRCoder no tiene una API para leer códigos de barras. La clase QRCodeGenerator y todas las clases renderizadoras son solo de generación. No existe ningún método para decodificar un código QR a partir de una imagen, un archivo o una transmisión de datos. Las aplicaciones que necesitan generar y leer códigos QR deben agregar una biblioteca separada, normalmente ZXing .NET , con su propia API, su propio espacio de nombres y su propio ciclo de mantenimiento:

// Codificador de códigos 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.

// Codificador de códigos 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.

' Codificador de códigos 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.

Se trata de una decisión de diseño, no de un descuido: Codificador de códigos QR es explícitamente una biblioteca de generación de códigos QR.

Enfoque IronBarcode

IronBarcode incluye una API de lectura en el mismo paquete. BarcodeReader.Read acepta archivos de imagen, archivos PDF, flujos y objetos System.Drawing.Bitmap. Detecta automáticamente los formatos de código de barras sin necesidad de que el usuario especifique qué formato buscar, y devuelve todos los códigos de barras encontrados en la imagen:

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

La guía para la lectura de códigos de barras a partir de imágenes abarca la lectura de archivos PDF, documentos de varias páginas, flujos de datos e imágenes de baja resolución o con ruido a través del mismo punto de entrada.

Enfoque de código QR

QRCoder genera exclusivamente códigos QR; esto es intencional. El método QRCodeGenerator.CreateQrCode es el único punto de entrada de generación que proporciona la biblioteca. Los proyectos que comienzan con códigos QR y posteriormente requieren etiquetas de envío Code 128, códigos de producto EAN-13 o códigos de cumplimiento farmacéutico Matriz de datos deben introducir una segunda biblioteca para cubrir cada formato adicional:

using QRCoder;

// Codificador de códigos QR 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)
// Matriz de datos requires yet another library
// Reading any format requires yet another library

using QRCoder;

// Codificador de códigos QR 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)
// Matriz de datos requires yet another library
// Reading any format requires yet another library

Imports QRCoder

' Codificador de códigos 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)

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

Enfoque IronBarcode

IronBarcode cubre todas las familias de formatos a través del mismo punto de entrada BarcodeWriter.CreateBarcode. Cambiar de código QR a Código 128 a Matriz de datos solo requiere cambiar el parámetro BarcodeEncoding — sin paquetes adicionales, sin nuevos namespaces, sin 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")

Los requisitos de formato van más allá de los códigos QR.

La mayoría de los requisitos de códigos de barras comienzan con códigos QR, y Codificador de códigos QR gestiona ese alcance inicial de forma fiable. La tensión surge cuando un segundo formato entra en la conversación. Los equipos de logística que necesitan etiquetas Código 128 para el envío, las operaciones minoristas que requieren códigos de producto EAN-13, los flujos de trabajo farmacéuticos que exigen Matriz de datos para la serialización: cada nuevo formato empuja a un equipo a agregar otra dependencia de NuGet . El coste de integración de cada biblioteca adicional incluye un nuevo espacio de nombres que aprender, un nuevo ciclo de lanzamiento que supervisar y un nuevo punto de posible conflicto de versiones en las actualizaciones de .NET .

La lectura de códigos de barras se vuelve necesaria.

Una aplicación que genera códigos QR salientes para una campaña es un sistema de solo generación. Una aplicación que también procesa los envíos entrantes, verifica los códigos de producto a su llegada o valida las entradas en un evento es un sistema de generación y lectura. Codificador de códigos QR no tiene capacidad de lectura por diseño; esa carencia debe ser cubierta por una segunda biblioteca. La introducción de una biblioteca de lectura modifica considerablemente la estructura de integración del subsistema de códigos de barras, especialmente si la biblioteca de lectura impone requisitos de especificación de formato o restricciones de seguridad de subprocesos propias.

Carga de mantenimiento de múltiples bibliotecas

El patrón de acumulación natural para un proyecto basado en Codificador de códigos QR sigue un camino predecible: Codificador de códigos QR para la generación de códigos QR, una biblioteca de códigos de barras 1D para etiquetas de envío y una biblioteca de lectura para la decodificación. Cada biblioteca tiene su propia documentación, su propio ciclo de versiones y su propio historial de cambios incompatibles. Una actualización de versión de .NET que sea menor para una biblioteca puede coincidir con un cambio incompatible en otra. Los equipos que gestionan esta acumulación a lo largo de los años informan que el coste oculto no reside en la integración inicial, sino en los gastos generales de mantenimiento que se acumulan a lo largo de múltiples ciclos de actualización.

Compatibilidad con documentos PDF

Con Codificador de códigos QR no es posible generar códigos de barras para incrustarlos en informes PDF ni extraer códigos de barras de documentos PDF entrantes en un proceso de gestión documental. La compatibilidad con archivos PDF requiere una biblioteca PDF completa con capacidades de código de barras o una combinación específica de bibliotecas. Los equipos que crean flujos de trabajo centrados en documentos (procesamiento de facturas, informes de cumplimiento, generación de etiquetas a partir de plantillas PDF) descubren que el alcance de Codificador de códigos QR coincide con los requisitos de PDF al principio del ciclo de vida del proyecto.

Formato de cadena del generador de carga útil

Las clases auxiliares PayloadGenerator de Codificador de códigos QR producen cadenas que cumplen con los estándares públicos de carga útil del código QR. El formato WiFi, por ejemplo, produce WIFI:T:WPA;S:NetworkName;P:Password;;. Estas cadenas se pueden construir directamente en IronBarcode sin necesidad de una clase auxiliar, ya que el formato es un estándar público documentado por la especificación del código QR. Los equipos con muchos usos de PayloadGenerator deberían planear escribir pequeños métodos auxiliares estáticos que repliquen la construcción de cadenas.

Mapeo de enumeración ECCLevel

QRCoder usa QRCodeGenerator.ECCLevel con valores L, M, Q, H. IronBarcode usa QRCodeWriter.QrErrorCorrectionLevel con valores Low, Medium, Quartile, y Highest. La asignación es directa, pero las referencias a enumeraciones deben actualizarse en todos los puntos de llamada. Donde Codificador de códigos QR requería la selección explícita de CCC en cada llamada de CreateQrCode, IronBarcode aplica un valor predeterminado razonable cuando se usa la ruta BarcodeWriter.CreateBarcode.

Eliminación de la clase de renderizado

Las clases renderizadoras de Codificador de códigos QR — PngByteQRCode, SvgQRCode, AsciiQRCode, Base64QRCode, QRCode — se vuelven innecesarias después de la migración. IronBarcode integra la renderización en la cadena fluente en GeneratedBarcode, por lo que el patrón de objeto intermedio de renderizador no se transfiere. El código que instancia estas clases renderizadoras puede ser reemplazado con llamadas a métodos terminales en el resultado BarcodeWriter.