# xsg-for-printer **Repository Path**: gzghde/xsg-printer ## Basic Information - **Project Name**: xsg-for-printer - **Description**: 面单打印, 简洁快速的配置打印面单，适配多种指令集，支持输出图片，pdf，指令多种类型，解决打印繁琐，场景复杂问题，仅需配置模板即可适配多种打印机，支持简易的图片拼装绘制 - **Primary Language**: Java - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 4 - **Forks**: 3 - **Created**: 2022-02-07 - **Last Updated**: 2025-04-12 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # xsg-for-printer #### 介绍 小票面单打印场景比较多，各类打印机支持的文件/指令层次不齐，适配各种不同打印机比较繁琐，占据大量的开发时间，且难以统一维护!!! #### 设计思路 将面单样式打印的底层逻辑统一，定义抽象出面单所具备的所有属性，使其可配置化，可视化，根据面单模版配置去适配不同的打印场景 #### ER模型及流程 ![输入图片说明](%E9%9D%A2%E5%8D%95.png) #### 输出类型： 1.包含TSPL,CPCL,ESC三大主流的打印指令类型，适配支持指令打印的打印机 2.PDF类型：适配支持PDF打印的打印机 3.图片类型：适配支持图片打印的打印机 #### 功能说明： 1.支持画直线：两点之间的连线 2.支持画圆：对应半径为R的圆 3.支持画图：将本地图文件映射到面单 4.支持画文字：对应字体对应大小的文字 5.支持画二维码：二维码生成 6.支持画条形码：条形码生成 7.支持自适应宽高 8.内容动态填充 9.面单模版可自由定制 #### 示例： ##### 1.图片 ![db82f7fa-5791-48a0-bf2a-6047edbeefa0](https://user-images.githubusercontent.com/35826080/131413117-b7d73c87-efe3-42be-bd5a-dc0d0788ca94.png) ##### 1.TSPL指令： SIZE 70 mm,100 mm GAP 2 mm,0 mm CLS BAR 0,80,560,1 TEXT 8,19,"TSS32.BF2",0,1,1,"#38" TEXT 9,20,"TSS32.BF2",0,1,1,"#38" TEXT 264,15,"TSS24.BF2",0,1,1,"xx快送" TEXT 265,16,"TSS24.BF2",0,1,1,"xx快送" TEXT 264,45,"TSS24.BF2",0,1,1,"客服:15613874848" BAR 0,144,560,1 TEXT 16,96,"TSS32.BF2",0,1,1,"罗湖" TEXT 17,97,"TSS32.BF2",0,1,1,"xx罗湖" TEXT 92,104,"TSS24.BF2",0,1,1,"xx街道" BAR 0,288,560,1 TEXT 5,154,"TSS32.BF2",0,1,1,"收" TEXT 6,155,"TSS32.BF2",0,1,1,"收" TEXT 81,149,"TSS32.BF2",0,1,1,"雪人汽修中心" TEXT 82,150,"TSS32.BF2",0,1,1,"雪人汽修中心" TEXT 80,190,"TSS24.BF2",0,1,1,"18129858526" TEXT 81,191,"TSS24.BF2",0,1,1,"18129858526" TEXT 81,217,"TSS24.BF2",0,1,1,"xx省xx市xx县都昌xx一中 老校区 雪人" TEXT 81,241,"TSS24.BF2",0,1,1,"汽车维修厂" BAR 0,408,560,1 TEXT 5,298,"TSS32.BF2",0,1,1,"寄" TEXT 6,299,"TSS32.BF2",0,1,1,"寄" TEXT 81,293,"TSS24.BF2",0,1,1,"xxx汽配中心" TEXT 82,294,"TSS24.BF2",0,1,1,"xxx汽配中心" TEXT 81,322,"TSS24.BF2",0,1,1,"18129872727" TEXT 81,349,"TSS24.BF2",0,1,1,"xx省xx市x县xx一中老校区一栋10" TEXT 81,373,"TSS24.BF2",0,1,1,"6大石头汽配" BAR 0,624,560,1 BAR 0,520,120,1 TEXT 30,424,"TSS32.BF2",0,1,1,"88" TEXT 31,425,"TSS32.BF2",0,1,1,"88" TEXT 15,472,"TSS24.BF2",0,1,1,"xxxx" TEXT 16,473,"TSS24.BF2",0,1,1,"xxxx" TEXT 25,536,"TSS32.BF2",0,1,1,"5件" TEXT 26,537,"TSS32.BF2",0,1,1,"5件" TEXT 25,584,"TSS24.BF2",0,1,1,"1超大333" TEXT 25,608,"TSS24.BF2",0,1,1,"大111中2" BAR 120,408,1,216 QRCODE 180,422,L,7,A,0,"BC2012187480039" TEXT 152,592,"TSS24.BF2",0,1,1,"单号:BC2012187480039" BAR 400,408,1,216 BAR 400,512,160,1 TEXT 426,440,"TSS32.BF2",0,1,1,"有代收" TEXT 427,441,"TSS32.BF2",0,1,1,"有代收" TEXT 408,520,"TSS24.BF2",0,1,1,"收件签字" TEXT 440,600,"TSS24.BF2",0,1,1,"年 月 日" BAR 0,688,560,1 TEXT 10,643,"TSS24.BF2",0,1,1,"备注: 这里有很多东西需要帮忙一起搬回家，然后放" TEXT 11,644,"TSS24.BF2",0,1,1,"备注: 这里有很多东西需要帮忙一起搬回家，然后放" TEXT 10,667,"TSS24.BF2",0,1,1,"在那个" TEXT 11,668,"TSS24.BF2",0,1,1,"在那个" BAR 0,736,560,1 TEXT 10,700,"TSS24.BF2",0,1,1,"结算: 余额支付" TEXT 11,701,"TSS24.BF2",0,1,1,"结算: 余额支付" TEXT 10,743,"TSS24.BF2",0,1,1,"打印时间:2020-12-10 12:56:30" TEXT 380,743,"TSS24.BF2",0,1,1,"打印人:李信息xx PRINT 1,1 ##### 2.cpcl指令： ! 0 200 200 800 1 PAGE-WIDTH 560 GAP-SENSE SET-TOF 0 LINE 0 80 560 80 2 SETBOLD 2 SETMAG 2 2 TEXT 55 0 8 19 #38 SETMAG 0 0 SETBOLD 0 SETBOLD 2 TEXT 11 0 264 15 小高快送 SETBOLD 0 TEXT 11 0 264 45 客服:15613874848 LINE 0 144 560 144 2 SETBOLD 2 SETMAG 2 2 TEXT 55 0 16 96 罗湖 SETMAG 0 0 SETBOLD 0 TEXT 11 0 88 104 坂田街道 LINE 0 288 560 288 2 SETBOLD 2 SETMAG 2 2 TEXT 55 0 5 154 收 SETMAG 0 0 SETBOLD 0 SETBOLD 2 SETMAG 2 2 TEXT 55 0 81 149 雪人汽修中心 SETMAG 0 0 SETBOLD 0 SETBOLD 2 TEXT 11 0 80 190 18129858526 SETBOLD 0 TEXT 11 0 81 217 xx省xx市xx县xx一中 老校区 雪人 TEXT 11 0 81 241 汽车维修厂 LINE 0 408 560 408 2 SETBOLD 2 SETMAG 2 2 TEXT 55 0 5 298 寄 SETMAG 0 0 SETBOLD 0 SETBOLD 2 TEXT 11 0 81 293 xxx汽配中心 SETBOLD 0 TEXT 11 0 81 322 18129872727 TEXT 11 0 81 349 xxxx TEXT 11 0 81 373 6xxx汽配 LINE 0 624 560 624 2 LINE 0 520 120 520 2 SETBOLD 2 SETMAG 2 2 TEXT 55 0 30 424 88 SETMAG 0 0 SETBOLD 0 SETBOLD 2 TEXT 11 0 15 472 xxxx SETBOLD 0 SETBOLD 2 SETMAG 2 2 TEXT 55 0 25 536 5件 SETMAG 0 0 SETBOLD 0 TEXT 11 0 25 584 1超大333 TEXT 11 0 25 608 大111中2 LINE 120 408 120 624 2 BARCODE QR 180 422 M 2 U 6 MA,BC2012187480039 ENDQR TEXT 11 0 152 592 单号:BC2012187480039 LINE 400 408 400 624 2 LINE 400 512 560 512 2 SETBOLD 2 SETMAG 2 2 TEXT 55 0 426 440 有代收 SETMAG 0 0 SETBOLD 0 TEXT 11 0 408 520 收件签字 TEXT 11 0 440 600 年 月 日 LINE 0 688 560 688 2 SETBOLD 2 TEXT 11 0 10 643 备注: 这里有很多东西需要帮忙一起搬回家，然后放 TEXT 11 0 10 667 在那个 SETBOLD 0 LINE 0 736 560 736 2 SETBOLD 2 TEXT 11 0 10 700 结算: 余额支付 SETBOLD 0 TEXT 11 0 10 743 打印时间:2020-12-10 12:56:30 TEXT 11 0 380 743 打印人:李xx FORM PRINT #### 参与贡献 1. Fork 本仓库 2. 新建 Feat_xxx 分支 3. 提交代码 4. 新建 Pull Request #### 特技 1. 使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md 2. Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com) 3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目 4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目 5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help) 6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)