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

TSC Printer Language (TSPL / TSPL2)

适用于 TSC 标签打印机及兼容 TSPL 指令的设备

Part 1 - 基础指令与标签设置

目录

    1. TSPL 基础概念
    1. 指令格式
    1. SIZE
    1. GAP
    1. BLINE
    1. DIRECTION
    1. REFERENCE
    1. OFFSET
    1. SHIFT
    1. MIRROR
    1. SPEED
    1. DENSITY
    1. CODEPAGE
    1. SET
    1. CLS
    1. PRINT

1. TSPL 基础概念

TSPL（TSC Printer Language）是 TSC 标签打印机使用的打印控制语言。

一个 TSPL 标签打印任务通常包含：

  1. 设置标签尺寸
  2. 设置纸张类型
  3. 设置打印参数
  4. 清空缓存
  5. 绘制文字、条码、图片
  6. 执行打印

典型流程：

SIZE
GAP
DIRECTION
REFERENCE
SPEED
DENSITY
CLS

绘制内容

PRINT

2. TSPL 指令格式

TSPL 指令格式：

COMMAND 参数1,参数2,...

例如：

SIZE 100 mm,50 mm

表示：

  • 标签宽度：100mm
  • 标签高度：50mm

注释

TSPL 本身不支持传统注释。

开发中通常：

3. SIZE

功能

设置标签尺寸。

语法

SIZE width,height

或：

SIZE width mm,height mm

参数

参数类型说明
width数字标签宽度
height数字标签高度

示例

SIZE 100 mm,50 mm

表示：

标签宽度 = 100mm
标签高度 = 50mm

注意

SIZE 必须在 PRINT 前设置。

错误：

TEXT 100,100,"3",0,1,1,"TEST"

SIZE 100 mm,50 mm

正确：

SIZE 100 mm,50 mm

TEXT 100,100,"3",0,1,1,"TEST"

PRINT 1

4. GAP

功能

设置模切标签的间隙检测参数。

适用于：

  • 标签纸
  • 不干胶纸
  • 模切纸

语法

GAP gap,offset

参数

参数说明
gap标签间隙高度
offset偏移量

示例

GAP 3 mm,0

表示：

标签之间间距：

3mm

常见设置

普通标签：

GAP 2 mm,0

厚标签：

GAP 5 mm,0

5. BLINE

功能

设置黑标纸参数。

适用于：

  • 黑标定位标签
  • 连续纸黑线定位

语法

BLINE height,offset

参数

参数说明
height黑标高度
offset偏移

示例

BLINE 5 mm,0

6. DIRECTION

功能

设置打印方向。

语法

DIRECTION direction

参数

值说明
0正常打印
1旋转180度打印

示例

DIRECTION 0

正常：

ABC

方向1：

CBA(旋转)

7. REFERENCE

功能

设置打印坐标原点。

语法

REFERENCE x,y

参数

参数说明
x水平偏移
y垂直偏移

示例

REFERENCE 10,20

之后：

TEXT 0,0,"3",0,1,1,"ABC"

实际位置：

X = 10
Y = 20

应用场景

用于：

  • 整体位置调整
  • 多型号标签校准

8. OFFSET

功能

调整标签检测后的偏移。

语法

OFFSET distance

示例

OFFSET -2 mm

应用

解决：

  • 标签打印偏上
  • 标签打印偏下

9. SHIFT

功能

整体移动打印内容。

语法

SHIFT x,y

示例

SHIFT 10,20

表示：

所有打印对象：

X + 10
Y + 20

10. MIRROR

功能

镜像打印。

语法

MIRROR value

参数

值说明
0关闭
1开启

示例

MIRROR 1

11. SPEED

功能

设置打印速度。

语法

SPEED speed

常用值

速度用途
2高质量
3普通
4常用
6高速

示例

SPEED 4

12. DENSITY

功能

设置打印浓度。

语法

DENSITY level

参数范围

0 ~ 15

示例

DENSITY 8

推荐值

材料建议
热敏纸6-8
铜版纸8-10
PET10-15

13. CODEPAGE

功能

设置字符编码。

语法

CODEPAGE codepage

常用编码

编码说明
437英文
850欧洲字符
936简体中文
950繁体中文
65001UTF-8

示例

中文：

CODEPAGE 936

UTF-8：

CODEPAGE 65001

14. SET

功能

设置打印机工作模式。

语法

SET parameter value

常用设置

撕纸模式

SET TEAR ON

剥离模式

SET PEEL ON

切刀模式

SET CUTTER ON

15. CLS

功能

清除打印缓存。

语法

CLS

推荐流程

CLS

TEXT 100,100,"3",0,1,1,"TEST"

PRINT 1

16. PRINT

功能

执行打印。

语法

PRINT quantity

参数

参数说明
quantity打印数量

示例

打印1张：

PRINT 1

打印100张：

PRINT 100

Part 1 完

下一部分：

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

包含：

  • TEXT
  • BLOCK
  • BAR
  • BOX
  • ELLIPSE
  • BARCODE
  • QRCODE
  • PDF417
  • DMATRIX
最后修改：2026 年 08 月 05 日
© 允许规范转载
如果觉得我的文章对你有用，请随意赞赏