Zebra Programming Language (ZPL), öncelikle Zebra Technologies tarafından geliştirilen Zebra etiket yazıcılarında etiketlerin yazdırılması için kullanılan bir yazıcı tanımlama dilidir. Etiket üzerindeki dosya içeriğini şekillendirmek ve kontrol etmek için kullanıcıların metin, barkodlar, etiket genişliği ve grafikler gibi içerikleri yazdırabilmek üzere ZPL II veri komutları seti sunmaktadır. Zebra Technologies tarafından geliştirilen ve üretim, lojistik ve sağlık hizmetleri gibi kesin ve standart etiketleme gerektiren endüstrilerde yaygın olarak kullanılmaktadır.

Various εφαρμογές içinde, ZPL değişken amaçlar için doğru ve tutarlı baskı sağlamak üzere etiketler oluşturmak için kullanılır. Etiketleri toplu yazdırma, sıralama veya özelleştirme gerektiren senaryolarda özellikle popülerdir. ZPL hakkında kısa bir bilgi edindiğimize göre, ZPL yazıcı sürücü kodunun görselleştirilmesi ve analizini kolaylaştırmak için tasarlanmış bir araç olan BinaryKits.Zpl.Viewer'a bakalım. BinaryKits.Zpl'in bir alternatifi olarak ZPL görüntüleme için Labelary API'si de kullanılabilir.

Bu makalede, çoğu yazıcı ZPL kodunu desteklemediğinden, ZPL kodunu PDF'ye dönüştüreceğiz, ancak PDF, Zebra Technologies yazıcılar dahil tüm yazıcılar tarafından desteklenir. ZPL'yi PDF'ye dönüştürmek için kullanacağımız PDF Kütüphanesi IronPDF - .NET PDF Kütüphanesidir.

1. BinaryKits.Zpl.Viewer'ı Keşfetmek

ZPL aleminde öne çıkan bir araç, BinaryKits.Zpl Görüntüleyicisi'dir. Bu görüntüleyici, geliştiricilere ZPL kodunu görselleştirme ve analiz etme konusunda kapsamlı bir çözüm sağlamak için tasarlanmıştır. ZPL komutlarının Zebra yazıcılar üzerindeki Zebra etiketleri ile nasıl yorumlanacağını ve yürütüleceğini anlamak için değerli bir kaynak işlevi görür.

BinaryKits.Zpl Viewer, geliştiricilerin ZPL ham komut kodunu göndermesini ve etiket veya etiketin anlık görsel temsilini görmesini sağlayan kullanıcı dostu bir arabirim sunar. Bu ZPL özelliği, ZPL betiklerini hata ayıklama ve ince ayar yapma için özellikle kullanışlıdır, böylece yazdırılan çıktının tasarlandığı gibi olmasını sağlar.

1.1. Anahtar Özellikler

1.1.1. ZPL Dosya Görselleştirme

BinaryKits.Zpl.Viewer kullanıcılara ZPL dosyalarını açma ve görüntüleme imkanı tanır, etiket içeriğinin kapsamlı ve düzenli bir görüntüsünü sunar. ZPL komutlarını okunabilir bir formatta işleyerek etiket tasarımlarını yorumlamayı ve sorun gidermeyi daha kolay hale getirir.

1.1.2. Söz Dizimi Vurgulama

Görüntüleyici, ZPL kodunun farklı unsurlarını ayırt etmeyi sağlamak için söz dizimi vurgulaması da entegre eder, kodun okunabilirliğini artırır ve kullanıcılar için daha erişilebilir hale getirir.

1.1.3. Etkileşimli Ön İzleme

Kullanıcılar, BinaryKits.Zpl.Viewer arayüzü içinde etiket tasarımlarını etkileşimli olarak önizleyebilirler. Bu özellik, etiketin yazdırıldığında nasıl görüneceğini anlamaya yardımcıdır, tasarım ve hata ayıklama sürecine katkı sağlar.

1.1.4. Hata Tespiti

BinaryKits.Zpl.Viewer, ZPL kodu içindeki potansiyel sorunları tanımlayan hata tespit yetenekleri içerir. Bu yetenek, kullanıcıların kodu Zebra yazıcıya göndermeden önce hataları hızla tanımlayıp düzeltmelerine yardımcı olur.

2. Nasıl Kullanılır

BinaryKits.Zpl.Viewer'ı etkili bir şekilde kullanmak için şu adımları izleyin:

2.1. ZPL Dosyası Açma

BinaryKits.Zpl.Viewer uygulamasını başlatın ve yerleşik dosya gezgini kullanarak istenen dosyayı açın.

2.2. Kodda Gezinme ve Analiz Etme

Görüntüleyicinin kullanıcı dostu arayüzünü kullanarak ZPL kodunda gezinin. Söz dizimi vurgulama ve etkileşimli ön izleme gibi özelliklerden yararlanarak etiket tasarımını anlayın.

2.3. Kod Örneği

C#'de BinaryKits.Zpl.Viewer'ı kullanmanın basit bir örneği:

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

Bu örnek, bir ZPL dosyasını yüklemek, içeriğini almak ve ardından görüntüleyiciyi kapatmak için BinaryKits.Zpl.Viewer kütüphanesini kullanmayı göstermektedir.

BinaryKits.Zpl.Viewer'ı çalışma akışınıza dahil ederek Zebra etiket yazdırma uygulamalarının geliştirilmesini ve hata ayıklamasını kolaylaştırabilirsiniz.

4. IronPDF ve Özellikleri

IronPDF, .NET uygulamalarında PDF belgeleriyle çalışmak için güçlü bir kütüphanedir. Oluşturma, değiştirme ve PDF dosyalarını manipüle etme işlemlerini kolaylaştırarak geliştiricilere, projelerine sorunsuz bir şekilde PDF işlevselliği entegrasyonu için sağlam bir araç seti sunar.

IronPDF'nin dikkat çekici bazı özellikleri, sıfırdan PDF belgeleri oluşturma, HTML ve görüntüleri PDF'ye dönüştürme, PDF'lerden metin ve görüntü çıkarma ve mevcut PDF'lere ek açıklamalar ve form alanları ekleyebilme yeteneğini içerir. Çok yönlülüğü, PDF oluşturma ve manipülasyon gerektiren uygulamalar üzerinde çalışan geliştiriciler için mükemmel bir tercih haline getirir.

5. IronPDF Kullanarak ZPL Verilerini Görüntülere ve Görüntüleri PDF'ye Dönüştürme

Şimdi, BinaryKits.Zpl.Viewer'ın ZPL tarafından oluşturulan etiketleri PDF'lere dönüştürmek için IronPDF ile sorunsuz bir şekilde nasıl entegre edilebileceğini keşfedelim. Sunulan kod örneği her iki kütüphaneyi de kullanarak adım adım bir süreç gösteriyor. Bu örnek, maksimum sayıda etiketin ve PDF temsilinin basit bir şekilde oluşturulmasıdır çünkü tüm yazıcılar ZPL kodunu desteklemez. Bu örnekte kullanılan .NET kütüphaneleri BinaryKits.Zpl.Viewer ve IronPDF'dir.

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

Bu kod, Zebra Programming Language (ZPL) kodunu, PNG görüntüleri şeklinde görsel bir temsil oluşturmak için kullanılan, ardından bu görüntüleri tek bir PDF belgede birleştiren BinaryKits.Zpl.Viewer kütüphanesini kullanan C#'de yazılmıştır. Kodun kısa bir açıklaması:

1. Kütüphane İçe Aktarımları: Kod, BinaryKits.Zpl.Viewer, IronPDF ve System.IO dahil gerekli kütüphaneleri içe aktararak başlatılır.
2. Başlatma: ZPL yazdırma ve depolama için öğeleri IPrinterStorage arayüzü ve bir ZplElementDrawer kullanarak başlatır. ZplAnalyzer ayrıca ZPL kodunu analiz etmek için ayarlanmıştır.
3. ZPL Analizi: Sağlanan ZPL kodu, ZplAnalyzer kullanılarak analiz edilir. Analiz sonuçları, analyzeInfo içinde depolanarak kod içerisindeki çeşitli ZPL elemanları hakkında bilgi içerir.
4. Resim Çizimi: Kod daha sonra analizden elde edilen etiket bilgilerini yineleyerek ZPL elemanlarını bir görüntüye çizmek için ZplElementDrawer kullanır. Her bir görüntü "label.png" adıyla bir PNG dosyası olarak kaydedilir.
5. PDF Dönüştürme: OPNN.png ile biten görüntü dosyalarının listesini, görüntüleri tek bir zpl.pdf PDF belgesine dönüştürmek için IronPDF kütüphanesini kullanarak mevcut dizinde kaydettikten sonra alır.

Çıktı Etiket Görüntüsü

Çıktı Etiket PDF'i

4. Sonuç

Sonuç olarak, BinaryKits.Zpl.Viewer ve IronPDF kombinasyonu, .NET uygulamalarında ZPL ile çalışan geliştiricilere güçlü bir çözüm sunar. Görüntüleyici, ZPL kodunun görsel bir temsilini sağlayarak geliştirme sürecini iyileştirir, hataları ayıklama ve anlama sürecine katkı sağlar. IronPDF ile entegre edildiğinde, ZPL tarafından oluşturulan etiketlerin PDF belgelere dönüşümü sorunsuz ve etkili olur, çeşitli sektörlerde gelişmiş etiketleme çözümleri oluşturma olanaklarını genişletir. Teknoloji gelişmeye devam ettikçe, BinaryKits.Zpl.Viewer ve IronPDF gibi kütüphaneler arasındaki sinerji, modern .NET geliştirmede elde edilen yenilik ve çok yönlülüğü sergiler. ZPL ve proje desteği için daha fazla örnekler BinaryKits.Zpl GitHub Deposu adresini ziyaret edin.

IronPDF, kullanıcıların işlevselliğini tanımaları için büyük bir fırsat olan geliştiricilere yönelik ücretsiz deneme lisansı sunar. IronPDF kullanarak Görüntüden PDF'ye dönüştürme eğitimi, geliştiricilere bu işlevselliği uygulamalarına entegre etmede rehberlik edebilir.