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

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

目录

• 1. BITMAP
• 2. PUTBMP
• 3. PUTPCX
• 4. DOWNLOAD
• 5. EOP
• 6. FILES
• 7. REMOVE
• 8. MOVE
• 9. RUN
• 10. MEMORY
• 11. 字体下载流程
• 12. 图片下载流程

1. BITMAP

功能

打印位图数据。

主要用于：

• 程序生成图片
• 动态打印 Logo
• 打印自定义图形

语法

BITMAP x,y,width,height,mode,data

参数

示例

BITMAP 50,50,100,100,0,<bitmap data>

注意

BITMAP 通常用于：

• SDK直接生成数据
• 二进制发送

不适合人工编写。

2. PUTBMP

功能

打印已经存储在打印机中的 BMP 图片。

语法

PUTBMP x,y,"filename"

参数

示例

PUTBMP 50,50,"LOGO.BMP"

使用流程

步骤：

1. 下载图片

DOWNLOAD "LOGO.BMP"

2. 打印图片

PUTBMP 50,50,"LOGO.BMP"

3. PUTPCX

功能

打印 PCX 格式图片。

语法

PUTPCX x,y,"filename"

示例

PUTPCX 100,100,"IMAGE.PCX"

说明

PCX 是 TSPL 早期常用格式。

优点：

• 文件小
• 打印速度快

4. DOWNLOAD

功能

下载文件到打印机存储。

支持：

• 图片
• 字体
• 格式文件

语法

DOWNLOAD "filename"

示例

下载 Logo：

DOWNLOAD "LOGO.BMP"

下载流程

PC发送：

DOWNLOAD "LOGO.BMP"

然后：

二进制文件内容

最后：

EOP

5. EOP

功能

表示文件传输结束。

语法

EOP

示例流程

DOWNLOAD "LOGO.BMP"

<binary data>

EOP

6. FILES

功能

查看打印机存储文件。

语法

FILES

示例

发送：

FILES

返回：

LOGO.BMP
FONT.BF2
LABEL.BAS

用途

用于：

• 查看下载文件
• 调试存储空间

7. REMOVE

功能

删除打印机文件。

语法

REMOVE "filename"

示例

删除图片：

REMOVE "LOGO.BMP"

删除字体

REMOVE "FONT.BF2"

8. MOVE

功能

移动文件。

语法

MOVE "source","destination"

示例

MOVE "A.BMP","B.BMP"

9. RUN

功能

执行存储在打印机中的程序。

语法

RUN "filename"

示例

RUN "TEST.BAS"

应用

用于：

• 自动打印程序
• 内置脚本
• 快速调用模板

10. MEMORY

功能

查看存储空间。

查询：

~!T

或者：

FILES

常见存储区域

11. 字体下载

支持字体

TSPL 支持：

• TTF字体
• TSC字体
• BF字体

下载流程

第一步

发送：

DOWNLOAD "FONT.TTF"

第二步

发送字体二进制数据。

第三步

结束：

EOP

使用字体

示例：

TEXT 50,50,"FONT.TTF",0,1,1,"测试文字"

12. 图片下载流程

示例：下载Logo

发送：

DOWNLOAD "LOGO.BMP"

发送：

BMP二进制数据

结束：

EOP

打印：

PUTBMP 50,50,"LOGO.BMP"

13. 标签模板存储

部分TSPL2打印机支持保存标签模板。

流程：

保存

DOWNLOAD "LABEL.BAS"

执行

RUN "LABEL.BAS"

14. 实际应用示例

Logo + 文字 + 条码

SIZE 100 mm,50 mm

GAP 3 mm,0

CLS


PUTBMP 20,20,"LOGO.BMP"


TEXT 150,40,"3",0,2,2,"商品标签"


BARCODE 150,100,"128",60,1,0,2,2,"123456789"


PRINT 1

15. 文件管理完整流程

查看文件

FILES

删除文件

REMOVE "LOGO.BMP"

下载文件

DOWNLOAD "LOGO.BMP"

打印文件

PUTBMP 0,0,"LOGO.BMP"

Part 3 完

下一部分：

Part 4 - 状态查询、通讯协议、打印机控制

包含：

• ~!T
• ~!U
• ~!A
• ~HS
• 状态返回解析
• USB通讯
• 串口通讯
• TCP/IP通讯
• 打印错误处理