Zebra Programming Language (ZPL) to język opisu drukarek, używany głównie do drukowania etykiet na drukarkach etykiet firmy Zebra Technologies. Zapewnia zestaw poleceń danych ZPL II, które pozwalają użytkownikom formatować i kontrolować zawartość pliku, który ma zostać wydrukowany na etykietach, taką jak tekst, BARCODE, szerokość etykiety i grafika, wraz z możliwością podglądu wydruku. Opracowane przez firmę Zebra Technologies, jest szeroko stosowane w branżach, w których kluczowe znaczenie ma precyzyjne i znormalizowane etykietowanie, takich jak produkcja, logistyka i opieka zdrowotna.

W różnych aplikacjach ZPL jest wykorzystywany do dynamicznego generowania etykiet, zapewniając dokładny i spójny druk w różnych zastosowaniach. Jest to szczególnie popularne w sytuacjach, w których wymagane jest drukowanie wsadowe, serializacja lub personalizacja etykiet. Teraz, gdy mamy już podstawową wiedzę na temat ZPL, przyjrzyjmy się bliżej BinaryKits.Zpl.Viewer, narzędziu zaprojektowanemu w celu ułatwienia wizualizacji i analizy kodu sterownika drukarki ZPL. Ponadto jako alternatywę dla BinaryKits.Zpl można wykorzystać interfejs API Labelary do przeglądania plików ZPL.

W tym artykułe przekonwertujemy kod ZPL na PDF, ponieważ większość drukarek nie obsługuje kodu ZPL, natomiast format PDF jest obsługiwany przez wszystkie drukarki, nawet te firmy Zebra Technologies. Biblioteka PDF, której użyjemy do konwersji ZPL na PDF, to IronPDF – biblioteka .NET do obsługi plików PDF.

1. Zapoznanie się z BinaryKits.Zpl.Viewer

W dziedzinie ZPL, narzędziem, które się wyróżnia, jest BinaryKits.Zpl Viewer. Ten przeglądarka została zaprojektowana, aby zapewnić programistom kompleksowe rozwiązanie do wizualizacji i analizy kodu ZPL. Stanowi cenne źródło informacji pozwalające zrozumieć, w jaki sposób polecenia ZPL będą interpretowane i wykonywane na drukarkach Zebra z etykietami Zebra.

Program BinaryKits.Zpl Viewer oferuje przyjazny dla użytkownika interfejs, który pozwala programistom wysyłać surowy kod poleceń ZPL i natychmiast zobaczyć wizualną reprezentację pojedynczej etykiety lub przywieszki. Ta funkcja ZPL jest szczególnie przydatna do debugowania i precyzyjnego dostosowywania skryptów ZPL, zapewniając zgodność wydruku z zamierzonym projektem.

1.1. Kluczowe funkcje

1.1.1. Wizualizacja plików ZPL

BinaryKits.Zpl.Viewer umożliwia użytkownikom otwieranie i przeglądanie plików ZPL, zapewniając kompleksowe i uporządkowane wyświetlanie treści etykiet. Renderuje polecenia ZPL w czytelnym formacie, ułatwiając interpretację i rozwiązywanie problemów związanych z projektami etykiet.

1.1.2. Podświetlanie składni

Przeglądarka wykorzystuje podświetlanie składni w celu rozróżnienia różnych elementów kodu ZPL, co poprawia czytelność kodu i sprawia, że jest on bardziej przystępny dla użytkowników.

1.1.3. Interaktywny podgląd

Użytkownicy mogą interaktywnie przeglądać projekty etykiet w interfejsie BinaryKits.Zpl.Viewer. Ta funkcja pomaga zrozumieć, jak etykieta będzie wyglądać po wydrukowaniu, co ułatwia proces projektowania i debugowania.

1.1.4. Wykrywanie błędów

BinaryKits.Zpl.Viewer zawiera funkcje wykrywania błędów, identyfikujące potencjalne problemy w kodzie ZPL. Pomaga to użytkownikom w szybkim identyfikowaniu i korygowaniu błędów przed wysłaniem kodu do drukarki Zebra.

2. Jak korzystać

Aby efektywnie korzystać z BinaryKits.Zpl.Viewer, wykonaj następujące kroki:

2.1. Otwórz plik ZPL

Uruchom aplikację BinaryKits.Zpl.Viewer i otwórz żądany plik za pomocą wbudowanego eksploratora plików.

2.2. Nawigacja i analiza

Poruszaj się po kodzie ZPL za pomocą przyjaznego dla użytkownika interfejsu przeglądarki. Wykorzystaj funkcje takie jak podświetlanie składni i interaktywny podgląd, aby zrozumieć projekt etykiet.

2.3. Przykład kodu

Oto prosty przykład użycia BinaryKits.Zpl.Viewer w języku 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

Ten przykład pokazuje, jak użyć biblioteki BinaryKits.Zpl.Viewer do załadowania pliku ZPL, pobrania jego zawartości, a następnie zamknięcia przeglądarki.

Włączając BinaryKits.Zpl.Viewer do swojego procesu pracy, możesz usprawnić tworzenie i rozwiązywanie problemów związanych z aplikacjami do drukowania etykiet Zebra.

4. IronPDF i jego funkcje

IronPDF to potężna biblioteka do obsługi dokumentów PDF w aplikacjach .NET. Ułatwia tworzenie, modyfikowanie i edycję plików PDF, oferując programistom solidny zestaw narzędzi do płynnej integracji funkcji PDF z ich projektami.

Niektóre z najważniejszych funkcji IronPDF to możliwość tworzenia dokumentów PDF od podstaw, konwersji HTML i obrazów do formatu PDF, wyodrębniania tekstu i obrazów z plików PDF oraz dodawania adnotacji i pól formularzy do istniejących plików PDF. Jego wszechstronność sprawia, że jest to doskonały wybór dla programistów pracujących nad aplikacjami wymagającymi generowania i edycji plików PDF.

5. Konwersja danych ZPL na obrazy oraz obrazów na PDF przy użyciu IronPDF

Zobaczmy teraz, jak BinaryKits.Zpl.Viewer można płynnie zintegrować z IronPDF, aby konwertować etykiety wygenerowane w formacie ZPL na pliki PDF. Podany przykład kodu ilustruje krok po kroku proces wykorzystujący obie biblioteki. Ten przykład przedstawia proste utworzenie etykiet z maksymalną liczbą znaków oraz ich reprezentację w formacie PDF, ponieważ nie wszystkie drukarki obsługują kod ZPL. Biblioteki .NET użyte w tym przykładzie to BinaryKits.Zpl.Viewer i 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

Kod ten jest napisany w języku C# i wykorzystuje bibliotekę BinaryKits.Zpl.Viewer do konwersji kodu w języku Zebra Programming Language (ZPL) na reprezentację wizualną w postaci obrazów PNG, a następnie łączy te obrazy w jeden dokument PDF. Oto krótkie wyjaśnienie kodu:

1. Import bibliotek: Kod rozpoczyna się od zaimportowania niezbędnych bibliotek, w tym BinaryKits.Zpl.Viewer, IronPDF i System.IO.
2. Inicjalizacja: Inicjalizuje elementy do druku i przechowywania ZPL z użyciem interfejsu IPrinterStorage i ZplElementDrawer. ZplAnalyzer jest również skonfigurowany do analizy kodu ZPL.
3. Analiza ZPL: Udostępniony kod ZPL jest analizowany za pomocą ZplAnalyzer. Wynik analizy, przechowywany w analyzeInfo, zawiera informacje o różnych elementach ZPL w kodzie.
4. Rysowanie obrazu: Kod następnie iteruje przez informacje o etykiecie uzyskane z analizy i używa ZplElementDrawer, aby narysować elementy ZPL na obrazie. Każdy obraz jest zapisywany jako plik PNG o nazwie "label.png".
5. Konwersja do formatu PDF: Po zapisaniu poszczególnych obrazów PNG kod pobiera listę plików graficznych w bieżącym katalogu, których nazwy kończą się na "label.png". Następnie wykorzystuje bibliotekę IronPDF do konwersji tych plików PNG do pojedynczego dokumentu PDF o nazwie "zpl.pdf".

Obraz etykiety wyjściowej

Wynik Etykieta PDF

4. Podsumowanie

Podsumowując, połączenie BinaryKits.Zpl.Viewer i IronPDF stanowi potężne rozwiązanie dla programistów pracujących z ZPL w aplikacjach .NET. Przeglądarka usprawnia proces tworzenia oprogramowania, zapewniając wizualną reprezentację kodu ZPL, co ułatwia debugowanie i zrozumienie. Po zintegrowaniu z IronPDF przejście z etykiet generowanych w formacie ZPL na dokumenty PDF staje się płynne i wydajne, rozszerzając możliwości tworzenia zaawansowanych rozwiązań w zakresie etykietowania w różnych branżach. Wraz z postępem technologicznym synergia między bibliotekami takimi jak BinaryKits.Zpl.Viewer i IronPDF pokazuje innowacyjność i wszechstronność, jakie można osiągnąć w nowoczesnym programowaniu .NET. Więcej przykładów ZPL i wsparcia projektowego można znaleźć w repozytorium GitHub BinaryKits.Zpl.

IronPDF oferuje programistom bezpłatną licencję próbną, która stanowi doskonałą okazję do zapoznania się z jego funkcjonalnością. Szczegółowy samouczek dotyczący konwersji obrazów do formatu PDF przy użyciu IronPDF może pomóc programistom we wdrożeniu tej funkcji w ich aplikacjach.