A Linguagem de Programação Zebra (ZPL) é uma linguagem de descrição de impressoras usada principalmente para imprimir etiquetas em impressoras de etiquetas Zebra, desenvolvidas pela Zebra Technologies. Ele fornece um conjunto de comandos de dados ZPL II que permitem aos usuários formatar e controlar o conteúdo do arquivo a ser impresso em etiquetas, como texto, códigos de barras, largura da etiqueta e gráficos, além da funcionalidade de visualização de impressão. Desenvolvida pela Zebra Technologies, é amplamente utilizada em setores onde a rotulagem precisa e padronizada é crucial, como manufatura, logística e saúde.

Em diversas aplicações, a tecnologia ZPL é utilizada para gerar etiquetas dinamicamente, garantindo uma impressão precisa e consistente para uma variedade de finalidades. É particularmente popular em cenários onde são necessárias impressão em lote, serialização ou personalização de etiquetas. Agora que temos uma breve compreensão do ZPL, vamos explorar o BinaryKits.Zpl.Viewer, uma ferramenta projetada para facilitar a visualização e análise do código do driver de impressora ZPL. Além disso, a API Labelary para visualização de ZPL pode ser usada como uma alternativa ao BinaryKits.Zpl.

Neste artigo, vamos converter o código ZPL para PDF, pois a maioria das impressoras não suporta o código ZPL, enquanto o PDF é suportado por todas as impressoras, inclusive as da Zebra Technologies. A biblioteca PDF que usaremos para converter ZPL em PDF é o IronPDF - a biblioteca PDF for .NET .

1. Explorando o BinaryKits.Zpl.Viewer

No reino do ZPL, uma ferramenta que se destaca é o BinaryKits.Zpl Viewer. Este visualizador foi projetado para fornecer aos desenvolvedores uma solução completa para visualizar e analisar o código ZPL. Serve como um recurso valioso para entender como os comandos ZPL serão interpretados e executados em impressoras Zebra com etiquetas Zebra.

O BinaryKits.Zpl Viewer oferece uma interface amigável que permite aos desenvolvedores enviar código de comando ZPL bruto e visualizar instantaneamente a representação visual do rótulo ou tag individual. Este recurso do ZPL é particularmente útil para depurar e ajustar scripts ZPL, garantindo que a saída impressa esteja alinhada com o projeto pretendido.

1.1. Principais Características

1.1.1. Visualização de Arquivos ZPL

O BinaryKits.Zpl.Viewer permite que os usuários abram e visualizem arquivos ZPL, fornecendo uma exibição abrangente e organizada do conteúdo do rótulo. Ele renderiza os comandos ZPL em um formato legível, facilitando a interpretação e a resolução de problemas nos projetos de etiquetas.

1.1.2. Realce de sintaxe

O visualizador incorpora o realce de sintaxe para distinguir entre diferentes elementos do código ZPL, melhorando a legibilidade do código e tornando-o mais acessível aos usuários.

1.1.3. Pré-visualização interativa

Os usuários podem pré-visualizar interativamente projetos de etiquetas dentro da interface BinaryKits.Zpl.Viewer. Essa funcionalidade ajuda a entender como a etiqueta ficará impressa, auxiliando no processo de design e depuração.

1.1.4. Detecção de erros

O BinaryKits.Zpl.Viewer inclui recursos de detecção de erros, identificando possíveis problemas no código ZPL. Isso ajuda os usuários a identificar e corrigir erros rapidamente antes de enviar o código para a impressora Zebra.

2. Como usar

Para utilizar o BinaryKits.Zpl.Viewer de forma eficaz, siga estes passos:

2.1. Abrir arquivo ZPL

Inicie o aplicativo BinaryKits.Zpl.Viewer e abra o arquivo desejado usando o explorador de arquivos integrado.

2.2. Navegar e analisar

Navegue pelo código ZPL usando a interface amigável do visualizador. Utilize recursos como realce de sintaxe e pré-visualização interativa para compreender o design do rótulo.

2.3. Exemplo de código

Aqui está um exemplo simples de como usar BinaryKits.Zpl.Viewer em 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 exemplo demonstra como usar a biblioteca BinaryKits.Zpl.Viewer para carregar um arquivo ZPL, recuperar seu conteúdo e, em seguida, fechar o visualizador.

Ao incorporar o BinaryKits.Zpl.Viewer ao seu fluxo de trabalho, você pode agilizar o desenvolvimento e a resolução de problemas em aplicativos de impressão de etiquetas Zebra.

4. IronPDF e suas funcionalidades

IronPDF é uma biblioteca poderosa para manipulação de documentos PDF em aplicações .NET . Ele facilita a criação, modificação e manipulação de arquivos PDF, oferecendo aos desenvolvedores um conjunto robusto de ferramentas para integrar a funcionalidade de PDF perfeitamente em seus projetos.

Algumas funcionalidades notáveis ​​do IronPDF incluem a capacidade de criar documentos PDF do zero, converter HTML e imagens em PDF, extrair texto e imagens de PDFs e adicionar anotações e campos de formulário a PDFs existentes. Sua versatilidade a torna uma excelente escolha para desenvolvedores que trabalham em aplicativos que exigem geração e manipulação de PDFs.

5. Converter dados ZPL em imagens e imagens em PDF usando o IronPDF

Agora, vamos explorar como o BinaryKits.Zpl.Viewer pode ser perfeitamente integrado ao IronPDF para converter rótulos gerados por ZPL em PDFs. O exemplo de código fornecido demonstra um processo passo a passo utilizando ambas as bibliotecas. Este exemplo é uma criação simples de um número máximo de etiquetas e sua representação em PDF, pois nem todas as impressoras suportam o código ZPL. As bibliotecas .NET usadas neste exemplo são 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 foi escrito em C# e utiliza a biblioteca BinaryKits.Zpl.Viewer para converter o código da Linguagem de Programação Zebra (ZPL) em uma representação visual na forma de imagens PNG, combinando-as em seguida em um único documento PDF. Segue uma breve explicação do código:

1. Importação de bibliotecas: O código começa importando as bibliotecas necessárias, incluindo BinaryKits.Zpl.Viewer, IronPDF e System.IO.
2. Inicialização: Ele inicializa elementos para impressão e armazenamento ZPL usando a interface IPrinterStorage e um ZplElementDrawer. O ZplAnalyzer também é configurado para analisar o código ZPL.
3. Análise ZPL: O código ZPL fornecido é analisado usando o ZplAnalyzer. O resultado da análise, armazenado em analyzeInfo, inclui informações sobre vários elementos ZPL no código.
4. Desenho de Imagem: O código então itera através das informações da etiqueta obtidas da análise e usa o ZplElementDrawer para desenhar elementos ZPL em uma imagem. Cada imagem é salva como um arquivo PNG chamado "label.png".
5. Conversão para PDF: Após salvar as imagens PNG individualmente, o código recupera a lista de arquivos de imagem no diretório atual com nomes que terminam em "label.png". Em seguida, utiliza a biblioteca IronPDF para converter esses arquivos PNG em um único documento PDF chamado "zpl.pdf".

Imagem de rótulo de saída

Rótulo de saída PDF

4. Conclusão

Em conclusão, a combinação de BinaryKits.Zpl.Viewer e IronPDF oferece uma solução poderosa para desenvolvedores que trabalham com ZPL em aplicações .NET . O visualizador aprimora o processo de desenvolvimento, fornecendo uma representação visual do código ZPL, auxiliando na depuração e na compreensão. Quando integrado ao IronPDF, a transição de etiquetas geradas por ZPL para documentos PDF torna-se suave e eficiente, ampliando as possibilidades de criação de soluções de etiquetagem sofisticadas em diversos setores. Com o avanço contínuo da tecnologia, a sinergia entre bibliotecas como BinaryKits.Zpl.Viewer e IronPDF demonstra a inovação e a versatilidade alcançáveis ​​no desenvolvimento .NET moderno. Para mais exemplos de ZPL e suporte ao projeto, visite o repositório GitHub do BinaryKits.Zpl .

O IronPDF oferece uma licença de avaliação gratuita para desenvolvedores, o que é uma ótima oportunidade para os usuários conhecerem suas funcionalidades. Um tutorial detalhado sobre conversão de imagens para PDF usando o IronPDF pode orientar os desenvolvedores na implementação dessa funcionalidade em seus aplicativos.