BinaryKits.Zpl.Viewer (Como funciona para desenvolvedores)

1.1. Principais Características

2. Como usar

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

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

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: Inicializa elementos para impressão e armazenamento ZPL usando a interface IPrinterStorage e um ZplElementDrawer. O ZplAnalyzer também está configurado para analisar 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 da imagem: O código então itera pelas informações de rótulo 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