Cómo añadir márgenes a los códigos QR

This article was translated from English: Does it need improvement?
Translated
View the article in English

Escalar correctamente un código QR es un paso vital para equilibrar el impacto visual con la legibilidad técnica en la publicidad de una marca. Para lograrlo, el uso de márgenes (a menudo denominados "zonas tranquilas") mejora la legibilidad del código QR y garantiza que los dispositivos de escaneado reconozcan el código correctamente dentro de diseños únicos. Los ajustes específicos de anchura, altura y escala general influyen directamente en la relación de salida final y la presentación visual.

Esta guía demuestra cómo utilizar los márgenes para redimensionar y enmarcar eficazmente su código QR con IronQR, garantizando un ajuste perfecto para cualquier diseño profesional.

Añadir márgenes al código QR

Se puede establecer una zona de silencio adecuada configurando la propiedad Margins dentro de la clase QrStyleOptions. Esta propiedad acepta un único número entero que define un borde en blanco uniforme alrededor de los cuatro lados del código QR.

En este ejemplo, definimos una configuración de estilo con un margen de 40 píxeles, aplicamos esta configuración al código QR durante el proceso de renderizado y, a continuación, guardamos la imagen resultante como archivo PNG.

:path=/static-assets/qr/content-code-examples/how-to/add-margins-qr-code.cs
using IronQr;
using IronSoftware.Drawing;

QrStyleOptions styleOptions = new QrStyleOptions
{
    // Set all margins to 40px
    Margins = 40,

};

string url = "https://ironsoftware.com/csharp/qr/";

// Create QR code
QrCode qr = QrWriter.Write(url);

// Save QR code as a bitmap using the style options
AnyBitmap qrImage = qr.Save(styleOptions);

// Save QR code bitmap as file
qrImage.SaveAs("qr-uniform-margins.png");
Imports IronQr
Imports IronSoftware.Drawing

Dim styleOptions As New QrStyleOptions With {
    .Margins = 40
}

Dim url As String = "https://ironsoftware.com/csharp/qr/"

' Create QR code
Dim qr As QrCode = QrWriter.Write(url)

' Save QR code as a bitmap using the style options
Dim qrImage As AnyBitmap = qr.Save(styleOptions)

' Save QR code bitmap as file
qrImage.SaveAs("qr-uniform-margins.png")
$vbLabelText   $csharpLabel

Resultado

Código QR de la zona tranquila

Añadir márgenes a lados específicos

Para diseños asimétricos, utilice las propiedades MarginTop, MarginBottom, MarginLeft y MarginRight dentro de QrStyleOptions. De este modo, se controla con precisión cada lado de la zona de silencio de forma independiente.

En este ejemplo, se definen valores personalizados para cada margen junto con dimensiones específicas y un color de fondo.

:path=/static-assets/qr/content-code-examples/how-to/add-specific-margins-qr-code.cs
using IronQr;
using IronSoftware.Drawing;

// Configure QR code styling with individual margins and background color
QrStyleOptions combinedOptions = new QrStyleOptions
{
    Dimensions = 400,
    MarginTop = 50,
    MarginBottom = 50,
    MarginLeft = 20,
    MarginRight = 20,
    BackgroundColor = IronSoftware.Drawing.Color.LightYellow,
};

string url = "https://ironsoftware.com/";

// Generate QR code from URL
QrCode qrCombined = QrWriter.Write(url);

// Apply styling options and export as bitmap
AnyBitmap qrCombinedImage = qrCombined.Save(combinedOptions);

// Save QR code to file
qrCombinedImage.SaveAs("qr-custom-margins.png");
Imports IronQr
Imports IronSoftware.Drawing

' Configure QR code styling with individual margins and background color
Dim combinedOptions As New QrStyleOptions With {
    .Dimensions = 400,
    .MarginTop = 50,
    .MarginBottom = 50,
    .MarginLeft = 20,
    .MarginRight = 20,
    .BackgroundColor = IronSoftware.Drawing.Color.LightYellow
}

Dim url As String = "https://ironsoftware.com/"

' Generate QR code from URL
Dim qrCombined As QrCode = QrWriter.Write(url)

' Apply styling options and export as bitmap
Dim qrCombinedImage As AnyBitmap = qrCombined.Save(combinedOptions)

' Save QR code to file
qrCombinedImage.SaveAs("qr-custom-margins.png")
$vbLabelText   $csharpLabel

Resultado

Como puede verse, los márgenes verticales son visiblemente mayores que los horizontales.

Espaciado de márgenes selectivo

Códigos QR generados con márgenes añadidos

Código QR de Quiet Zone
Espaciado selectivo de márgenes

Preguntas Frecuentes

¿Qué son los márgenes de un código QR?

Los márgenes, también conocidos como zonas tranquilas, son los espacios en blanco que rodean un código QR. Ayudan a mejorar la legibilidad y garantizan que los dispositivos de escaneado puedan reconocer fácilmente el código.

¿Cómo afectan los márgenes al escaneado de códigos QR?

Los márgenes ayudan a garantizar que los dispositivos de escaneado puedan leer correctamente el código QR al proporcionar una zona de amortiguación que evita que los elementos visuales cercanos interfieran en la legibilidad del código.

¿Cómo puedo añadir márgenes a un código QR en C#?

Puede añadir márgenes a un código QR en C# utilizando la biblioteca IronQR. Configurando la propiedad `Margins` dentro de la clase `QrStyleOptions`, puede definir un borde en blanco uniforme alrededor del código QR.

¿Puedo aplicar márgenes diferentes a cada lado de un código QR?

Sí, con IronQR, puede utilizar propiedades como `MarginTop`, `MarginBottom`, `MarginLeft` y `MarginRight` para aplicar márgenes diferentes a cada lado del código QR para diseños asimétricos.

¿Para qué sirve la clase `QrStyleOptions` en IronQR?

La clase `QrStyleOptions` en IronQR le permite personalizar la apariencia de su código QR, incluyendo la configuración de márgenes, dimensiones y otras opciones de estilo para un diseño profesional.

¿Cómo puedo guardar como imagen un código QR con márgenes añadidos?

Después de configurar su código QR con los márgenes deseados utilizando IronQR, puede renderizarlo y guardarlo como un archivo de imagen, como PNG, para uso externo.

¿Por qué debería utilizar IronQR para añadir márgenes de código QR?

IronQR proporciona una forma sencilla y eficaz de personalizar los márgenes de los códigos QR y otras opciones de estilo en C#, garantizando un ajuste perfecto para cualquier diseño profesional o de marca.

¿Es posible establecer un color de fondo para los códigos QR en IronQR?

Sí, IronQR permite establecer un color de fondo para los códigos QR, lo que mejora el atractivo visual al tiempo que mantiene la legibilidad.

¿En qué tipos de archivo puedo guardar los códigos QR con IronQR?

Con IronQR, puede guardar códigos QR como varios tipos de archivos de imagen, como PNG, para un uso versátil en diferentes aplicaciones y plataformas.

Ahmad Sohail
Desarrollador Full Stack

Ahmad es un desarrollador full-stack con una sólida base en C#, Python y tecnologías web. Tiene un profundo interés en construir soluciones de software escalables y disfruta explorando cómo el diseño y la funcionalidad se encuentran en aplicaciones del mundo real.

Antes ...

Leer más
¿Listo para empezar?
Nuget Descargas 58,270 | Versión: 2026.2 recién lanzado