【C#】打印机ZPL指令，打印文本，中文，条码，图片

 

ZPL一些简单的指令

^XA 开始

^XZ 结束

 

^LL 设置标签长度（我用的打印机是TSC TE344，这好像没有效果）

^PW 设置标签宽度

^FS 换行

^FS 注释

 

^LH0,0 纸张的边距，左边距和上边距
 

^FO0,0 设置打印内容坐标

^FD123 设置打印内容，可以是文本，一维码，二维码

 

更多指令：请看这里

 

一段完整的ZPL指令

^XA
^XA^LH0,0^LL100^PW580

^FX 文本
^FO10,10^AFN,0,20,10^FD123456^FS
^FX 一维码
^FO10,10^BY2,11.0,10,40^BCC,90,N^FD12345678^FS
^FX 二维码
^FO10,10^BQ,2,5^CI26^FH^FDQA^FD1215445244^FS

^XZ

 

打印文本

^FO10,10^AFN,0,20,10^FD123456^FS

打印一维码

^FO10,10^BY2,11.0,10,40^BCC,80,N^FD12345678^FS

其中^BCC,80,N的80为一维码的高度，N表示不显示注释行，则显示内容12345678

 

打印二维码

^FO10,10^BQ,2,5^CI26^FH^FDQA^FD1215445244^FS

其中^BQ,2,5的5为二维码大小，范围1-10

 

关于中文打印

由于打印机没有中文的字库，打印中文会出现乱码

一种解决方法就是安装中文字符，码表，这个有点麻烦，就不用了

另一种就是，通过Fnthex32.dll，将文字转为打印机指令，再发送到打印机

---

Fnthex32.dll下载：

链接：https://pan.baidu.com/s/1_lU0zswvE929wpXG0431Wg 
提取码：oi41 

---

使用

[DllImport("Fnthex32.dll")]
private static extern int GETFONTHEX(
string text,//文本
string fontName,//字体
string tempName,//临时变量
int orient,//方向
int height,//字体高度
int width,//字体宽度
int isBold,//是否加粗0,1
int isItalic,//是否斜体0,1
StringBuilder cmd);//内容

/// 

/// 获取文本编码
/// 
/// 文本
/// 字体
/// 临时变量
/// 字体高度
/// 字体宽度
/// 是否加粗
/// 是否斜体
/// 
public static string GetFontHex(string text, string fontName, string tempName,
    int height = 40, int width = 15, bool isBlod = false, bool isItalic = false)
{
    int nIsBlod = isBlod ? 1 : 0;
    int nIsItalic = isItalic ? 1 : 0;

    StringBuilder context = new StringBuilder(text.Length * 1024);
    int count = GETFONTHEX(text, fontName, tempName, 1, height, width, nIsBlod, nIsItalic, context);
    string temp = " " + context.ToString();
    temp = temp.Substring(0, count);
    return temp;
}

通过GetFontHex获取ZPL指令

 string sTemp = GetFontHex("啊", "Arial", "temp0");

其中temp0是一个临时变量

 

接下来，再通过一条指令来设置

^FO30,0^XGtemp0,1,1^FS

完整指令

^XA
^LH0,0^LL80^PW580 
~DGtemp0,00240,006,iH0108H0CL01FDHFEJ03F918018J031918018J03191H018J03191H018J031
93H018J03192H198J031921F98J03192H198J03194H198J03192H198J0319I198J0319I198J03191
9198J031909198J03190D198J03190DF98J03F90D198J031919H18J03H1F8018J03013H018L01I01
8L01I018L01I018L01I018L01I018L01H01F8L01I07M01I02iK0
^FO30,0^XGtemp0,1,1^FS
^XZ

 

关于图片的打印

打印图片，需要将图片转换成十六进制指令

https://blog.csdn.net/weixin_38211198/article/details/96494614

 

指令发送到打印机

首选需要设置打印机共享

才使用System.IO.File.Copy方法

//保存到本地文件
using (System.IO.StreamWriter sw = new System.IO.StreamWriter(printFilePath))
{
    sw.Write(cmd.ToString());
}
//将ZPL指令发送到打印机
File.Copy(printFilePath, mPrintName, true);

其中

printFilePath为ZPL指令文件路径

mPrintName为打印机路径，例如：mPrintName = @"\\192.168.0.132\TSC TE344";

指令需要获取本机IP4地址

/// 

/// 获取IP4地址
/// 
private string GetIP4()
{
    string ip4 = string.Empty;

    IPHostEntry ipe = Dns.GetHostEntry(Dns.GetHostName());
    IPAddress[] ips = ipe.AddressList;

    for (int i = 0; i < ips.Length; i++)
    {
        if (ips[i].AddressFamily == System.Net.Sockets.AddressFamily.InterNetwork)
        {
            ip4 = ips[i].ToString();
            break;
        }
    }

    return ip4;
}

其实本机IP直接写127.0.0.1就好

关于打印机初始化

由于之前使用佳博Gprinter GP-9134T打印机，不是使用ZPL指令，直接使用PrintDocument类打印控件的图片，打印机都是自动校准的，现在TSC TE344打印机，由于现在打印机没有校准功能，用PrintDocument打印总是会打印一半纸张，所以改为ZPL指令打印，为了能同时使用多种打印机，之后做兼容。

由于用PrintDocument打印，导致出纸不准确，可用下面这指令初始化打印机，这指令是从NiceLabel得到的

首先，要设置好打印纸张的大小，边距等，在打印到文件，即可获取该初始化指令（BarTender）

/// 

/// 打印机初始化
/// 
private void PrintInit()
{
    string printerInitCMD = @"
                              SIZE 47.5 mm, 15.1 mm
                              GAP 2 mm, 0 mm
                              DIRECTION 0,0
                              REFERENCE 0,0
                              OFFSET 0 mm
                              SET PEEL OFF
                              SET CUTTER OFF
                              SET PARTIAL_CUTTER OFF
                              SET TEAR ON
                              CLS
                              ";

    string PrinterInitFilePath = printPath + "\\PrinterInit.prn";

    using (StreamWriter sw = new StreamWriter(PrinterInitFilePath))
    {
        sw.Write(printerInitCMD);
    }

   File.Copy(PrinterInitFilePath, mPrintName, true);
}

使用的打印纸规格

双排打印纸

 

实际大小（mm）

标签宽高：22*15

卷宽：50

 左右边距：2  

行距：2

列距：2

代码中大小

标签宽高：235*160

纸张宽度：580

左右边距：30

中缝边距：50

 

总结：

由于ZPL刚学，不熟悉，项目中需要支持自定义打印模板功能，即用户自己调整，拖拽标签位置等，

考虑到

1.ZPL预览功能有点难度

2.ZPL指令的参数限制，比如条码的宽高无法与控件的大小兼容

 

所以直接通过打印控件上的图片，将图片转为十六进制指令发送到打印机，

这样还有一个好处就是不用考虑中文乱码的问题

 

下面是我的PrintManager

public class PrintManager
{
    #region 文字转图像
    [DllImport("Fnthex32.dll")]
    private static extern int GETFONTHEX(
    string text,//文本
    string fontName,//字体
    string tempName,//临时变量
    int orient,//方向
    int height,//字体高度
    int width,//字体宽度
    int isBold,//是否加粗0,1
    int isItalic,//是否斜体0,1
    StringBuilder cmd);//内容

    /// 

    /// 获取文本编码
    /// 
    /// 文本
    /// 字体
    /// 临时变量
    /// 字体高度
    /// 字体宽度
    /// 是否加粗
    /// 是否斜体
    /// 
    public static string GetFontHex(string text, string fontName, string tempName,
        int height = 40, int width = 15, bool isBlod = false, bool isItalic = false)
    {
        int nIsBlod = isBlod ? 1 : 0;
        int nIsItalic = isItalic ? 1 : 0;

        StringBuilder context = new StringBuilder(text.Length * 1024);
        int count = GETFONTHEX(text, fontName, tempName, 1, height, width, nIsBlod, nIsItalic, context);
        string temp = " " + context.ToString();
        temp = temp.Substring(0, count);
        return temp;
    }
    #endregion

    //纸张宽度
    int paperWidth = 580;
    //左右边距
    int padding = 30;
    //中缝边距
    int middlePadding = 50;

    //标签宽度
    int labelWidth = 235;
    //标签高度
    int labelHeight = 160;

    string ip4;

    public  StringBuilder cmd;

    //打印目录
    string printPath;
    //保存打印指令
    string printFilePath ;

    //打印机名称
    private string mPrintName;

    public PrintManager()
    {
         printPath = Application.StartupPath + "\\Print";

        if (Directory.Exists(printPath) == false)
        {
            Directory.CreateDirectory(printPath);
        }

         printFilePath = printPath + "\\print.prn";

        ip4 = GetIP4();

    }

    public void Init(string printerName)
    {
        mPrintName = string.Format(@"\\{0}\{1}", ip4, printerName);
        //mPrintName = @"\\192.168.0.132\TSC TE344";

        //打印机初始化
        PrintInit();

        cmd = new StringBuilder();

        cmd.AppendFormat(@"^XA^LH0,0^LL{0}^PW{1}", 80, paperWidth);
    }

    /// 

    /// 获取IP4地址
    /// 
    private string GetIP4()
    {
        string ip4 = string.Empty;

        IPHostEntry ipe = Dns.GetHostEntry(Dns.GetHostName());
        IPAddress[] ips = ipe.AddressList;

        for (int i = 0; i < ips.Length; i++)
        {
            if (ips[i].AddressFamily == System.Net.Sockets.AddressFamily.InterNetwork)
            {
                ip4 = ips[i].ToString();
                break;
            }
        }

        return ip4;
    }

    /// 

    /// 打印机初始化
    /// 
    private void PrintInit()
    {
        string printerInitCMD = @"
                                  SIZE 47.5 mm, 15.1 mm
                                  GAP 2 mm, 0 mm
                                  DIRECTION 0,0
                                  REFERENCE 0,0
                                  OFFSET 0 mm
                                  SET PEEL OFF
                                  SET CUTTER OFF
                                  SET PARTIAL_CUTTER OFF
                                  SET TEAR ON
                                  CLS
                                  ";

        string PrinterInitFilePath = printPath + "\\PrinterInit.prn";

        using (StreamWriter sw = new StreamWriter(PrinterInitFilePath))
        {
            sw.Write(printerInitCMD);
        }

       File.Copy(PrinterInitFilePath, mPrintName, true);
    }

    /// 

    /// 打印
    /// 
    public void Print()
    {
        cmd.Append("^XZ");
        //保存到本地文件
        using (System.IO.StreamWriter sw = new System.IO.StreamWriter(printFilePath))
        {
            sw.Write(cmd.ToString());
        }
        //将ZPL指令发送到打印机
        File.Copy(printFilePath, mPrintName, true);
    }

    /// 

    /// 设置文本-中文乱码
    /// 
    public void SetText(string value, Point loc)
    {
        cmd.AppendFormat("^FO{0},{1}^AFN,0,20,10^FD{2}^FS", padding + loc.X, loc.Y, value);
    }

    int iTemp = 0;
    /// 

    /// 设置文本-中文正常
    /// 
    public void SetText_Chinese(string value, Point loc)
    {
        string tempName = "temp" + iTemp;
        string sTemp = GetFontHex(value, "Arial", tempName);
        cmd.Append(sTemp);

        cmd.AppendFormat("^FO{0},{1}^XG{2},1,1^FS", padding + loc.X, loc.Y, tempName);
        iTemp++;
    }

    /// 

    /// 设置二维码
    /// 
    public void SetQR_Code(string value, Point loc, int size)//0到10
    {
        cmd.AppendFormat("^FO{0},{1}^BQ,2,{2}^CI26^FH^FDQA^FD{3}^FS", padding + loc.X, loc.Y, size, value);
    }

    /// 

    /// 设置一维码
    /// 
    public void SetCODE_128(string value, Point loc, Size size)
    {
        cmd.AppendFormat(@"^FO{0},{1}^BY2,11.0,60,{2}^BCC,{3},N^FD{4}^FS", padding + loc.X, loc.Y, size.Width, size.Height, value);
    }

    int iTemp2 = 0;

    /// 

    /// 设置图片
    /// 
    public void SetImage(Image image, bool isRight = false)
    {
        image = ReSizeImage(image, new Size(labelWidth + 20, labelHeight));

        string data = ZebraUnity.BitmapToHex(image, out int to, out int row);
        string zpl = string.Format("~DGR:Temp{0}.GRF,{1},{2},{3}", iTemp2, to, row, data);
        cmd.Append(zpl);

        int offset = isRight == true ? labelWidth + middlePadding : 0;

        cmd.AppendFormat("^FO{0},0^XGR:Temp{1}.GRF,1,1^FS", padding + offset, iTemp2);
        iTemp2++;
    }

    /// 

    /// 改变图像大小
    /// 
    public static Image ReSizeImage(Image img, Size size)
    {
        Bitmap bitmap = new Bitmap(size.Width, size.Height);
        Graphics g = Graphics.FromImage(bitmap);
        g.InterpolationMode = InterpolationMode.HighQualityBicubic;
        g.DrawImage(img, 0, 0, bitmap.Width, bitmap.Height);
        g.Dispose();
        return bitmap;
    }

}

其中ZebraUnity.BitmapToHex 看 https://blog.csdn.net/weixin_38211198/article/details/96494614

 

相关链接：

ZPL指令解析：

百度文库：https://wenku.baidu.com/view/ec78b8cbf01dc281e43af039.html

道客巴巴：http://www.doc88.com/p-2018927808824.html

ZPL指令预览：

http://labelary.com/viewer.html