El Zebra Programming Language (ZPL) es un lenguaje de descripción de impresoras que se utiliza principalmente para imprimir etiquetas en 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 para imprimir en 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, es ampliamente utilizado en industrias donde el etiquetado preciso y estandarizado es crucial, como la manufactura, logística y la atención médica.

En varias aplicaciones, ZPL se emplea para generar etiquetas de forma dinámica, asegurando una impresión precisa y consistente para una variedad de propósitos. Es particularmente popular en escenarios donde se requiere impresión por lotes, serialización o personalización de etiquetas. Ahora que tenemos una comprensión breve de ZPL, profundicemos en BinaryKits.Zpl.Viewer, una herramienta diseñada para facilitar la visualización y análisis del código del controlador de impresora ZPL. Además, la API de Labelary para visualización de ZPL se puede utilizar como una alternativa a BinaryKits.Zpl.

En este artículo, convertiremos código ZPL a PDF porque la mayoría de las impresoras no admiten el código ZPL, pero el PDF es compatible con todas las impresoras, incluso aquellas de Zebra Technologies. La biblioteca PDF que usaremos para convertir ZPL a PDF es IronPDF - la biblioteca PDF for .NET.

1. Explorando BinaryKits.Zpl.Viewer

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

El Visualizador BinaryKits.Zpl ofrece una interfaz fácil de usar que permite a los desarrolladores enviar código de comando bruto ZPL y ver instantáneamente la representación visual de la etiqueta o ficha única. Esta función ZPL es particularmente útil para depurar y ajustar scripts ZPL, asegurando que la salida impresa se alinee con el 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 ver archivos ZPL, proporcionando una visualización completa y organizada del contenido de la etiqueta. Rinde los comandos ZPL en un formato legible, lo que facilita la interpretación y resolución de problemas de los diseños de etiquetas.

1.1.2. Resaltado de sintaxis

El visor incorpora resaltado de sintaxis para distinguir entre diferentes elementos del código ZPL, mejorando la legibilidad del código y haciéndolo más accesible para los usuarios.

1.1.3. Vista previa interactiva

Los usuarios pueden previsualizar interactivamente diseños de etiquetas dentro de la interfaz de BinaryKits.Zpl.Viewer. Esta función ayuda a entender cómo aparecerá la etiqueta cuando se imprima, apoyando en 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, identificando posibles problemas dentro del código ZPL. Esto ayuda a los usuarios a identificar y corregir rápidamente errores antes de enviar el código a la impresora Zebra.

2. Cómo utilizar

Para utilizar BinaryKits.Zpl.Viewer de manera efectiva, sigue estos pasos:

2.1. Abrir archivo ZPL

Inicia la aplicación BinaryKits.Zpl.Viewer y abre el archivo deseado usando el explorador de archivos incorporado.

2.2. Navegar y analizar

Navega a través del código ZPL utilizando la interfaz fácil de usar del visor. Aprovecha funciones como el resaltado de sintaxis y la vista previa interactiva para comprender el diseño de la etiqueta.

2.3. Ejemplo de código

Aquí hay un ejemplo simple de cómo usar BinaryKits.Zpl.Viewer en C#:

using BinaryKits.Zpl.Viewer;
using System;

class Program
{
    static void Main()
    {
        // Instantiate ZplViewer
        var zplViewer = new ZplViewer();

        // Load the ZPL file
        zplViewer.LoadFile("path/to/your/label.zpl");

        // Display the ZPL content in the console
        Console.WriteLine(zplViewer.GetContent());

        // Close the viewer after use
        zplViewer.Close();
    }
}

using BinaryKits.Zpl.Viewer;
using System;

class Program
{
    static void Main()
    {
        // Instantiate ZplViewer
        var zplViewer = new ZplViewer();

        // Load the ZPL file
        zplViewer.LoadFile("path/to/your/label.zpl");

        // Display the ZPL content in the console
        Console.WriteLine(zplViewer.GetContent());

        // Close the viewer after use
        zplViewer.Close();
    }
}

Imports BinaryKits.Zpl.Viewer
Imports System

Friend Class Program
	Shared Sub Main()
		' Instantiate ZplViewer
		Dim zplViewer As New ZplViewer()

		' Load the ZPL file
		zplViewer.LoadFile("path/to/your/label.zpl")

		' Display the ZPL content in the console
		Console.WriteLine(zplViewer.GetContent())

		' Close the viewer after use
		zplViewer.Close()
	End Sub
End Class

Imports BinaryKits.Zpl.Viewer
Imports System

Friend Class Program
	Shared Sub Main()
		' Instantiate ZplViewer
		Dim zplViewer As New ZplViewer()

		' Load the ZPL file
		zplViewer.LoadFile("path/to/your/label.zpl")

		' Display the ZPL content in the console
		Console.WriteLine(zplViewer.GetContent())

		' Close the viewer after use
		zplViewer.Close()
	End Sub
End Class

Este ejemplo demuestra cómo usar la biblioteca BinaryKits.Zpl.Viewer para cargar un archivo ZPL, recuperar su contenido y luego cerrar el visor.

Al incorporar BinaryKits.Zpl.Viewer en tu flujo de trabajo, puedes optimizar el desarrollo y solución de problemas de aplicaciones de impresión de etiquetas Zebra.

4. IronPDF y sus características

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

Algunas características notables de IronPDF incluyen la capacidad de crear documentos PDF desde cero, convertir HTML e imágenes a PDF, extraer texto e imágenes de PDFs, y agregar anotaciones y campos de formulario a PDFs existentes. Su versatilidad lo convierte en una excelente opción para desarrolladores que trabajan en aplicaciones que requieren generación y manipulación de PDFs.

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

Ahora, exploremos cómo BinaryKits.Zpl.Viewer puede integrarse sin problemas con IronPDF para convertir etiquetas generadas por ZPL en PDFs. El ejemplo de código proporcionado demuestra un proceso paso a paso utilizando ambas bibliotecas. Este ejemplo es una creación simple de la máxima cantidad de etiquetas y su representación PDF porque no todas las impresoras admiten código ZPL. Las bibliotecas .NET utilizadas en este ejemplo son BinaryKits.Zpl.Viewer e IronPDF.

using BinaryKits.Zpl.Viewer;
using System.IO;
using IronPdf;
using System.Linq;

class Program
{
    static void Main()
    {
        // Initialize printer storage for ZPL elements
        IPrinterStorage printerStorage = new PrinterStorage();

        // Create an instance of ZplElementDrawer using the printer storage
        var drawer = new ZplElementDrawer(printerStorage);

        // Initialize ZPL analyzer and analyze ZPL code
        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.592,23.142^PW0^LL0^A0N,36,36^FB620,10,0,C,0^FDTest will go here^FS^FO8.932,6.09^GB798.196,1205.82,3,B^FS^FO190.008,247.254^BQN,^PW0^LL02,10,Q,7^FDQA,False^FS^XZ");

        // Iterate through label information and draw ZPL elements
        foreach (var labelInfo in analyzeInfo.LabelInfos)
        {
            // Draw the ZPL elements into an image
            var imageData = drawer.Draw(labelInfo.ZplElements);

            // Write the image data to a PNG file
            File.WriteAllBytes("label.png", imageData);
        }

        // Retrieve image files and convert them to a single PDF
        var imageFiles = Directory.EnumerateFiles("").Where(f => f.EndsWith("label.png"));
        ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("zpl.pdf");
    }
}

using BinaryKits.Zpl.Viewer;
using System.IO;
using IronPdf;
using System.Linq;

class Program
{
    static void Main()
    {
        // Initialize printer storage for ZPL elements
        IPrinterStorage printerStorage = new PrinterStorage();

        // Create an instance of ZplElementDrawer using the printer storage
        var drawer = new ZplElementDrawer(printerStorage);

        // Initialize ZPL analyzer and analyze ZPL code
        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.592,23.142^PW0^LL0^A0N,36,36^FB620,10,0,C,0^FDTest will go here^FS^FO8.932,6.09^GB798.196,1205.82,3,B^FS^FO190.008,247.254^BQN,^PW0^LL02,10,Q,7^FDQA,False^FS^XZ");

        // Iterate through label information and draw ZPL elements
        foreach (var labelInfo in analyzeInfo.LabelInfos)
        {
            // Draw the ZPL elements into an image
            var imageData = drawer.Draw(labelInfo.ZplElements);

            // Write the image data to a PNG file
            File.WriteAllBytes("label.png", imageData);
        }

        // Retrieve image files and convert them to a single PDF
        var imageFiles = Directory.EnumerateFiles("").Where(f => f.EndsWith("label.png"));
        ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("zpl.pdf");
    }
}

Imports BinaryKits.Zpl.Viewer
Imports System.IO
Imports IronPdf
Imports System.Linq

Friend Class Program
	Shared Sub Main()
		' Initialize printer storage for ZPL elements
		Dim printerStorage As IPrinterStorage = New PrinterStorage()

		' Create an instance of ZplElementDrawer using the printer storage
		Dim drawer = New ZplElementDrawer(printerStorage)

		' Initialize ZPL analyzer and analyze ZPL code
		Dim analyzer = New ZplAnalyzer(printerStorage)
		Dim analyzeInfo = analyzer.Analyze("^XA ^MMT ^PW812 ^LL0203 ^LS0^FO0,0^A0N,36,36^FB600,1,0,L,0^FD^FS ^FO53.592,23.142^PW0^LL0^A0N,36,36^FB620,10,0,C,0^FDTest will go here^FS^FO8.932,6.09^GB798.196,1205.82,3,B^FS^FO190.008,247.254^BQN,^PW0^LL02,10,Q,7^FDQA,False^FS^XZ")

		' Iterate through label information and draw ZPL elements
		For Each labelInfo In analyzeInfo.LabelInfos
			' Draw the ZPL elements into an image
			Dim imageData = drawer.Draw(labelInfo.ZplElements)

			' Write the image data to a PNG file
			File.WriteAllBytes("label.png", imageData)
		Next labelInfo

		' Retrieve image files and convert them to a single PDF
		Dim imageFiles = Directory.EnumerateFiles("").Where(Function(f) f.EndsWith("label.png"))
		ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("zpl.pdf")
	End Sub
End Class

Imports BinaryKits.Zpl.Viewer
Imports System.IO
Imports IronPdf
Imports System.Linq

Friend Class Program
	Shared Sub Main()
		' Initialize printer storage for ZPL elements
		Dim printerStorage As IPrinterStorage = New PrinterStorage()

		' Create an instance of ZplElementDrawer using the printer storage
		Dim drawer = New ZplElementDrawer(printerStorage)

		' Initialize ZPL analyzer and analyze ZPL code
		Dim analyzer = New ZplAnalyzer(printerStorage)
		Dim analyzeInfo = analyzer.Analyze("^XA ^MMT ^PW812 ^LL0203 ^LS0^FO0,0^A0N,36,36^FB600,1,0,L,0^FD^FS ^FO53.592,23.142^PW0^LL0^A0N,36,36^FB620,10,0,C,0^FDTest will go here^FS^FO8.932,6.09^GB798.196,1205.82,3,B^FS^FO190.008,247.254^BQN,^PW0^LL02,10,Q,7^FDQA,False^FS^XZ")

		' Iterate through label information and draw ZPL elements
		For Each labelInfo In analyzeInfo.LabelInfos
			' Draw the ZPL elements into an image
			Dim imageData = drawer.Draw(labelInfo.ZplElements)

			' Write the image data to a PNG file
			File.WriteAllBytes("label.png", imageData)
		Next labelInfo

		' Retrieve image files and convert them to a single PDF
		Dim imageFiles = Directory.EnumerateFiles("").Where(Function(f) f.EndsWith("label.png"))
		ImageToPdfConverter.ImageToPdf(imageFiles).SaveAs("zpl.pdf")
	End Sub
End Class

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

1. Importación de Bibliotecas: El código comienza importando las bibliotecas necesarias, incluyendo BinaryKits.Zpl.Viewer, IronPDF y System.IO.
2. Inicialización: Se inicializan elementos para la impresión y almacenamiento de ZPL usando la interfaz IPrinterStorage y un ZplElementDrawer. El ZplAnalyzer también está configurado para analizar código ZPL.
3. Análisis de 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 en el código.
4. Dibujo de Imágenes: Luego, 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 sobre una imagen. Cada imagen se guarda como un archivo PNG llamado "label.png".
5. Conversión a PDF: Después de guardar 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". Luego, utiliza la biblioteca IronPDF para convertir estos archivos PNG en un único documento PDF llamado "zpl.pdf".

Imagen de etiqueta de salida

Etiqueta de salida PDF

4. Conclusión

En conclusión, la combinación de BinaryKits.Zpl.Viewer e IronPDF ofrece una solución poderosa para 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, ayudando en la depuración y comprensión. Cuando se integra con IronPDF, la transición de etiquetas generadas por ZPL a documentos PDF se vuelve fluida y eficiente, ampliando las posibilidades para crear soluciones de etiquetado sofisticadas en diversas industrias. A medida que la tecnología continúa avanzando, la sinergia entre bibliotecas como BinaryKits.Zpl.Viewer e IronPDF demuestra la innovación y versatilidad alcanzables en el desarrollo moderno de .NET. Para más ejemplos de ZPL y soporte de proyectos visita el Repositorio de GitHub de BinaryKits.Zpl.

IronPDF ofrece una licencia de prueba gratuita para desarrolladores que es una gran oportunidad para que los usuarios conozcan su funcionalidad. Un tutorial detallado de conversión de Imagen a PDF usando IronPDF puede guiar a los desarrolladores en la implementación de esta funcionalidad en sus aplicaciones.