AYUDA .NET

BinaryKits.Zpl.Viewer (Cómo funciona para desarrolladores)

Actualizado 24 de diciembre, 2023
Compartir:

Lenguaje de programación Zebra (ZPL) es un lenguaje de descripción de impresoras que se utiliza principalmente para imprimir etiquetas en las impresoras de etiquetas Zebra desarrolladas por Zebra Technologies. Proporciona un conjunto de comandos de datos ZPL ii que permiten a los usuarios formatear y controlar el contenido del archivo que se imprimirá en las etiquetas, como texto, códigos de barras, ancho de etiqueta y gráficos, junto con la capacidad de vista previa de impresión. Desarrollado por Zebra Technologies, se utiliza ampliamente en sectores en los que el etiquetado preciso y estandarizado es crucial, como la fabricación, la logística y la sanidad.

En diversas aplicaciones, ZPL se emplea para generar etiquetas de forma dinámica, garantizando una impresión precisa y uniforme para diversos fines. Es especialmente popular en situaciones en las que se requiere la impresión por lotes, la serialización o la personalización de etiquetas. Ahora que ya conocemos brevemente ZPL, vamos a adentrarnos en BinaryKits.Zpl.Viewer, una herramienta diseñada para facilitar la visualización y el análisis del código ZPL de los controladores de impresora. Además, el Labelary api puede utilizarse como alternativa a BinaryKits.Zpl.

En este artículo, vamos a convertir el código ZPL a PDF porque la mayoría de la impresora no es compatible con el código ZPL, pero PDF es compatible con todas las impresoras, incluso las impresoras de las tecnologías Zebra. La biblioteca PDF que utilizaremos para convertir ZPL a PDF es IronPDF.

1. Exploración de BinaryKits.Zpl.Viewer

En el ámbito de ZPL, una herramienta que destaca es el visor BinaryKits.Zpl Viewer. Este visor está diseñado para proporcionar a los desarrolladores una solución completa para visualizar y analizar el código ZPL. Sirve como un valioso recurso para entender cómo los comandos ZPL serán interpretados y ejecutados en impresoras Zebra con etiquetas Zebra.

El visor BinaryKits.Zpl ofrece una interfaz fácil de usar que permite a los desarrolladores enviar código de comando ZPL sin procesar y ver al instante la representación visual de la etiqueta o tag individual. Esta función de ZPL es especialmente útil para depurar y ajustar los scripts de ZPL, garantizando que la salida impresa se ajuste al diseño previsto.

1.1. Características principales

1.1.1. Visualización de archivos ZPL

BinaryKits.Zpl.Viewer permite a los usuarios abrir y visualizar archivos ZPL, proporcionando una visualización completa y organizada del contenido de las etiquetas. Presenta los comandos ZPL en un formato legible, lo que facilita la interpretación y la resolución de problemas en los diseños de etiquetas.

1.1.2. Resaltado de sintaxis

El visor incorpora resaltado de sintaxis para distinguir entre los distintos elementos del código ZPL, lo que mejora la legibilidad del código y lo hace más accesible para los usuarios.

1.1.3. Vista previa interactiva

Los usuarios pueden previsualizar interactivamente los diseños de etiquetas en la interfaz BinaryKits.Zpl.Viewer. Esta función ayuda a comprender el aspecto que tendrá la etiqueta cuando se imprima, lo que facilita el proceso de diseño y depuración.

1.1.4. Detección de errores

BinaryKits.Zpl.Viewer incluye capacidades de detección de errores, y la identificación de posibles problemas dentro del código ZPL. Esto ayuda a los usuarios a identificar y rectificar rápidamente los errores antes de enviar el código a la impresora Zebra.

2. Cómo utilizarlo

Para utilizar BinaryKits.Zpl.Viewer eficazmente, siga estos pasos:

2.1. Abrir archivo ZPL

Inicie la aplicación BinaryKits.Zpl.Viewer y abra el archivo deseado utilizando el explorador de archivos incorporado.

2.2. Navegar y analizar

Navegue por el código ZPL utilizando la sencilla interfaz del visor. Aproveche funciones como el resaltado de sintaxis y la vista previa interactiva para comprender el diseño de las etiquetas.

2.3. Ejemplo de código

He aquí un ejemplo sencillo de utilización de BinaryKits.Zpl.Viewer en C#:

using BinaryKits.Zpl.Viewer;
class Program
{
    static void Main()
    {
        //  Instanciar ZplViewer
        var zplViewer = new ZplViewer();
        //  Cargar archivo ZPL
        zplViewer.LoadFile("path/to/your/label.zpl");
        //  Visualizar el contenido de ZPL
        Console.WriteLine(zplViewer.GetContent());
        //  Cerrar el visor
        zplViewer.Close();
    }
}
using BinaryKits.Zpl.Viewer;
class Program
{
    static void Main()
    {
        //  Instanciar ZplViewer
        var zplViewer = new ZplViewer();
        //  Cargar archivo ZPL
        zplViewer.LoadFile("path/to/your/label.zpl");
        //  Visualizar el contenido de ZPL
        Console.WriteLine(zplViewer.GetContent());
        //  Cerrar el visor
        zplViewer.Close();
    }
}
Imports BinaryKits.Zpl.Viewer
Friend Class Program
	Shared Sub Main()
		'  Instanciar ZplViewer
		Dim zplViewer As New ZplViewer()
		'  Cargar archivo ZPL
		zplViewer.LoadFile("path/to/your/label.zpl")
		'  Visualizar el contenido de ZPL
		Console.WriteLine(zplViewer.GetContent())
		'  Cerrar el visor
		zplViewer.Close()
	End Sub
End Class
VB   C#

Este ejemplo muestra cómo utilizar la biblioteca BinaryKits.Zpl.Viewer para cargar un archivo ZPL, recuperar su contenido y, a continuación, cerrar el visor.

Al incorporar BinaryKits.Zpl.Viewer a su flujo de trabajo, puede agilizar el desarrollo y la resolución de problemas de las aplicaciones de impresión de etiquetas Zebra.

4. IronPDF y sus características

IronPDF es una potente biblioteca para manejar documentos PDF en aplicaciones .NET. Facilita la creación, modificación y manipulación de archivos PDF, ofreciendo a los desarrolladores un sólido conjunto de herramientas para integrar la funcionalidad PDF sin problemas en sus proyectos.

Algunas funciones destacables de IronPDF son la posibilidad de crear documentos PDF desde cero, convertir HTML e imágenes a PDF, extraer texto e imágenes de PDF y añadir anotaciones y campos de formulario a PDF existentes. Su versatilidad lo convierte en una excelente opción para los desarrolladores que trabajan en aplicaciones que requieren la generación y manipulación de PDF.

5. Convertir datos ZPL en imágenes e imágenes a PDF con IronPDF

Ahora, exploremos cómo BinaryKits.Zpl.Viewer puede integrarse perfectamente con IronPDF para convertir etiquetas generadas por ZPL en PDFs. El ejemplo de código proporcionado muestra un proceso paso a paso utilizando ambas bibliotecas. Este ejemplo es una simple creación de etiquetas de número máximo y su representación en PDF porque no todas las impresoras soportan el código ZPL. Las bibliotecas .NET utilizadas en este ejemplo son BinaryKits.Zpl.Viewer y IronPDF.

using BinaryKits.Zpl.Viewer;
using System.IO;
using IronPdf;
using System.Linq;
//  Inicializar los elementos ZPL y el almacenamiento de la impresora
IPrinterStorage printerStorage = new PrinterStorage();
var drawer = new ZplElementDrawer(printerStorage);
//  Inicializar el analizador ZPL y analizar el código ZPL
var analyzer = new ZplAnalyzer(printerStorage);
var analyzeInfo = analyzer.Analyze("^XA ^MMT ^PW812 ^LL0203 ^LS0^FO0,0^A0N,36,36^FB600,1,0,L,0^FD^FS ^FO53.592000000000006,23.142^PW0^LL0^A0N,36,36^FB620,10,0,C,0^FDTest will go here^FS^FO8.931999999999999,6.09^GB798.196,1205.82,3,B^FS^FO190.008,247.25400000000002^BQN,^PW0^LL02,10,Q,7^FDQA,False^FS^XZ");
//  Iterar a través de la información de la etiqueta y dibujar elementos ZPL
foreach (var labelInfo in analyzeInfo.LabelInfos)
{
    var imageData = drawer.Draw(labelInfo.ZplElements);
    File.WriteAllBytes("label.png", imageData);
}
//  Recupera archivos de imagen y conviértelos a PDF
var response = Directory.EnumerateFiles("").Where(f => f.EndsWith("label.png"));
ImageToPdfConverter.ImageToPdf(response).SaveAs("zpl.pdf");
using BinaryKits.Zpl.Viewer;
using System.IO;
using IronPdf;
using System.Linq;
//  Inicializar los elementos ZPL y el almacenamiento de la impresora
IPrinterStorage printerStorage = new PrinterStorage();
var drawer = new ZplElementDrawer(printerStorage);
//  Inicializar el analizador ZPL y analizar el código ZPL
var analyzer = new ZplAnalyzer(printerStorage);
var analyzeInfo = analyzer.Analyze("^XA ^MMT ^PW812 ^LL0203 ^LS0^FO0,0^A0N,36,36^FB600,1,0,L,0^FD^FS ^FO53.592000000000006,23.142^PW0^LL0^A0N,36,36^FB620,10,0,C,0^FDTest will go here^FS^FO8.931999999999999,6.09^GB798.196,1205.82,3,B^FS^FO190.008,247.25400000000002^BQN,^PW0^LL02,10,Q,7^FDQA,False^FS^XZ");
//  Iterar a través de la información de la etiqueta y dibujar elementos ZPL
foreach (var labelInfo in analyzeInfo.LabelInfos)
{
    var imageData = drawer.Draw(labelInfo.ZplElements);
    File.WriteAllBytes("label.png", imageData);
}
//  Recupera archivos de imagen y conviértelos a PDF
var response = Directory.EnumerateFiles("").Where(f => f.EndsWith("label.png"));
ImageToPdfConverter.ImageToPdf(response).SaveAs("zpl.pdf");
Imports BinaryKits.Zpl.Viewer
Imports System.IO
Imports IronPdf
Imports System.Linq
'  Inicializar los elementos ZPL y el almacenamiento de la impresora
Private printerStorage As IPrinterStorage = New PrinterStorage()
Private drawer = New ZplElementDrawer(printerStorage)
'  Inicializar el analizador ZPL y analizar el código ZPL
Private analyzer = New ZplAnalyzer(printerStorage)
Private analyzeInfo = analyzer.Analyze("^XA ^MMT ^PW812 ^LL0203 ^LS0^FO0,0^A0N,36,36^FB600,1,0,L,0^FD^FS ^FO53.592000000000006,23.142^PW0^LL0^A0N,36,36^FB620,10,0,C,0^FDTest will go here^FS^FO8.931999999999999,6.09^GB798.196,1205.82,3,B^FS^FO190.008,247.25400000000002^BQN,^PW0^LL02,10,Q,7^FDQA,False^FS^XZ")
'  Iterar a través de la información de la etiqueta y dibujar elementos ZPL
For Each labelInfo In analyzeInfo.LabelInfos
	Dim imageData = drawer.Draw(labelInfo.ZplElements)
	File.WriteAllBytes("label.png", imageData)
Next labelInfo
'  Recupera archivos de imagen y conviértelos a PDF
Dim response = Directory.EnumerateFiles("").Where(Function(f) f.EndsWith("label.png"))
ImageToPdfConverter.ImageToPdf(response).SaveAs("zpl.pdf")
VB   C#

Este código está escrito en C# y utiliza la librería BinaryKits.Zpl.Viewer para convertir Zebra Programming Language (ZPL) en una representación visual en forma de imágenes PNG y, a continuación, combina estas imágenes en un único documento PDF. He aquí una breve explicación del código

  1. **El código comienza importando las bibliotecas necesarias, incluyendo BinaryKits.Zpl.Viewer, IronPDF y System.IO.
  2. Inicialización: Inicializa elementos para impresión y almacenamiento ZPL utilizando la interfaz IPrinterStorage y un ZplElementDrawer. El ZplAnalyzer también está configurado para analizar código ZPL.
  3. Análisis ZPL: El código ZPL proporcionado se analiza utilizando el ZplAnalyzer. El resultado del análisis, almacenado en analyzeInfo, incluye información sobre varios elementos ZPL del código.
  4. Dibujo de imágenes: El código itera a través de la información de etiquetas obtenida del análisis y utiliza el ZplElementDrawer para dibujar elementos ZPL en una imagen. Cada imagen se guarda como un archivo PNG llamado "label.png".
  5. Conversión a PDF: Después de guardar las imágenes PNG individuales, el código recupera la lista de archivos de imagen en el directorio actual con nombres que terminan en "label.png". A continuación, utiliza la biblioteca IronPDF para convertir estos archivos PNG en un único documento PDF llamado "zpl.pdf."

Imagen de etiqueta de salida

BinaryKits.Zpl.Visor (Cómo funciona para desarrolladores): Figura 1 - Salida de imágenes

Etiqueta de salida PDF

BinaryKits.Zpl.Visor (Cómo funciona para desarrolladores): Figura 2 - Salida PDF

4. Conclusión

En conclusión, la combinación de BinaryKits.Zpl.Viewer e IronPDF ofrece una potente solución para los desarrolladores que trabajan con ZPL en aplicaciones .NET. El visor mejora el proceso de desarrollo al proporcionar una representación visual del código ZPL, lo que ayuda a la depuración y la comprensión. Cuando se integra con IronPDF, la transición de etiquetas generadas con ZPL a documentos PDF se realiza de forma fluida y eficaz, lo que amplía las posibilidades de crear sofisticadas soluciones de etiquetado en diversos sectores. A medida que la tecnología sigue avanzando, la sinergia entre bibliotecas como BinaryKits.Zpl.Viewer e IronPDF muestra la innovación y versatilidad que se puede conseguir en el desarrollo .NET moderno. Para más ejemplos de ZPL y ayudas a proyectos, visite aquí.

IronPDF ofrece licencia de prueba gratuita que es una gran oportunidad para que los usuarios conozcan su funcionalidad. Tutorial de conversión de imágenes a PDF con IronPDF aquí.

< ANTERIOR
Blazor .NET 8 (Tutorial para desarrolladores)
SIGUIENTE >
Destructor C# (Cómo funciona para desarrolladores)

¿Listo para empezar? Versión: 2024.7 recién publicada

Descarga gratuita de NuGet Descargas totales: 9,974,197 Ver licencias >
123