Crear códigos QR personalizables es una potente manera de entregar enlaces, IDs y apps-deep en el momento de permanecer en la marca. con Aspose.BarCode para .NET, se puede corregir errores de tonalidad, tamaño de módulo, colores y formatos de salida para satisfacer las necesidades funcionales y estéticas. Este artículo alinea las instrucciones paso a paso con el gist al final y añade consejos prácticos, gotchas y mejoras opcionales.

Prerequisitos

  • NET 8 (o .NET 6+) SDK
  • NuGet Acceso (Aspose.BarCode)
  • Conocimiento básico con System.Drawing
  • (Opcional) Objetivo de salida de alta resolución para los casos de uso impreso

Crea un proyecto y añade el paquete

dotnet new console -n CustomizableQRCodeExample -f net8.0
cd CustomizableQRCodeExample
dotnet add package Aspose.BarCode

Ejemplo completo

using System;
using System.Drawing;
using Aspose.BarCode.Generation;

namespace CustomizableQRCodeExample
{
    class Program
    {
        static void Main(string[] args)
        {
            // Step 1: Create a QR code generator with specific settings
            var qrGenerator = new BarcodeGenerator(EncodeTypes.QR, "https://www.aspose.com");

            // Step 2: Configure QR code properties
            qrGenerator.Parameters.Barcode.QR.CodeText = "https://www.aspose.com";
            qrGenerator.Parameters.Barcode.QR.ErrorLevel = QRErrorLevelLevel.High;
            qrGenerator.Parameters.Barcode.QR.ModuleSize = 5;
            qrGenerator.Parameters.Barcode.XDimension.Pixels = 2;

            // Step 3: Customize colors
            qrGenerator.Parameters.Barcode.ForegroundColor = Color.Black;
            qrGenerator.Parameters.Barcode.BackgroundColor = Color.White;

            // Step 4: Generate and save the QR code as an image
            using (var image = qrGenerator.GenerateBarCodeImage())
            {
                image.Save("CustomQRCode.png");
                Console.WriteLine("QR Code generated successfully!");
            }
        }
    }
}

Paso a paso (mapeado al ejemplo)

Paso 1: Iniciar el generador QR

Crea un generador con EncodeTypes.QR y una carga de pago estándar (URL, ID, etc.).

var qrGenerator = new BarcodeGenerator(EncodeTypes.QR, "https://www.aspose.com");

Puedes configurar el contenido a través del constructor o Parameters.Barcode.QR.CodeTextEl ejemplo establece ambos para la claridad.

Paso 2: Configure las propiedades QR Core

  • Texto de código: los datos reales codificados en el QR.
  • ** Corrección de errores**: controla la resiliencia (por ejemplo, los agujeros, logos sobre el código).
  • ** Modulo / tamaño celular**: el tamaño de cada cuadrado “modulo”.
qrGenerator.Parameters.Barcode.QR.CodeText = "https://www.aspose.com";
qrGenerator.Parameters.Barcode.QR.ErrorLevel = QRErrorLevelLevel.High; // robust against damage
qrGenerator.Parameters.Barcode.QR.ModuleSize = 5;                       // pixels per module (visual density)
qrGenerator.Parameters.Barcode.XDimension.Pixels = 2;                   // base module thickness (kept to match gist)

**Nota: ** Para QR, configuración QR.ModuleSize Por lo general, es suficiente.El ejemplo también XDimension.Pixels para reflejar el hello; si tuve sólo uno, prefiera QR.ModuleSize para una escalera visual previsible.

Paso 3: Aplique los colores de la marca (Foreground/Background)

qrGenerator.Parameters.Barcode.ForegroundColor = Color.Black;
qrGenerator.Parameters.Barcode.BackgroundColor = Color.White;

Para la máxima fiabilidad de la escaneamiento, asegúrese de un contraste adecuado.Si invierte colores o coloca en fondos ocupados, añade una generosa zona tranquila (margen).

Paso 4: Render y ahorrar

Generar a System.Drawing.Image y ahorrar como PNG (sharp, sin pérdidas).

using (var image = qrGenerator.GenerateBarCodeImage())
{
    image.Save("CustomQRCode.png");
}

Mejoras opcionales

a) Exportación a varios formatos

using System.Drawing.Imaging;

// After GenerateBarCodeImage():
image.Save("CustomQRCode.jpg", ImageFormat.Jpeg);  // for photos/CMYK workflows
image.Save("CustomQRCode.bmp", ImageFormat.Bmp);   // uncompressed (big files)

Aumentar la lectura de la imprenta

    • Aumentar el nivel: ascender QR.ModuleSize (por ejemplo, 6-10) para las impresiones físicas.
  • Zona de Quiet: asegúrese de un espacio blanco suficiente alrededor del código; si su herramienta de diseño está demasiado cerca, añade la columna a la imagen.
    • Corrección de error elevado *: mantenerse High Si se colocan pequeños logos o se imprime en superficies texturadas.

c) Variaciones de pago incorporadas

    • Enlaces de aplicación *: myapp://open?id=12345
  • • Configuración de Wi-Fi: WIFI:T:WPA;S:MySSID;P:MyPassword;H:false;
  • • VCARD *: BEGIN:VCARD\nVERSION:3.0\nN:…\nEND:VCARD

Troubleshooting

  • El escáner no lea: aumentar el contraste (frente oscuro, fondo claro), crecer ModuleSizey garantizar una zona limpia y tranquila.
  • Blurry en pequeños tamaños: Evite JPEG para pequeños códigos; prefiere PNG y módulos más grandes.
  • Logo sobrelay: Mantenga pequeño y centrado; confiar en High Corrección de errores para compensar.

Mejores Prácticas

  • Validación del contenido: Valida las URL/ID antes de incorporarse para evitar los códigos QR en la impresión.
  • Control de versión: Mantenga las configuraciones del generador en código (o config) y los compromete – materia de salida reproducible en el branding.
  • Paridad medioambiental: Si rendes en CI, utilice el mismo DPI/font stack para evitar diferencias sutiles de raster.

Conclusión

Con Aspose.BarCode para .NET, puede crear códigos QR que no sólo son robust (a través de la corrección de error) sino también *on-brand (via el tamaño y el control de color). ModuleSize, corrección de errores, y colores para adaptarse a su medio de entrega – pantalla, etiqueta, o billboard.

More in this category