格瑞斯腕帶打印機接口開發幫助文檔
格瑞斯腕帶、瓶簽打印機使用TSPL2指令集。具體指令請參考TSCLIB.DLL函數庫使用說明和TSPL2指令集(中文版)。格瑞斯GRIS05-GZ腕帶打印機、GRIS-03GR瓶簽打印機只用到TSCLIB.DLL函數庫中的部分函數和少量的TSPL2原生指令。
下面是格瑞斯打印機打印腕帶和標簽所用到的TSC部分函數指令，及指令的詳細設置說明。
重要提示：請在開發及測試之前，需務必先安裝好條形碼打印機及驅動程序。
注意：指令中的所有字符務必為英文字符
1、openport(a) 指令：
說明: 指定計算機端的輸出端口，即指定打印條碼的打印機。
方法：openport(“打印機名”)
實例：openport(“格瑞斯? GRIS-05GZ”)
2、setup(a,b,c,d,e,f,g) 指令：
說明: 設定腕帶或標簽的寬度、高度、打印速度、打印濃度、傳感器類別、gap/black mark、垂直間距、gap/black mark偏移距離)
參數：
| A | 字符串型 | 設定標簽寬度，單位 mm |
| B | 字符串型 | 設定標簽高度，單位 mm |
| ???C | 字符串型 | 設定打印速度，(打印速度隨機型不同而有不同的選項) |
| 1 : 每秒1.0 英寸打印速度 | ||
| 1.5 : 每秒1.5 英寸打印速度 | ||
| 2 : 每秒2.0 英寸打印速度 | ||
| 3 : 每秒3.0 英寸打印速度 | ||
| 4 : 每秒4.0 英寸打印速度 | ||
| 5 : 每秒5.0 英寸打印速度 | ||
| 6 : 每秒6.0 英寸打印速度 | ||
| D | 字符串型 | 設定打印濃度，0~15，數字越大打印結果越黑 |
| ?E | 字符串型 | 設定使用傳感器類別 |
| 0 表示使用垂直間距傳感器(gap sensor) | ||
| 1 表示使用黑標傳感器(black mark sensor) | ||
| F | 字符串型 | 設定gap/black mark 垂直間距高度，單位: mm |
| G | 字符串型 | 設定gap/black mark 偏移距離，單位: mm，此參數若使用一般標簽時均設為0 |
方法：setup(A寬度數字,B高度數字,C打印速度數字,D打印濃度數字,E感測器類型（腕帶填寫：1，標簽填寫：0）, F黑標或瓶簽寬度數字（腕帶填寫：3，標簽填寫：3）,G偏離距離一般不啟用設為：0)
以280×30常規尺寸腕帶為例：
腕帶實例：setup(“30″, “190”, “4”, “6”, “1”, “3”, “0”)?? ?????// 成人和兒童腕帶高度設為：190??? 新生兒高度設為：140
“30”為寬度，對應表中A
“190”為高度，對應表中B
“4” 為打印速度，對應表中C
“6”為打印濃度，對應表中D
“1”為感測器類型，1為腕帶，0為輸液標簽對應表中E
“3” 材料為腕帶時，代表腕帶下方黑標寬度；瓶簽時，代表瓶簽間距，對應表中F
“0”為偏離距離設置，一般情況下都不啟用，設置為0，對應表中G
以60×80常規尺寸瓶簽為例：
瓶簽實例：setup(“60″, “80”, “4”, “10”, “0”, “3”, “0”)? ??????// ?瓶簽寬高設置為實際尺寸
特別注意：黑標打印設置的打印尺寸實際上是打印機的“感應區域”，而非“實際尺寸”，打印標簽時才需設置“實際尺寸”。HIS軟件內的 “設置尺寸”應和打印機的“設置尺寸”保持一致，成人腕帶、兒童腕帶部分新生兒腕帶的設置相同，無論“實際尺寸”為多少，均設置為 30mm x 190mm；“實際尺寸”長度≤（小于等于）190mm的新生兒腕帶的“設置尺寸”與前幾者略有不同，“設置尺寸”應為 30mm x 140mm。
關于不同腕帶材質下，打印濃度設置的一點建議：
常規型腕帶打印濃度為4 – 6
柔軟型腕帶打印濃度為6 – 8
杜邦紙腕帶打印濃度為10 – 12
熱敏型腕帶（瓶簽）打印濃度為8 – 10
除了濃度設置和介質設置有差異，相同尺寸但不同材質的腕帶其他設置并無差異
詳情請參考：格瑞斯GRIS-05GZ打印機設置方法詳細教程
3、 clearbuffer() 指令：
說明：清理打印機內部緩存
方法：clearbuffer()
實例：clearbuffer()????? //唯一書寫方式，不能在括號里加任何內容
4、windowsfont(a,b,c,d,e,f,g,h) 指令：
說明: 使用Windows TTF 字型打印文字
參數：
| A | 整數型 | 文字X （）方向起始點，以點(point)表示。 |
| B | 整數型 | 文字Y 方向起始點，以點(point)表示。 |
| C | 整數型 | 字體大小，以點(point)表示。 |
| ???D | 整數型 | 旋轉角度，逆時鐘方向旋轉 |
| 0 -> 0 degree | ||
| 90-> 90 degree | ||
| 180-> 180 degree | ||
| 270-> 270 degree | ||
| ??E | 整數型 | 字體外形 |
| 0-> 標準(Normal) | ||
| 1-> 斜體(Italic) | ||
| 2-> 粗體(Bold) | ||
| 3-> 粗斜體(Bold and Italic) | ||
| F | 整數型 | 底線 |
| ? | 0-> 無底線 | |
| 1-> 加底線 | ||
| G | 整數型 | 字符串型，字體名稱。如: Arial, Times new Roman, 細名體, 標楷體 |
| H | 整數型 | 打印文字內容 |
方法：windowsfont (A文字上下位置,B文字左右位置,C字體大小,D文字旋轉,E字體屬性（粗、細、斜）, F文字是否加底線（0不加、1加）,G字體，H文字內容
以280×30常規尺寸腕帶為例：
windowsfont(165, 135, 19, 270, 2, 0, “宋體”, “姓名：張三”)
165為文字上下位置對應表A，數字越大越靠上；
135為文字左右位置對應表B，數字越大越靠右；
19為字體大小，數字越大文字越大對應表C；
270為文字旋轉角度對應表D；
2為字體屬性對應表E；
0為不啟用底線，對應表F；
“宋體”為文本字體，對應表G；
“姓名：張三”為文字內容，可以替換為一個變量，對應表H；
5、printlabel(a,b)指令：
說明: 打印標簽內容
a: 字符串型別，設定打印標簽個數(set)
b: 字符串型別，設定打印標簽份數(copy)
方法：printlabel(a數字,b數字)
實例：printlabel(“1″, “1”)
6、closeport() 指令：
說明: 關閉指定的計算機端輸出端口
方法：closeport()
實例：closeport()??????????? //唯一書寫方式，不能在括號里加任何內容
7、sendcommand(command)指令：
?
說明: 以TSCLIB.DLL中的sendcommand為媒介，直接向打印機發送任意指令。該函數非常強大，可以直接繞過TSCLIB.DLL函數庫中sendcommand以外的指令來實現上面的所有功能。用于彌補DLL中不存在的入口點。
參數: 此命令支持直接向打印機發送TSPL2指令集中的任意函數指令。（主要用于調用DLL函數庫中沒有的函數，如二維碼打印等）
方法：sendcommand(指令函數)
在TSPL2中的語法為 QRCODE x,y,ECC Level,cell width,mode,rotation,[model,mask,]”content”
我們可直接用sendcommand(QRCODE x,y,ECC Level,cell width,mode,rotation,[model,mask,]”content”) 配合DLL來調用
以C# ?WPF打印二維碼為例可寫為：
?新增如下Namespace來調用DLL：
using System.Runtime.InteropServices;
新建一個public class，命名為： WD_DLL
public class WD_DLL
{
[DllImport(“TSCLIB.dll”, EntryPoint = “sendcommand”)]
public static extern int sendcommand(string printercommand);
}
程序中調用：
WD_DLL.sendcommand(“QRCODE 175,720,L,6,A,90,M2,S0, \”” + str_rqcode + “\””);??? // str_rqcode 為一個變量
以上為打印腕帶和瓶簽需要使用的所有機器指令。
需要打印整條腕帶時，具體代碼如下例：
新建wpf項，命名為 “Wpf_wdqrcode”
// 調用相關Namespace
using System.Windows;
using System.Runtime.InteropServices;
public class WD_DLL??????? // 創建類，命名為 WD_DLL
{
[DllImport(“TSCLIB.dll”, EntryPoint = “openport”)]
public static extern int openport(string printername);???? ??// 引用DLL函數：打印機名稱，入口點為 openport
[DllImport(“TSCLIB.dll”, EntryPoint = “setup”)]??????? ?// 引用DLL函數：打印機首選項設置，入口點為 setup
public static extern int setup(string width, string height,
string speed, string density,
string sensor, string vertical,
string offset);
[DllImport(“TSCLIB.dll”, EntryPoint = “clearbuffer”)]???? // 引用DLL函數：清理打印機緩存，入口點為 clearbuffer
public static extern int clearbuffer();
[DllImport(“TSCLIB.dll”, EntryPoint = “windowsfont”)]? ? ?? // 引用DLL函數：調用系統字體，入口點為 windowsfont
public static extern int windowsfont(int x, int y, int fontheight,
int rotation, int fontstyle, int fontunderline,
string szFaceName, string content);
[DllImport(“TSCLIB.dll”, EntryPoint = “sendcommand”)]???? // 引用DLL函數：發送機器指令，入口點為 sendcommand??? public static extern int sendcommand(string printercommand);
[DllImport(“TSCLIB.dll”, EntryPoint = “printlabel”)]???? // 引用DLL函數：設置打印分數，入口點為 printlabel
public static extern int printlabel(string set, string copy);
[DllImport(“TSCLIB.dll”, EntryPoint = “closeport”)]??? // 引用DLL函數：關閉驅動，入口點為 closeport
public static extern int closeport();
}
namespace Wpf_wdqrcode????????????????????????? // 創建一個namespace，命名為 Wpf_wdqrcode
{
/// <summary>
/// MainWindow.xaml 的交互邏輯
/// </summary>
public partial class MainWindow : Window
{
public MainWindow()
{
InitializeComponent();
}
private void Button_Click(object sender, RoutedEventArgs e)
{
string str_name, str_sex, str_age, str_bedno, str_ks, str_zyh;?????? // 創建打印文本的對應變量
str_name = “姓名：” + “調用姓名”;
str_sex = “性別：” + “調用性別”;
str_age = “年齡：” + “調用年齡”;
str_bedno = “床號：” + “調用床號”;
str_ks = “科室：” + “調用科室”;
str_zyh = “住院號：” + “55219949”;
if (str_ks == “新生兒科”)? ????// 根據科室判斷調用打印參數
{
//158×30新生兒腕帶建議參數：
WD_DLL.openport(“格瑞斯? GRIS-05GZ”);
WD_DLL.setup(“30″, “140”, “4”, “8”, “1”, “3”, “0”);
WD_DLL.clearbuffer();
WD_DLL.sendcommand(“QRCODE 163,375,L,4,A,90,M2,S0,\”55219949\””);
WD_DLL.windowsfont(165, 135, 19, 270, 2, 0, “宋體”, str_name);
WD_DLL.windowsfont(165, 275, 19, 270, 2, 0, “宋體”, str_sex);
WD_DLL.windowsfont(125, 135, 19, 270, 2, 0, “宋體”, str_age);
WD_DLL.windowsfont(125, 275, 19, 270, 2, 0, “宋體”, str_bedno);
WD_DLL.windowsfont(85, 135, 19, 270, 2, 0, “宋體”, str_ks);
WD_DLL.windowsfont(85, 275, 19, 270, 2, 0, “宋體”, str_zyh);
WD_DLL.printlabel(“1″, “1”);
WD_DLL.closeport();
}
else if (str_ks == “兒科”)????????? ?// 根據科室判斷調用打印參數
{
//220×30兒童腕帶建議參數：
WD_DLL.openport(“格瑞斯? GRIS-05GZ”);
WD_DLL.setup(“30″, “190”, “4”, “8”, “1”, “3”, “0”);
WD_DLL.clearbuffer();
WD_DLL.sendcommand(“QRCODE 160,615,L,5,A,90,M2,S0,\”55219949\””);
WD_DLL.windowsfont(180, 175, 25, 270, 2, 0, “宋體”, str_name);
WD_DLL.windowsfont(180, 395, 25, 270, 2, 0, “宋體”, str_sex);
WD_DLL.windowsfont(130, 175, 25, 270, 2, 0, “宋體”, str_age);
WD_DLL.windowsfont(130, 395, 25, 270, 2, 0, “宋體”, str_bedno);
WD_DLL.windowsfont(80, 175, 25, 270, 2, 0, “宋體”, str_ks);
WD_DLL.windowsfont(80, 395, 25, 270, 2, 0, “宋體”, str_zyh);
WD_DLL.printlabel(“1″, “1”);
WD_DLL.closeport();
}
else?????????? ??// 根據科室判斷調用打印參數
{
//280×30成人腕帶建議參數：
WD_DLL.openport(“格瑞斯? GRIS-05GZ”);
WD_DLL.setup(“30″, “190”, “4”, “6”, “1”, “3”, “0”);
WD_DLL.clearbuffer();
WD_DLL.sendcommand(“QRCODE 175,720,L,6,A,90,M2,S0,\”55219949\””);
WD_DLL.windowsfont(180, 190, 30, 270, 2, 0, “宋體”, str_name);
WD_DLL.windowsfont(180, 470, 30, 270, 2, 0, “宋體”, str_sex);
WD_DLL.windowsfont(130, 190, 30, 270, 2, 0, “宋體”, str_age);
WD_DLL.windowsfont(130, 470, 30, 270, 2, 0, “宋體”, str_bedno);
WD_DLL.windowsfont(80, 190, 30, 270, 2, 0, “宋體”, str_ks);
WD_DLL.windowsfont(80, 470, 30, 270, 2, 0, “宋體”, str_zyh);
WD_DLL.printlabel(“1″, “1”);
WD_DLL.closeport();
}
}
}
}
上面是C#的完整調用指令，如果換成其他語言，方法類似，機器語言完全一樣，例如Delphi，打印腕帶部分可寫為：
unit Unit1;
interface
uses
Windows, Messages, SysUtils, Classes, Graphics, Controls, Forms, Dialogs,
StdCtrls;
type
TForm1 = class(TForm)
Button1: TButton;
procedure Button1Click(Sender: TObject);
private
{ Private declarations }
public
{ Public declarations }
end;
var
Form1: TForm1;
implementation
{$R *.DFM}
procedure openport(PrinterName:pchar);stdcall;far; external ‘tsclib.dll';
procedure closeport; external ‘tsclib.dll';
procedure sendcommand(Command:pchar);stdcall;far;external ‘tsclib.dll';
procedure setup(LabelWidth, LabelHeight, Speed, Density, Sensor, Vertical, Offset:pchar);stdcall; far; external ‘tsclib.dll';
procedure printerfont(X, Y, FontName, Rotation, Xmul, Ymul, Content:pchar);stdcall;far; external ‘tsclib.dll';
procedure clearbuffer; external ‘tsclib.dll';
procedure printlabel(NumberOfSet, NumberOfCopoy:pchar);stdcall; far;external ‘tsclib.dll';
procedure windowsfont (X, Y, FontHeight, Rotation, FontStyle, FontUnderline : integer; FaceName,
procedure TForm1.Button1Click(Sender: TObject);
var
i: Integer;
begin
openport(‘格瑞斯? GRIS-05GZ’);??????????????????????????????? ???//調用打印機驅動
for i:=1 to 1 do
begin
setup(’30’, ‘190’, ‘4’, ‘6’, ‘1’, ‘3’, ‘0’);?????????????????? ??//設置寬度為“30mm”，高度為“190mm”（成人和兒童腕帶設為190mm，新生兒腕帶需設置為140mm），打印速度為“4寸/秒”，打印濃度為“6”，黑標感應開啟“1”，黑標寬度為“3”mm
clearbuffer;????????????????????????????????????????????????? ???//清理打印機緩存
sendcommand(‘QRCODE 165,740,L,5,A,90,M2,S0,”55219949″‘);?????? ??//自動生成二維碼。“55219949”可替換為變量 。備注：“165”為上下位置，數字越大越靠上；“740”為左右位置，數字越大越靠右；第5項“6”為二維碼大小調整級別為1~10
windowsfont(180, 190, 30, 270, 2, 0, ‘宋體’,? ‘姓名：張三’);??? ?//寫入文本內容，“姓名：張三”可以替換為變量；（“180”為上下位置，數字越大越靠上；“190”為左右位置，數字越大越靠右；30為字體大小，數字越大文字越大）
windowsfont(180, 470, 30, 270, 2, 0, ‘宋體’, ‘性別：男’);?????? ?//寫入文本內容，“性別：男”可以替換為變量
windowsfont(130, 190, 30, 270, 2, 0, ‘宋體’, ‘年齡：34′);?????? ?//寫入文本內容，“年齡：34”可以替換為變量
windowsfont(130, 470, 30, 270, 2, 0, ‘宋體’, ‘床號：12′);?????? ?//寫入文本內容，“床號：12”可以替換為變量
windowsfont(80, 190, 30, 270, 2, 0, ‘宋體’, ‘科室：骨科’);????? ?//寫入文本內容，“科室：骨科”可以替換為變量
windowsfont(80, 470, 30, 270, 2, 0, ‘宋體’, ‘住院號：55219949′); //寫入文本內容，“住院號：55219949”可以替換為變量
printlabel(‘1′, ‘1’);???????????????????????????????????????? ???//打印內容為 1份
end;
closeport;
end;
end.
以上為兩個打印腕帶的實例，標簽打印機GRIS-03GR類似，只要設置好setup再用windowsfont調整打印位置即可。
瓶簽Setup的設置請詳細閱讀上面第3節。
我們提供了目前最常見幾種程序實例，打印腕帶需要更改打印機相應參數以下是參數實例：
//280×30成人腕帶建議參數：
openport(“格瑞斯? GRIS-05GZ”);
//調用打印機驅動
setup(“30″, “190”, “4”, “6”, “1”, “3”, “0”);
//設置寬度為“30mm”，高度為“190mm”（成人和兒童腕帶設為190mm，新生兒腕帶需設置為140mm），打印速度為“4寸/秒”，打印濃度為“6”，黑標感應開啟“1”，黑標寬度為“3”mm
clearbuffer();
//清理打印機緩存
sendcommand(“QRCODE 175,720,L,6,A,90,M2,S0,\”55219949\””);
//自動生成二維碼。“55219949”可替換為變量 。備注：“175”為上下位置，數字越大越靠上；“720”為左右位置，數字越大越靠右；第5項“6”為二維碼大小調整級別為1~10
windowsfont(180, 190, 30, 270, 2, 0, “宋體”, “姓名：昆山格瑞斯”);
//寫入文本內容，“姓名：昆山格瑞斯”可以替換為變量；（“180”為上下位置，數字越大越靠上；“210”為左右位置，數字越大越靠右；30為字體大小，數字越大文字越大）
windowsfont(180, 470, 30, 270, 2, 0, “宋體”, “性別：男”);
//寫入文本內容，“性別：男”可以替換為變量
windowsfont(130, 190, 30, 270, 2, 0, “宋體”, “年齡：77″);
//寫入文本內容，“年齡：77”可以替換為變量
windowsfont(130, 470, 30, 270, 2, 0, “宋體”, “床號：24″);
//寫入文本內容，“床號：24”可以替換為變量
windowsfont(80, 190, 30, 270, 2, 0, “宋體”, “科室：骨科一區”);
//寫入文本內容，“科室：骨科一區”可以替換為變量
windowsfont(80, 470, 30, 270, 2, 0, “宋體”, “住院號：55219949″);
//寫入文本內容，“住院號：55219949”可以替換為變量
printlabel(“1″, “1”);
//合并打印腕帶內容
closeport();
//關閉驅動端口
//220×30兒童腕帶建議參數：
openport(“格瑞斯? GRIS-05GZ”);
//調用打印機驅動
setup(“30″, “190”, “4”, “8”, “1”, “3”, “0”);
//設置寬度為“30mm”，高度為“190mm”（成人和兒童腕帶設為190mm，新生兒腕帶需設置為140mm），打印速度為“4寸/秒”，打印濃度為“6”，黑標感應開啟“1”，黑標寬度為“3”mm
clearbuffer();
//清理打印機緩存
sendcommand(“QRCODE 160,615,L,5,A,90,M2,S0,\”55219949\””);
//自動生成二維碼。“55219949”可替換為變量 。備注：“160”為上下位置，數字越大越靠上；“615”為左右位置，數字越大越靠右；第5項“5”為二維碼大小調整級別為1~10
windowsfont(180, 175, 25, 270, 2, 0, “宋體”, “姓名：昆山格瑞斯”);
//寫入文本內容，“姓名：昆山格瑞斯”可以替換為變量；（“180”為上下位置，數字越大越靠上；“175”為左右位置，數字越大越靠右；30為字體大小，數字越大文字越大）
windowsfont(180, 395, 25, 270, 2, 0, “宋體”, “性別：男”);
//寫入文本內容，“性別：男”可以替換為變量
windowsfont(130, 175, 25, 270, 2, 0, “宋體”, “年齡：7″);
//寫入文本內容，“年齡：7”可以替換為變量
windowsfont(130, 395, 25, 270, 2, 0, “宋體”, “床號：21″);
//寫入文本內容，“床號：21”可以替換為變量
windowsfont(80, 175, 25, 270, 2, 0, “宋體”, “科室：兒科一區”);
//寫入文本內容，“科室：兒科一區”可以替換為變量
windowsfont(80, 395, 25, 270, 2, 0, “宋體”, “住院號：55219949″);
//寫入文本內容，“住院號：55219949”可以替換為變量
printlabel(“1″, “1”);
//合并打印腕帶內容
closeport();
//關閉驅動端口
//158×30新生兒腕帶建議參數：
openport(“格瑞斯? GRIS-05GZ”);
//調用打印機驅動
setup(“30″, “140”, “4”, “8”, “1”, “3”, “0”);
//設置寬度為“30mm”，高度為“140mm”（成人和兒童腕帶設為190mm，新生兒腕帶需設置為140mm），打印速度為“4寸/秒”，打印濃度為“6”，黑標感應開啟“1”，黑標寬度為“3”mm
clearbuffer();
//清理打印機緩存
sendcommand(“QRCODE 163,375,L,4,A,90,M2,S0,\”55219949\””);
//自動生成二維碼。“55219949”可替換為變量 。備注：“163”為上下位置，數字越大越靠上；“375”為左右位置，數字越大越靠右；第5項“4”為二維碼大小調整級別為1~10
windowsfont(165, 135, 19, 270, 2, 0, “宋體”, “姓名：格瑞斯”);
//寫入文本內容，“姓名：格瑞斯”可以替換為變量；（“165”為上下位置，數字越大越靠上；“135”為左右位置，數字越大越靠右；“19”為字體大小，數字越大字體越大）
windowsfont(165, 275, 19, 270, 2, 0, “宋體”, “性別：女”);
//寫入文本內容，“性別：女”可以替換為一個變量
windowsfont(125, 135, 19, 270, 2, 0, “宋體”, “年齡：12天”);
//寫入文本內容，“年齡：12天”可以替換為一個變量
windowsfont(125, 275, 19, 270, 2, 0, “宋體”, “床號：A3″);
//寫入文本內容，“床號：A3”可以替換為一個變量
windowsfont(85, 135, 19, 270, 2, 0, “宋體”, “科室：新生兒科”);
//寫入文本內容，“科室：新生兒科”可以替換為一個變量
windowsfont(85, 275, 19, 270, 2, 0, “宋體”, “住院號：55219949″);
//寫入文本內容，“住院號：55219949”可以替換為一個變量
printlabel(“1″, “1”);
//合并打印腕帶內容
closeport();
//關閉驅動端口
備注：
windowsfont項可根據實際情況調整打印內容和打印位置。
一維條碼打印參數如下：
barcode(“175″, “750”, “128”, “100”, “1”, “90”, “2”, “2”, “051255219949”);
// 自動生成一維碼。”051255219949″ 可替換為變量 。備注：“175”為上下位置，數字越大越靠上；“750”為左右位置，數字越大越靠右；第4項”100″為條碼高度，可設置小一些；第5項“1”是否顯示一維碼數字，1為顯示0為隱藏。
