Cómo crear imágenes de códigos de barras

Hairil related to Cómo crear imágenes de códigos de barras
Hairil Hasyimi Bin Omar
19 de marzo, 2023
Actualizado 17 de diciembre, 2024
Compartir:
This article was translated from English: Does it need improvement?
Translated
View the article in English


Generar códigos de barras y guardar como archivos de imagen

Además de leer códigos de barras, IronBarcode es una herramienta poderosa que también permite a los usuarios escribir códigos de barras con una codificación muy mínima. Para lograr esto, simplemente llama al método CreateBarcode() de la clase BarcodeWriter, donde se pueden especificar los valor, tipo, ancho y alto del código de barras en los parámetros del método. Esto genera un objeto GeneratedBarcode, que luego se puede guardar como un archivo de imagen usando el método SaveAs(). Analicemos cada parámetro en detalle y luego veamos cómo implementar la escritura de códigos de barras con un fragmento de código.

Valor del código de barras

El método BarcodeWriter.CreateBarcode() acepta múltiples tipos de datos para valores de código de barras. Estos incluyen byte[] array, MemoryStream y string. Las longitudes de la cadena y qué caracteres son aceptados varían según el tipo de código de barras, pero todo esto está detallado en nuestra documentación.

Tipos de codificación de códigos de barras

IronBarcode admite una amplia variedad de formatos de código de barras para escritura; la lista completa se puede encontrar en nuestro artículo de Formatos de Código de Barras Admitidos. Estos tipos de código de barras tienen sus propias propiedades, especialidades y usos únicos; puede investigar cuál es el más adecuado para su caso de uso con nuestra documentación.

Anchura y altura

Establezca el ancho y la altura de la imagen del código de barras de salida en píxeles. Por defecto, ambas medidas están establecidas en 250 px. Varios tipos de códigos de barras, como QR y PDF417, requieren tener ciertas dimensiones para ser compatibles, por lo que para anchos y alturas de entrada que no coincidan con las dimensiones requeridas del código de barras, el código de barras se generará en las dimensiones compatibles y el espacio en blanco llenará el espacio restante. Si las dimensiones son demasiado pequeñas para el código de barras, se generará una excepción.

Importar códigos de barras como imagen

Al crear un código de barras con el método BarcodeWriter.CreateBarcode(), se generará un objeto GeneratedBarcode. Con este objeto, podemos guardar el código de barras en una variedad de tipos de imagen con varios métodos SaveAs() específicos para cada formato de imagen. Estos métodos incluyen:

  • SaveAsGif(): Este método guarda el GeneratedBarcode como un archivo de imagen GIF y acepta la ruta del archivo de imagen como argumento de cadena.
  • SaveAsJpeg(): Este método guarda el GeneratedBarcode como un archivo de imagen JPEG y acepta la ruta del archivo de imagen como argumento de cadena.
  • SaveAsPng(): Este método guarda el GeneratedBarcode como un archivo de imagen PNG y acepta la ruta del archivo de imagen como argumento de cadena.
  • SaveAsTiff(): Este método guarda el GeneratedBarcode como un archivo de imagen TIFF y acepta la ruta del archivo de imagen como un argumento de cadena.
  • SaveAsWindowsBitmap(): Este método guarda el GeneratedBarcode como un archivo de imagen BMP y acepta la ruta del archivo de imagen como argumento de cadena.
  • SaveAsImage(): Este es un método general para guardar el GeneratedBarcode como un archivo de imagen: los usuarios deben especificar la extensión del formato de archivo deseado al ingresar la ruta del archivo.

Generar un código de barras y guardar como archivo de imagen

Ahora usaremos BarcodeWriter.CreateBarcode() para demostrar la creación de un código de barras Code128 y guardarlo en el disco como un archivo de imagen JPEG.

:path=/static-assets/barcode/content-code-examples/how-to/create-barcode-images-one-dimensional.cs
using IronBarCode;

BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg");
Imports IronBarCode

BarcodeWriter.CreateBarcode("IronBarcode123", BarcodeEncoding.Code128, 200, 100).SaveAsJpeg("OneDBarcode.jpeg")
$vbLabelText   $csharpLabel
Código de barras unidimensional del fragmento

Generar códigos QR y guardar como archivos de imagen

Uno de los códigos de barras más populares hoy en día, código QR, que también es uno de los códigos de barras clasificados como código de barras bidimensional está totalmente soportado por IronBarcode. Debido a su versatilidad, atractivo estético y características altamente personalizables, los códigos QR han ganado gran popularidad entre los usuarios.

Diferente de la creación de códigos de barras unidimensionales y otros, la creación de códigos QR utilizará un método diferente de una clase distinta en IronBarcode debido a la complejidad de los códigos QR, que requiere diferentes propiedades y argumentos para producir códigos QR de alta calidad según lo solicitado por los clientes. Para crear códigos QR en IronBarcode, los usuarios necesitarán llamar al método CreateQrCode() de la clase QRCodeWriter. El método QRCodeWriter.CreateQrCode() acepta 4 argumentos, donde el valor del código de barras es el primer argumento, el tamaño del código QR de salida es el segundo, el campo enum QRCodeWriter.QrErrorCorrectionLevel es el tercer argumento y, por último, está el QRVersion. Analicemos en detalle los argumentos a favor de este método.

Valores del código QR

Al igual que el método BarcodeWriter.CreateBarcode(), QRCodeWriter.CreateQrCode() primero acepta un valor para el código QR que puede ser numérico, alfabético o alfanumérico. Estos valores se pueden introducir dentro del método como matriz de byte [], MemoryStream y tipo System.String.

Tamaño del código QR

Los usuarios también pueden especificar el tamaño del código QR directamente en el método como tipo Int32. La unidad de medida para el tamaño del código QR utilizada en este método está en píxeles(px). El tamaño predeterminado del código QR es de 500 px.

Nivel de corrección de errores QR

QRErrorCorrectionLevel es una propiedad miembro de la clase QRCodeWriter que tiene 4 campos, que son Highest, High, Medium y Low. Básicamente, esta propiedad es el nivel de tolerancia a fallos de un código QR, en el que un mayor nivel de corrección crea códigos QR más complejos que son menos propensos a errores de lectura, incluso si está dañado, o parcialmente oscurecido. Ahora, vamos a discutir en detalle cada uno de los campos de esta propiedad, así como ver la diferencia en el aspecto del código QR producido.

QRErrorCorrectionLevel.Highest

Los códigos QR generados con el nivel de corrección máximo tendrán la imagen de código QR más compleja, en la cual el 30% es corrección de errores. El código QR producido también se puede estampar con logotipos o imágenes gráficas en el código QR.

Código QR con el máximo nivel de corrección

QRErrorCorrectionLevel.High

Establecer el campo de propiedad en Alto resultará en la aplicación de un 25% de corrección de errores en la imagen del código QR. Será menos complejo que la imagen del código QR producida a partir de QRErrorCorrectionLevel.Highest.

Código QR con alto nivel de corrección

QRErrorCorrectionLevel.Medium

Este campo sólo aplica un 15% de corrección de errores en la imagen del código QR. Utilizando esta configuración, los usuarios conseguirán producir el código QR más rápido, sin embargo, más propenso a errores.

Código QR con nivel de corrección medio

QRErrorCorrectionLevel.Low

Esta es la configuración más baja para el nivel de corrección de errores, que sólo aplica un 7% de corrección de errores en la imagen del código QR y produce el código QR menos complejo.

Código QR con nivel de corrección bajo

QrVersion

La versión QR es la versión simbólica del código QR que va de 1 a 40. Una versión QR más alta producirá un código QR más complejo, que permitirá a los usuarios almacenar más datos, y viceversa para la versión más baja del código QR. Sin embargo, ten en cuenta que si la versión del QR es demasiado baja, pueden producirse problemas cuando los usuarios intenten codificar más datos de los permitidos por la versión. Si se establece la versión QR como 0, se asignará automáticamente la versión QR adecuada en función del valor que se vaya a codificar. Consulte este sitio para obtener más información sobre la versión QR: Versión QR

Crear una imagen de código QR

El fragmento de código a continuación demuestra cómo utilizar el método QRCodeWriter.CreateQrCode() en IronBarcode para escribir un código QR y guardarlo como un archivo de imagen en el disco utilizando el método SaveAsJpeg().

:path=/static-assets/barcode/content-code-examples/how-to/create-barcode-images-qr.cs
using IronBarCode;

QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion: 0).SaveAsJpeg("QRMedium.jpeg");
Imports IronBarCode

QRCodeWriter.CreateQrCode("IronBarcode1234", 250, QRCodeWriter.QrErrorCorrectionLevel.Medium, qrVersion:= 0).SaveAsJpeg("QRMedium.jpeg")
$vbLabelText   $csharpLabel
Código QR con nivel de corrección medio

A partir del fragmento de código anterior, se utilizó un valor alfanumérico como valor a codificar en el código QR, y utilizamos 250 píxeles como medida del código QR producido. También especificamos que la corrección de errores del código QR producido sea media y dejamos que el programa decida qué versión de código QR es adecuada para nuestro valor de código QR. Aparte de eso, también adjuntamos SaveAsJpeg() que acepta el nombre del archivo de imagen del código QR con la extensión del formato de imagen, que es un JPEG en este caso, para ser guardado como argumento.

Hairil related to Crear una imagen de código QR
Ingeniero de software
Como todos los grandes ingenieros, Hairil es un ávido aprendiz. Está perfeccionando sus conocimientos de C#, Python y Java, y los utiliza para añadir valor a los miembros del equipo de Iron Software. Hairil se unió al equipo de Iron Software desde la Universiti Teknologi MARA de Malasia, donde se licenció en Ingeniería Química y de Procesos.