.NET ヘルプ

BinaryKits.Zpl.Viewer（開発者向けの仕組み）

公開済み 2023年12月24日

共有:

ゼブラプログラミング言語(ZPL)は、Zebra Technologiesによって開発されたZebraラベルプリンターでラベル印刷に主に使用されるプリンター記述言語です。 ZPL II データコマンドのセットを提供し、印刷プレビュー機能とともに、テキスト、BarCode、ラベル幅、グラフィックなど、ラベルに印刷するファイルコンテンツのフォーマットと制御を可能にします。ゼブラテクノロジーズによって開発されたこの技術は、製造業、物流、医療などの正確で標準化されたラベリングが重要な業界で広く使用されています。

さまざまなアプリケーションで、ZPLはラベルを動的に生成し、さまざまな目的に対して正確で一貫性のある印刷を保証します。バッチ印刷、シリアル化、またはラベルのカスタマイズが必要なシナリオで特に人気があります。 ZPL の概要を理解したところで、ZPL プリンタードライバーコードの視覚化と分析を容易にするために設計されたツール、BinaryKits.Zpl.Viewer に進みましょう。また、ZPL閲覧のためのLabelary APIBinaryKits.Zplの代替として使用できます。

この記事では、ZPLコードをPDFに変換します。ほとんどのプリンタはZPLコードをサポートしていませんが、PDFはZebra Technologiesのものであっても、すべてのプリンタでサポートされているからです。 ZPLをPDFに変換するために使用するPDFライブラリはIronPDF - .NET PDFライブラリ.

BinaryKits.Zpl.Viewerの探索

ZPLの分野で際立っているツールの一つに「BinaryKits.Zpl Viewer」があります。このビューアは、開発者にZPLコードを視覚化および分析するための包括的なソリューションを提供するように設計されています。それは、Zebraラベルを使用するZebraプリンター上でZPLコマンドがどのように解釈され実行されるかを理解するための貴重なリソースとして機能します。

BinaryKits.Zpl Viewerは、開発者がZPLの生コマンドコードを送信し、単一のラベルまたはタグの視覚表現を即座に確認できる使いやすいインターフェースを提供します。このZPL機能は特にZPLスクリプトのデバッグと微調整に役立ち、印刷された出力が意図したデザインに一致することを保証します。

1.1. 主要特徴

1.1.1. ZPLファイルの可視化

BinaryKits.Zpl.Viewerは、ユーザーがZPLファイルを開いて表示することを可能にし、ラベル内容を包括的かつ整理された形で表示します。それはZPLコマンドを読みやすい形式でレンダリングし、ラベルデザインの解釈とトラブルシューティングを容易にします。

シンタックスハイライト

ビューアは、ZPLコードの異なる要素を区別するために構文のハイライトを取り入れており、コードの可読性を向上させ、ユーザーにとってよりアクセスしやすくしています。

1.1.3. インタラクティブプレビュー

ユーザーは BinaryKits.Zpl.Viewer インターフェース内でラベルデザインをインタラクティブにプレビューできます。この機能はラベルが印刷されたときにどのように表示されるかを理解するのに役立ち、設計およびデバッグプロセスを支援します。

エラー検出

BinaryKits.Zpl.Viewerにはエラー検出機能があり、ZPLコード内の潜在的な問題を特定します。これにより、ユーザーはZebraプリンターにコードを送信する前に、迅速にエラーを特定して修正することができます。

使い方

BinaryKits.Zpl.Viewerを効果的に利用するには、次の手順に従ってください：

2.1. ZPLファイルを開く

BinaryKits.Zpl.Viewer アプリケーションを起動し、内蔵ファイルエクスプローラを使用して目的のファイルを開いてください。

2.2. ナビゲートと分析

ビューワーのユーザーフレンドリーなインターフェースを使用して、ZPLコードをナビゲートします。構文ハイライトやインタラクティブプレビューなどの機能を活用して、ラベルデザインを理解してください。

2.3. コード例

以下は、C#でBinaryKits.Zpl.Viewerを使用する簡単な例です:

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. ZPLデータを画像に変換し、画像をIronPDFを使用してPDFに変換

では、BinaryKits.Zpl.ViewerをIronPDFとシームレスに統合し、ZPL生成ラベルをPDFに変換する方法を探ってみましょう。提供されたコード例は、両方のライブラリを使用したステップバイステップのプロセスを示しています。この例は、すべてのプリンタがZPLコードをサポートしているわけではないので、最大番号ラベルの簡単な作成とそのPDF表現です。この例で使用される .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画像の形で視覚的に表現し、これらの画像を1つの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ファイルを1つのPDFドキュメント「zpl.pdf」に変換します。

出力ラベル画像

BinaryKits.Zpl.Viewer（開発者向けの使用方法）：図1 - 画像出力

出力ラベルPDF

バイナリーキット.Zpl.Viewer(開発者向け動作方法): 図2 - PDF出力

結論

結論として、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# デストラクタ（開発者向けの動作）