TSPL / TSPL2 完整指令集中文手册 Part 2

博主：墨少离
发布时间：2026 年 08 月 05 日
1 次浏览
暂无评论
4816字数
分类：笔记

TSPL / TSPL2 完整指令集中文手册

Part 2 - 文字、条码、二维码、图形指令

1. TEXT

功能

打印单行文字。

TEXT 是 TSPL 中最常用的文字打印指令。

语法

TEXT x,y,font,rotation,x-multiple,y-multiple,"content"

参数说明

参数	类型	说明
x	数字	X坐标
y	数字	Y坐标
font	字符串	字体
rotation	数字	旋转角度
x-multiple	数字	横向放大
y-multiple	数字	纵向放大
content	字符串	打印内容

示例

TEXT 50,50,"3",0,1,1,"Hello TSPL"

打印：

Hello TSPL

旋转参数

参数	角度
0	0°
90	90°
180	180°
270	270°

示例：

TEXT 50,50,"3",90,1,1,"ABC"

放大参数

例如：

TEXT 50,50,"3",0,2,2,"TEST"

表示：

横向放大：

2倍

纵向放大：

2倍

常用字体

字体	说明
"0"	8×12
"1"	8×16
"2"	12×24
"3"	16×24
"4"	24×32
"5"	32×48

Windows 字体

部分 TSPL2 支持外部字体：

例如：

TEXT 100,100,"Arial",0,1,1,"Hello"

2. BLOCK

功能

打印多行文本。

适用于：

地址
产品描述
备注信息

语法

BLOCK x,y,width,height,font,rotation,x-multiple,y-multiple,"content"

参数

参数	说明
x	起始X坐标
y	起始Y坐标
width	文本区域宽度
height	文本区域高度
font	字体
rotation	旋转
x-multiple	横向倍数
y-multiple	纵向倍数
content	内容

示例

BLOCK 20,20,300,100,"3",0,1,1,"上海市浦东新区测试地址"

效果：

上海市浦东新区
测试地址

3. 中文打印设置

中文打印通常需要：

设置 CODEPAGE
使用中文字体
使用正确编码发送数据

GB2312

CODEPAGE 936

适合：

Windows GBK
GB2312编码

UTF-8

CODEPAGE 65001

适合：

Linux
Web系统
跨平台应用

示例

SIZE 100 mm,50 mm

CODEPAGE 936

CLS

TEXT 50,50,"TSS24.BF2",0,1,1,"测试标签"

PRINT 1

4. BAR

功能

绘制横线或竖线。

语法

BAR x,y,width,height

参数

参数	说明
x	起点X
y	起点Y
width	宽度
height	高度

示例

BAR 20,200,400,3

效果：

-----------------------

5. BOX

功能

绘制矩形框。

语法

BOX x1,y1,x2,y2,line-width

参数

参数	说明
x1	左上角X
y1	左上角Y
x2	右下角X
y2	右下角Y
line-width	线宽

示例

BOX 20,20,400,300,3

效果：

+----------------+
|                |
|                |
+----------------+

6. ELLIPSE

功能

绘制椭圆。

语法

ELLIPSE x1,y1,x2,y2,line-width

示例

ELLIPSE 50,50,200,150,3

7. BARCODE

功能

打印一维条码。

语法

BARCODE x,y,code-type,height,human-readable,rotation,narrow,wide,"data"

参数

参数	说明
x	X坐标
y	Y坐标
code-type	条码类型
height	条码高度
human-readable	显示数字
rotation	旋转
narrow	窄条宽
wide	宽条宽
data	条码数据

示例

BARCODE 50,100,"128",80,1,0,2,2,"123456789"

支持条码类型

类型	说明
128	Code 128
39	Code 39
93	Code 93
EAN13	EAN-13
EAN8	EAN-8
UPCA	UPC-A
UPCE	UPC-E
ITF	Interleaved 2 of 5
ITF14	ITF-14
CODABAR	Codabar
MSI	MSI

CODE128 示例

SIZE 100 mm,50 mm

CLS

BARCODE 50,50,"128",80,1,0,2,2,"123456789"

PRINT 1

8. QRCODE

功能

打印二维码。

语法

QRCODE x,y,ECC,cell-size,mode,rotation,"data"

参数

参数	说明
x	X坐标
y	Y坐标
ECC	容错等级
cell-size	二维码大小
mode	模式
rotation	旋转
data	内容

示例

QRCODE 50,50,L,5,A,0,"https://example.com"

ECC等级

等级	容错
L	7%
M	15%
Q	25%
H	30%

QR示例

SIZE 100 mm,100 mm

CLS

QRCODE 100,100,H,8,A,0,"TSPL TEST"

PRINT 1

9. PDF417

功能

打印 PDF417 二维码。

语法

PDF417 x,y,width,height,rotate,option,"data"

应用

常用于：

物流
身份证
大容量数据

10. DMATRIX

功能

打印 Data Matrix。

语法

DMATRIX x,y,"data"

应用

常用于：

工业追溯
零件编码
医疗标签

综合示例

SIZE 100 mm,50 mm

GAP 3 mm,0

DIRECTION 0

CLS

TEXT 50,30,"3",0,2,2,"产品标签"

BARCODE 50,100,"128",60,1,0,2,2,"690123456789"

QRCODE 300,50,L,5,A,0,"https://example.com"

BOX 20,20,500,220,2

PRINT 1

Part 2 完

下一部分：

Part 3 - 图片、字体、文件系统指令

包含：

BITMAP
PUTBMP
PUTPCX
DOWNLOAD
EOP
FILES
REMOVE
MOVE
RUN
内存管理
字体下载

最后修改：2026 年 08 月 05 日

如果觉得我的文章对你有用，请随意赞赏

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

评论 *

私密评论

名称 *

🎲

邮箱 *

地址

TSPL / TSPL2 完整指令集中文手册 Part 2

墨少离 • 2026 年 08 月 05 日

<h1>TSPL / TSPL2 完整指令集中文手册</h1><h1>Part 2 - <a href="https://www.msl.la/tag/%E6%96%87%E5%AD%97/"target="_self" title="文字">文字</a>、条码、二维码、图形指令</h1><hr><h1>目录</h1><ul><li><ol><li>TEXT</li></ol></li><li><ol start="2"><li>BLOCK</li></ol></li><li><ol start="3"><li>CODEPAGE 与中文打印</li></ol></li><li><ol start="4"><li>BAR</li></ol></li><li><ol start="5"><li>BOX</li></ol></li><li><ol start="6"><li>ELLIPSE</li></ol></li><li><ol start="7"><li>BARCODE</li></ol></li><li><ol start="8"><li>QRCODE</li></ol></li><li><ol start="9"><li>PDF417</li></ol></li><li><ol start="10"><li>DMATRIX</li></ol></li></ul><hr><h1>1. TEXT</h1><h2>功能</h2><p>打印单行文字。</p><p>TEXT 是 TSPL 中最常用的文字打印指令。</p><hr><h2>语法</h2><pre><code class="lang-tspl">TEXT x,y,font,rotation,x-multiple,y-multiple,&quot;content&quot;</code></pre><hr><h2>参数说明</h2><table><thead><tr><th>参数</th><th>类型</th><th>说明</th></tr></thead><tbody><tr><td>x</td><td><a href="https://www.msl.la/tag/%E6%95%B0%E5%AD%97/"target="_self" title="数字">数字</a></td><td>X坐标</td></tr><tr><td>y</td><td>数字</td><td>Y坐标</td></tr><tr><td>font</td><td>字符串</td><td>字体</td></tr><tr><td>rotation</td><td>数字</td><td>旋转角度</td></tr><tr><td>x-multiple</td><td>数字</td><td>横向放大</td></tr><tr><td>y-multiple</td><td>数字</td><td>纵向放大</td></tr><tr><td>content</td><td>字符串</td><td>打印内容</td></tr></tbody></table><hr><h2>示例</h2><pre><code class="lang-tspl">TEXT 50,50,&quot;3&quot;,0,1,1,&quot;Hello TSPL&quot;</code></pre><p>打印：</p><pre><code>Hello TSPL</code></pre><hr><h1>旋转参数</h1><table><thead><tr><th>参数</th><th>角度</th></tr></thead><tbody><tr><td>0</td><td>0°</td></tr><tr><td>90</td><td>90°</td></tr><tr><td>180</td><td>180°</td></tr><tr><td>270</td><td>270°</td></tr></tbody></table><p>示例：</p><pre><code class="lang-tspl">TEXT 50,50,&quot;3&quot;,90,1,1,&quot;ABC&quot;</code></pre><hr><h1>放大参数</h1><p>例如：</p><pre><code class="lang-tspl">TEXT 50,50,&quot;3&quot;,0,2,2,&quot;TEST&quot;</code></pre><p><a href="https://www.msl.la/tag/%E8%A1%A8%E7%A4%BA/"target="_self" title="表示">表示</a>：</p><p>横向放大：</p><pre><code>2倍</code></pre><p>纵向放大：</p><pre><code>2倍</code></pre><hr><h1>常用字体</h1><table><thead><tr><th>字体</th><th>说明</th></tr></thead><tbody><tr><td>"0"</td><td>8×12</td></tr><tr><td>"1"</td><td>8×16</td></tr><tr><td>"2"</td><td>12×24</td></tr><tr><td>"3"</td><td>16×24</td></tr><tr><td>"4"</td><td>24×32</td></tr><tr><td>"5"</td><td>32×48</td></tr></tbody></table><hr><h1>Windows 字体</h1><p>部分 TSPL2 支持外部字体：</p><p>例如：</p><pre><code class="lang-tspl">TEXT 100,100,&quot;Arial&quot;,0,1,1,&quot;Hello&quot;</code></pre><hr><h1>2. BLOCK</h1><h2>功能</h2><p>打印多行文本。</p><p>适用于：</p><ul><li>地址</li><li>产品描述</li><li>备注信息</li></ul><hr><h2>语法</h2><pre><code class="lang-tspl">BLOCK x,y,width,height,font,rotation,x-multiple,y-multiple,&quot;content&quot;</code></pre><hr><h2>参数</h2><table><thead><tr><th>参数</th><th>说明</th></tr></thead><tbody><tr><td>x</td><td>起始X坐标</td></tr><tr><td>y</td><td>起始Y坐标</td></tr><tr><td>width</td><td>文本区域宽度</td></tr><tr><td>height</td><td>文本区域高度</td></tr><tr><td>font</td><td>字体</td></tr><tr><td>rotation</td><td>旋转</td></tr><tr><td>x-multiple</td><td>横向倍数</td></tr><tr><td>y-multiple</td><td>纵向倍数</td></tr><tr><td>content</td><td>内容</td></tr></tbody></table><hr><h2>示例</h2><pre><code class="lang-tspl">BLOCK 20,20,300,100,&quot;3&quot;,0,1,1,&quot;上海市浦东新区测试地址&quot;</code></pre><p>效果：</p><pre><code>上海市浦东新区
测试地址</code></pre><hr><h1>3. 中文打印设置</h1><p>中文打印通常需要：</p><ol><li>设置 CODEPAGE</li><li>使用中文字体</li><li>使用正确编码发送数据</li></ol><hr><h2>GB2312</h2><pre><code class="lang-tspl">CODEPAGE 936</code></pre><p>适合：</p><ul><li>Windows GBK</li><li>GB2312编码</li></ul><hr><h2>UTF-8</h2><pre><code class="lang-tspl">CODEPAGE 65001</code></pre><p>适合：</p><ul><li>Linux</li><li>Web系统</li><li>跨平台<a href="https://www.msl.la/tag/%E5%BA%94%E7%94%A8/"target="_self" title="应用">应用</a></li></ul><hr><h2>示例</h2><pre><code class="lang-tspl">SIZE 100 mm,50 mm

CODEPAGE 936

CLS

TEXT 50,50,&quot;TSS24.BF2&quot;,0,1,1,&quot;测试标签&quot;

PRINT 1</code></pre><hr><h1>4. BAR</h1><h2>功能</h2><p>绘制横线或竖线。</p><hr><h2>语法</h2><pre><code class="lang-tspl">BAR x,y,width,height</code></pre><hr><h2>参数</h2><table><thead><tr><th>参数</th><th>说明</th></tr></thead><tbody><tr><td>x</td><td>起点X</td></tr><tr><td>y</td><td>起点Y</td></tr><tr><td>width</td><td>宽度</td></tr><tr><td>height</td><td>高度</td></tr></tbody></table><hr><h2>示例</h2><pre><code class="lang-tspl">BAR 20,200,400,3</code></pre><p>效果：</p><pre><code>-----------------------</code></pre><hr><h1>5. BOX</h1><h2>功能</h2><p>绘制矩形<a href="https://www.msl.la/tag/%E6%A1%86/"target="_self" title="框">框</a>。</p><hr><h2>语法</h2><pre><code class="lang-tspl">BOX x1,y1,x2,y2,line-width</code></pre><hr><h2>参数</h2><table><thead><tr><th>参数</th><th>说明</th></tr></thead><tbody><tr><td>x1</td><td>左上角X</td></tr><tr><td>y1</td><td>左上角Y</td></tr><tr><td>x2</td><td>右下角X</td></tr><tr><td>y2</td><td>右下角Y</td></tr><tr><td>line-width</td><td>线宽</td></tr></tbody></table><hr><h2>示例</h2><pre><code class="lang-tspl">BOX 20,20,400,300,3</code></pre><p>效果：</p><pre><code>+----------------+
|                |
|                |
+----------------+</code></pre><hr><h1>6. ELLIPSE</h1><h2>功能</h2><p>绘制椭圆。</p><hr><h2>语法</h2><pre><code class="lang-tspl">ELLIPSE x1,y1,x2,y2,line-width</code></pre><hr><h2>示例</h2><pre><code class="lang-tspl">ELLIPSE 50,50,200,150,3</code></pre><hr><h1>7. BARCODE</h1><h2>功能</h2><p>打印一维条码。</p><hr><h2>语法</h2><pre><code class="lang-tspl">BARCODE x,y,code-type,height,human-readable,rotation,narrow,wide,&quot;data&quot;</code></pre><hr><h2>参数</h2><table><thead><tr><th>参数</th><th>说明</th></tr></thead><tbody><tr><td>x</td><td>X坐标</td></tr><tr><td>y</td><td>Y坐标</td></tr><tr><td>code-type</td><td>条码类型</td></tr><tr><td>height</td><td>条码高度</td></tr><tr><td>human-readable</td><td>显示数字</td></tr><tr><td>rotation</td><td>旋转</td></tr><tr><td>narrow</td><td>窄条宽</td></tr><tr><td>wide</td><td>宽条宽</td></tr><tr><td>data</td><td>条码数据</td></tr></tbody></table><hr><h2>示例</h2><pre><code class="lang-tspl">BARCODE 50,100,&quot;128&quot;,80,1,0,2,2,&quot;123456789&quot;</code></pre><hr><h1>支持条码类型</h1><table><thead><tr><th>类型</th><th>说明</th></tr></thead><tbody><tr><td>128</td><td>Code 128</td></tr><tr><td>39</td><td>Code 39</td></tr><tr><td>93</td><td>Code 93</td></tr><tr><td>EAN13</td><td>EAN-13</td></tr><tr><td>EAN8</td><td>EAN-8</td></tr><tr><td>UPCA</td><td>UPC-A</td></tr><tr><td>UPCE</td><td>UPC-E</td></tr><tr><td>ITF</td><td>Interleaved 2 of 5</td></tr><tr><td>ITF14</td><td>ITF-14</td></tr><tr><td>CODABAR</td><td>Codabar</td></tr><tr><td>MSI</td><td>MSI</td></tr></tbody></table><hr><h1>CODE128 示例</h1><pre><code class="lang-tspl">SIZE 100 mm,50 mm

CLS

BARCODE 50,50,&quot;128&quot;,80,1,0,2,2,&quot;123456789&quot;

PRINT 1</code></pre><hr><h1>8. QRCODE</h1><h2>功能</h2><p>打印二维码。</p><hr><h2>语法</h2><pre><code class="lang-tspl">QRCODE x,y,ECC,cell-size,mode,rotation,&quot;data&quot;</code></pre><hr><h2>参数</h2><table><thead><tr><th>参数</th><th>说明</th></tr></thead><tbody><tr><td>x</td><td>X坐标</td></tr><tr><td>y</td><td>Y坐标</td></tr><tr><td>ECC</td><td>容错等级</td></tr><tr><td>cell-size</td><td>二维码大小</td></tr><tr><td>mode</td><td>模式</td></tr><tr><td>rotation</td><td>旋转</td></tr><tr><td>data</td><td>内容</td></tr></tbody></table><hr><h2>示例</h2><pre><code class="lang-tspl">QRCODE 50,50,L,5,A,0,&quot;https://example.com&quot;</code></pre><hr><h1>ECC等级</h1><table><thead><tr><th>等级</th><th>容错</th></tr></thead><tbody><tr><td>L</td><td>7%</td></tr><tr><td>M</td><td>15%</td></tr><tr><td>Q</td><td>25%</td></tr><tr><td>H</td><td>30%</td></tr></tbody></table><hr><h1>QR示例</h1><pre><code class="lang-tspl">SIZE 100 mm,100 mm

CLS

QRCODE 100,100,H,8,A,0,&quot;TSPL TEST&quot;

PRINT 1</code></pre><hr><h1>9. PDF417</h1><h2>功能</h2><p>打印 PDF417 二维码。</p><hr><h2>语法</h2><pre><code class="lang-tspl">PDF417 x,y,width,height,rotate,option,&quot;data&quot;</code></pre><hr><h2>应用</h2><p>常用于：</p><ul><li>物流</li><li>身份证</li><li>大容量数据</li></ul><hr><h1>10. DMATRIX</h1><h2>功能</h2><p>打印 Data Matrix。</p><hr><h2>语法</h2><pre><code class="lang-tspl">DMATRIX x,y,&quot;data&quot;</code></pre><hr><h2>应用</h2><p>常用于：</p><ul><li>工业追溯</li><li>零件编码</li><li>医疗标签</li></ul><hr><h1>综合示例</h1><pre><code class="lang-tspl">SIZE 100 mm,50 mm

GAP 3 mm,0

DIRECTION 0

CLS

TEXT 50,30,&quot;3&quot;,0,2,2,&quot;产品标签&quot;

BARCODE 50,100,&quot;128&quot;,60,1,0,2,2,&quot;690123456789&quot;

QRCODE 300,50,L,5,A,0,&quot;https://example.com&quot;

BOX 20,20,500,220,2

PRINT 1</code></pre><hr><h1>Part 2 完</h1><p>下一部分：</p><h1>Part 3 - 图片、字体、文件系统指令</h1><p>包含：</p><ul><li>BITMAP</li><li>PUTBMP</li><li>PUTPCX</li><li>DOWNLOAD</li><li>EOP</li><li>FILES</li><li>REMOVE</li><li>MOVE</li><li>RUN</li><li>内存管理</li><li>字体下载</li></ul>

TSPL / TSPL2 完整指令集中文手册

Part 2 - 文字、条码、二维码、图形指令

目录

1. TEXT

功能

语法

参数说明

示例

旋转参数

放大参数

常用字体

Windows 字体

2. BLOCK

功能

语法

参数

示例

3. 中文打印设置

GB2312

UTF-8

示例

4. BAR

功能

语法

参数

示例

5. BOX

功能

语法

参数

示例

6. ELLIPSE

功能

语法

示例

7. BARCODE

功能

语法

参数

示例

支持条码类型

CODE128 示例

8. QRCODE

功能

语法

参数

示例

ECC等级

QR示例

9. PDF417

功能

语法

应用

10. DMATRIX

功能

语法

应用

综合示例

Part 2 完

Part 3 - 图片、字体、文件系统指令

发表评论 取消回复 使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款

TSPL / TSPL2 完整指令集中文手册 Part 2

发表评论取消回复
使用cookie技术保留您的个人信息以便您下次快速评论，继续评论表示您已同意该条款