Cómo implementar colores personalizados en códigos QR

Cambiar el color de fondo

El color de fondo de un código QR es el área más clara que rodea los módulos oscuros. Por defecto, es blanco, pero puede cambiarlo a cualquier color que proporcione suficiente contraste con el primer plano.

Configurar un color de fondo personalizado es útil al colocar códigos QR en superficies de color o cuando desea que coincida con la paleta de colores de su marca. Solo asegúrese de que haya suficiente contraste para que los escáneres lean el código de manera confiable.

:path=/static-assets/qr/content-code-examples/how-to/implement-custom-qr-code-background.cs

using IronQr;
using IronSoftware.Drawing;

// Create a QR code
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");

// Set background color
QrStyleOptions styleOptions = new QrStyleOptions()
{
    BackgroundColor = Color.LightBlue
};

// Save QR code with custom background
AnyBitmap qrImage = qr.Save(styleOptions);
qrImage.SaveAs("qrBackgroundColor.png");

Imports IronQr
Imports IronSoftware.Drawing

' Create a QR code
Dim qr As QrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/")

' Set background color
Dim styleOptions As New QrStyleOptions() With {
    .BackgroundColor = Color.LightBlue
}

' Save QR code with custom background
Dim qrImage As AnyBitmap = qr.Save(styleOptions)
qrImage.SaveAs("qrBackgroundColor.png")

Cambiar el color de primer plano

El color de primer plano representa los módulos oscuros del código QR: el patrón de datos real que los escáneres leen. Aunque el negro es la elección estándar, puede usar cualquier color más oscuro que mantenga un buen contraste contra su fondo.

Cambiar el color de primer plano le permite incorporar el color primario de su marca en el diseño del código QR. Azules profundos, verdes oscuros o burdeos ricos funcionan bien como alternativas al negro.

:path=/static-assets/qr/content-code-examples/how-to/implement-custom-qr-code-foreground.cs

using IronQr;
using IronSoftware.Drawing;

// Create a QR code
QrCode qr = QrWriter.Write("https://ironsoftware.com/csharp/qr/");

// Set background color
QrStyleOptions styleOptions = new QrStyleOptions()
{
    Color = Color.PaleVioletRed
};

// Save QR code with custom background
AnyBitmap qrImage = qr.Save(styleOptions);
qrImage.SaveAs("qrBackgroundColor.png");

Imports IronQr
Imports IronSoftware.Drawing

' Create a QR code
Dim qr As QrCode = QrWriter.Write("https://ironsoftware.com/csharp/qr/")

' Set background color
Dim styleOptions As New QrStyleOptions() With {
    .Color = Color.PaleVioletRed
}

' Save QR code with custom background
Dim qrImage As AnyBitmap = qr.Save(styleOptions)
qrImage.SaveAs("qrBackgroundColor.png")

Conclusión

Personalizar los colores de los códigos QR con IronQR abre posibilidades creativas mientras mantiene sus códigos completamente funcionales:

• Color de fondo: Utilice BackgroundColor para cambiar el área más clara detrás del patrón QR
• Color de primer plano: Utilice Color para modificar los módulos oscuros que codifican sus datos
• Estilo combinado: Establezca ambas propiedades juntas para una alineación completa con la marca

Recuerde mantener un contraste adecuado entre los colores de primer plano y de fondo para garantizar un escaneo confiable en diferentes dispositivos y condiciones de iluminación.

Para más opciones de estilo, incluidos logotipos, márgenes y dimensiones, visite la documentación de IronQR o explore ejemplos de código adicionales en GitHub.

Aplicaciones regulatorias en España

En el mercado español, la personalización de colores en códigos QR está íntimamente ligada a requisitos normativos que van más allá de la identidad de marca. Conocer los límites regulatorios aplicables en cada sector evita costosos rediseños y garantiza la conformidad desde el primer despliegue.

*Contraste mínimo para el QR de AEAT / VERIFACTU.* El reglamento VERIFACTU (Real Decreto 1007/2023) no prescribe colores específicos, pero la AEAT requiere que el QR de verificación sea decodificable por cualquier aplicación de escáner estándar. La práctica recomendada es mantener una relación de contraste mínima de 4:1 entre el color de primer plano (módulos) y el color de fondo, medida según las pautas WCAG 2.1. Un azul corporativo oscuro (#003366) sobre fondo blanco (#FFFFFF) supera ampliamente este umbral y es totalmente compatible con los escáneres de la sede electrónica de la AEAT.

Personalización TicketBAI para proveedores vascos. Las haciendas forales de Bizkaia, Gipuzkoa y Araba permiten que el QR TicketBAI se integre en el diseño del ticket, siempre que el código sea legible. Los proveedores de software de TPV que sirven al comercio minorista y la hostelería del País Vasco suelen adoptar el color corporativo del cliente como primer plano del QR TicketBAI, con el logotipo de la empresa como fondo claro. QrStyleOptions con Color = Color.FromArgb(0, 88, 163) (azul BBVA o similar) y BackgroundColor = Color.White es una combinación habitual en las integraciones de ERP vasco.

DataMatrix farmacéutico: estándares GS1 y AEMPS. La Agencia Española de Medicamentos y Productos Sanitarios (AEMPS) gestiona el Sistema Español de Verificación de Medicamentos (SEVeM), que utiliza DataMatrix conforme a los estándares GS1. GS1 establece que los símbolos DataMatrix deben imprimirse en negro sobre fondo blanco para garantizar la máxima tasa de lectura en líneas de producción automatizadas. Cualquier desviación de color debe validarse con los lectores industriales del entorno de dispensación antes de su implantación.

SILICIE: codificación de color en el sector del alcohol. La AEAT gestiona el sistema SILICIE para el control de contadores de alcohol y tabaco. Los documentos de acompañamiento en este sector incluyen códigos de barras y QR cuyos colores están sujetos a los estándares de impresión de la Agencia Tributaria: fondo blanco y módulos negros o en color oscuro con contraste suficiente para la lectura óptica en almacenes y puntos de control.

using IronQr;
using IronSoftware.Drawing;

var qrCode = QrWriter.Write("https://batuz.eus/QRTBAI?id=TBAI-12345678A-290526-abcde");
var style = new QrStyleOptions
{
    Color = new Color(26, 46, 90),           // Azul marino corporativo
    BackgroundColor = new Color(253, 246, 227) // Fondo crema del ticket
};
qrCode.Save(style).SaveAs("ticketbai-qr.png");

using IronQr;
using IronSoftware.Drawing;

var qrCode = QrWriter.Write("https://batuz.eus/QRTBAI?id=TBAI-12345678A-290526-abcde");
var style = new QrStyleOptions
{
    Color = new Color(26, 46, 90),           // Azul marino corporativo
    BackgroundColor = new Color(253, 246, 227) // Fondo crema del ticket
};
qrCode.Save(style).SaveAs("ticketbai-qr.png");

Imports IronQr
Imports IronSoftware.Drawing

Dim qrCode = QrWriter.Write("https://batuz.eus/QRTBAI?id=TBAI-12345678A-290526-abcde")
Dim style = New QrStyleOptions With {
    .Color = New Color(26, 46, 90),           ' Azul marino corporativo
    .BackgroundColor = New Color(253, 246, 227) ' Fondo crema del ticket
}
qrCode.Save(style).SaveAs("ticketbai-qr.png")