.NET 幫助

BinaryKits.Zpl.Viewer（開發者工作原理）

發佈 2023年12月24日

斑馬程式語言(ZPL)是一種用於列印 Zebra Technologies 開發的 Zebra 標籤打印機上的標籤的印表機描述語言。它提供一組 ZPL II 數據命令，使用戶能夠格式化和控制要打印在標籤上的文件內容，例如文本、條碼、標籤寬度和圖形，並具備打印預覽功能。由 Zebra Technologies 開發，它廣泛應用於製造、物流和醫療保健等需要精確和標準化標籤的產業。

在各種應用中，ZPL 被用於動態生成標籤，確保為各種用途提供精確且一致的打印。它在需要批量列印、序列化或自訂標籤的情況下特別受歡迎。現在我們已經對 ZPL 有了簡單的了解，我們來深入探討 BinaryKits.Zpl.Viewer，一個旨在協助可視化和分析 ZPL 打印機驅動代碼的工具。另外，Labelary API 用於 ZPL 檢視可作為 BinaryKits.Zpl 的替代品使用。

在本文中，我們將把 ZPL 代碼轉換為 PDF，因為大多數印表機不支援 ZPL 代碼，但 PDF 是所有印表機皆支援的，甚至是來自 Zebra Technologies 的印表機。我們將用來將 ZPL 轉換為 PDF 的 PDF 庫是IronPDF - .NET PDF 程式庫.

1. 探索 BinaryKits.Zpl.Viewer

在 ZPL 領域中，突出的一個工具是 BinaryKits.Zpl 檢視器。此檢視器旨在為開發人員提供一個完整的解決方案，用於可視化和分析 ZPL 程式碼。它作為瞭解 ZPL 命令如何在具有 Zebra 標籤的 Zebra 打印機上被解釋和執行的重要資源。

BinaryKits.Zpl Viewer 提供了一個用戶友好的介面，允許開發人員發送 ZPL 原始命令代碼並立即看到單個標籤或標記的視覺表示。此 ZPL 功能特別適用於調試和微調 ZPL 腳本，以確保列印的輸出與預期的設計相符。

1.1. 主要功能

1.1.1. ZPL 檔案視覺化

BinaryKits.Zpl.Viewer 允許用戶打開和查看 ZPL 文件，提供全面且有條理的標籤內容顯示。它以可讀格式呈現 ZPL 指令，使得解讀和故障排除標籤設計更加容易。

1.1.2. 語法高亮顯示

檢視器結合了語法高亮功能，以區分 ZPL 代碼中的不同元素，增強代碼的可讀性，使其對用戶更具可及性。

1.1.3. 互動預覽

使用者可以在 BinaryKits.Zpl.Viewer 介面中互動預覽標籤設計。此功能有助於了解標籤在列印時的顯示效果，有助於設計和除錯過程。

1.1.4. 錯誤檢測

BinaryKits.Zpl.Viewer 包含錯誤檢測功能，可以識別 ZPL 代碼中的潛在問題。這有助於用戶在將代碼發送到 Zebra 打印機之前快速識別和修正錯誤。

2. 如何使用

若要有效利用 BinaryKits.Zpl.Viewer，請遵循以下步驟：

2.1. 打開ZPL檔案

啟動 BinaryKits.Zpl.Viewer 應用程式，然後使用內建的文件瀏覽器開啟所需的文件。

2.2. 瀏覽和分析

使用查看器的用户友好界面瀏覽 ZPL 代碼。利用語法高亮和互動預覽等功能來理解標籤設計。

2.3. 程式碼範例

這是使用 BinaryKits.Zpl.Viewer 在 C# 中的一個簡單示例：

using BinaryKits.Zpl.Viewer;
class Program
{
    static void Main()
    {
        // Instantiate ZplViewer
        var zplViewer = new ZplViewer();
        // Load ZPL file
        zplViewer.LoadFile("path/to/your/label.zpl");
        // Display the ZPL content
        Console.WriteLine(zplViewer.GetContent());
        // Close the viewer
        zplViewer.Close();
    }
}

using BinaryKits.Zpl.Viewer;
class Program
{
    static void Main()
    {
        // Instantiate ZplViewer
        var zplViewer = new ZplViewer();
        // Load ZPL file
        zplViewer.LoadFile("path/to/your/label.zpl");
        // Display the ZPL content
        Console.WriteLine(zplViewer.GetContent());
        // Close the viewer
        zplViewer.Close();
    }
}

Imports BinaryKits.Zpl.Viewer
Friend Class Program
	Shared Sub Main()
		' Instantiate ZplViewer
		Dim zplViewer As New ZplViewer()
		' Load ZPL file
		zplViewer.LoadFile("path/to/your/label.zpl")
		' Display the ZPL content
		Console.WriteLine(zplViewer.GetContent())
		' Close the viewer
		zplViewer.Close()
	End Sub
End Class

VB C#

此示例演示如何使用 BinaryKits.Zpl.Viewer 庫加載 ZPL 文件，檢索其內容，然後關閉查看器。

透過將 BinaryKits.Zpl.Viewer 整合到您的工作流程中，您可以簡化 Zebra 標籤列印應用程序的開發和故障排除。

4. IronPDF 及其功能

IronPDF 是一個強大的程式庫，用於在 .NET 應用程式中處理 PDF 文件。它促進了 PDF 文件的創建、修改和操作，為開發人員提供了一套強大的工具，能夠將 PDF 功能無縫整合到他們的專案中。

IronPDF 的一些顯著功能包括：從頭創建 PDF 文件、將 HTML 和圖像轉換為 PDF、從 PDF 中提取文本和圖像，以及在現有的 PDF 上添加註釋和表單欄位。由於其多功能性，它是需要 PDF 生成和操作的應用程式開發人員的極佳選擇。

5. 使用 IronPDF 將 ZPL 資料轉換為圖像並將圖像轉換為 PDF

現在，讓我們探討如何將 BinaryKits.Zpl.Viewer 無縫整合至 IronPDF，以將 ZPL 生成的標籤轉換成 PDF。提供的代碼範例演示了使用這兩個庫的逐步過程。此範例是一個簡單的最大數字標籤創建及其 PDF 表示，因為並非所有的印表機都支持 ZPL 代碼。此範例中使用的 .NET 函式庫是 BinaryKits.Zpl.Viewer 和 IronPDF。

using BinaryKits.Zpl.Viewer;
using System.IO;
using IronPdf;
using System.Linq;
// Initialize ZPL elements and printer storage
IPrinterStorage printerStorage = new PrinterStorage();
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.592000000000006,23.142^PW0^LL0^A0N,36,36^FB620,10,0,C,0^FDTest will go here^FS^FO8.931999999999999,6.09^GB798.196,1205.82,3,B^FS^FO190.008,247.25400000000002^BQN,^PW0^LL02,10,Q,7^FDQA,False^FS^XZ");
// Iterate through label information and draw ZPL elements
foreach (var labelInfo in analyzeInfo.LabelInfos)
{
    var imageData = drawer.Draw(labelInfo.ZplElements);
    File.WriteAllBytes("label.png", imageData);
}
// Retrieve image files and convert to PDF
var response = Directory.EnumerateFiles("").Where(f => f.EndsWith("label.png"));
ImageToPdfConverter.ImageToPdf(response).SaveAs("zpl.pdf");

using BinaryKits.Zpl.Viewer;
using System.IO;
using IronPdf;
using System.Linq;
// Initialize ZPL elements and printer storage
IPrinterStorage printerStorage = new PrinterStorage();
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.592000000000006,23.142^PW0^LL0^A0N,36,36^FB620,10,0,C,0^FDTest will go here^FS^FO8.931999999999999,6.09^GB798.196,1205.82,3,B^FS^FO190.008,247.25400000000002^BQN,^PW0^LL02,10,Q,7^FDQA,False^FS^XZ");
// Iterate through label information and draw ZPL elements
foreach (var labelInfo in analyzeInfo.LabelInfos)
{
    var imageData = drawer.Draw(labelInfo.ZplElements);
    File.WriteAllBytes("label.png", imageData);
}
// Retrieve image files and convert to PDF
var response = Directory.EnumerateFiles("").Where(f => f.EndsWith("label.png"));
ImageToPdfConverter.ImageToPdf(response).SaveAs("zpl.pdf");

Imports BinaryKits.Zpl.Viewer
Imports System.IO
Imports IronPdf
Imports System.Linq
' Initialize ZPL elements and printer storage
Private printerStorage As IPrinterStorage = New PrinterStorage()
Private drawer = New ZplElementDrawer(printerStorage)
' Initialize ZPL analyzer and analyze ZPL code
Private analyzer = New ZplAnalyzer(printerStorage)
Private analyzeInfo = analyzer.Analyze("^XA ^MMT ^PW812 ^LL0203 ^LS0^FO0,0^A0N,36,36^FB600,1,0,L,0^FD^FS ^FO53.592000000000006,23.142^PW0^LL0^A0N,36,36^FB620,10,0,C,0^FDTest will go here^FS^FO8.931999999999999,6.09^GB798.196,1205.82,3,B^FS^FO190.008,247.25400000000002^BQN,^PW0^LL02,10,Q,7^FDQA,False^FS^XZ")
' Iterate through label information and draw ZPL elements
For Each labelInfo In analyzeInfo.LabelInfos
	Dim imageData = drawer.Draw(labelInfo.ZplElements)
	File.WriteAllBytes("label.png", imageData)
Next labelInfo
' Retrieve image files and convert to PDF
Dim response = Directory.EnumerateFiles("").Where(Function(f) f.EndsWith("label.png"))
ImageToPdfConverter.ImageToPdf(response).SaveAs("zpl.pdf")

VB C#

這段程式碼是用 C# 撰寫，並使用 BinaryKits.Zpl.Viewer 庫來轉換 Zebra 編程語言(ZPL)將代碼轉換為 PNG 圖像的視覺表示，然後將這些圖像合併為一個 PDF 文件。以下是代碼的簡要說明：

庫匯入： 程式碼首先匯入必要的庫，包括 BinaryKits.Zpl.Viewer、IronPDF 和 System.IO。
初始化： 使用 IPrinterStorage 介面和 ZplElementDrawer 初始化 ZPL 列印和儲存元素。 ZplAnalyzer 也設定為分析 ZPL 代碼。
ZPL 分析： 提供的 ZPL 代碼使用 ZplAnalyzer 進行分析。分析結果，存儲在 analyzeInfo 中，包含有關代碼中各種 ZPL 元素的資訊。
圖像繪製： 然後，程式碼遍歷從分析中獲得的標籤資訊，並使用 ZplElementDrawer 將 ZPL 元素繪製到圖像上。每個圖像都保存為名為「label.png」的 PNG 文件。
PDF 轉換： 在儲存各個 PNG 圖片後，程式碼會擷取目前目錄中以 "label.png" 結尾的圖片檔案清單。接著，它使用 IronPDF 函式庫將這些 PNG 檔案轉換為名為 "zpl.pdf" 的單一 PDF 文件。

輸出標籤圖像

BinaryKits.Zpl.Viewer（開發人員如何使用）：圖1 - 圖像輸出

輸出標籤 PDF

BinaryKits.Zpl.Viewer（它如何為開發者工作）：圖 2 - PDF輸出

4. 結論

總之，BinaryKits.Zpl.Viewer 和 IronPDF 的結合為處理 .NET 應用程式中的 ZPL 的開發人員提供了一個強大的解決方案。查看器通過提供 ZPL 代碼的視覺表示來增強開發過程，有助於調試和理解。當與 IronPDF 整合時，從 ZPL 生成的標籤到 PDF 文件的過渡變得流暢高效，擴展了在各行業中創建高級標籤解決方案的可能性。隨著科技的不斷進步，像 BinaryKits.Zpl.Viewer 和 IronPDF 這樣的庫之間的協同作用展示了現代 .NET 開發中可實現的創新和多樣性。如需更多的 ZPL 示例和項目支持，請訪問BinaryKits.Zpl GitHub 資源庫.

IronPDF 提供一個開發人員免費試用許可證這對用戶來說是了解其功能的絕佳機會。詳細的使用 IronPDF 的圖像轉 PDF 轉換教程可以指導開發人員在其應用程式中實現此功能。

< 上一頁
Blazor .NET 8（開發人員教程）

下一個 >
C# 解構函式（開發人員如何使用）