esc_utils 0.0.1 copy "esc_utils: ^0.0.1" to clipboard
esc_utils: ^0.0.1 copied to clipboard

小票打印机 *ESC* 数据转换工具,主要用于将 image 图像转换成小票打印机可识别的字节数组

esc_utils #

小票打印机 ESC 数据转换工具,主要用于将 image 图像转换成小票打印机可识别的字节数组。

内部图像处理使用 image: ^3.0.2

使用示例 #

1. 获取图片数据转 Uint8List

// 通过文件路径获取图片
static Future<Uint8List> getImage(String imgPath) async {
final imgFile = File(imgPath);
final exist = await imgFile.exists();
if(exist) {
return imgFile.readAsBytes();
} else {
throw Exception('print imgFile is not exist');
}
}

2. Unit8List 转 esc 字节数组

import 'package:image/image.dart' as img;

// unit8List 转 esc 字节数组
static Future<List<int>> decodeBytes(Uint8List imgData) async {
final img.Image image = await cropImage(
imgData,
);
Generator generator = Generator();
List<int> bytes = [];
// 打印机状态重置
bytes += generator.reset();
// 打印光栅位图
bytes += generator.imageRaster(image);
// 走纸 2mm
bytes += generator.feed(2);
// 切刀
bytes += generator.cut();
return bytes;
}

注意事项 #

  1. 通常不会把一整张图片直接发给打印机,那样太大。都会分割成小图片逐个发送。 比如数据太大导致打印机内存溢出输出乱码。

  2. 小票机,目前常用尺寸为 80mm、58mm。通常 1mm 等于 8个像素,因此,适合小票打印机打印的图片像素尺寸应为:558px、372px。(因为宽度适配在实际打印中有偏差,不宜设置为完全吻合)

  3. 打印的图片宽度像素太大会造成打印无反应。

长图切割为多张小图示例 #

static Future<List<img.Image>> decodeImage(
    Uint8List imgData, {
    int imgSizeLimit = 550 * 1000,
  }) async {
    final img.Image crop = await cropImage(imgData);
    final cropWidth = crop.width;
    img.Image targetImg = crop;
    // 缩放处理,保持图片宽度能被8整除
    if (cropWidth % 8 != 0) {
      targetImg = await resizeImage(
        crop,
        targetWidth: cropWidth ~/ 8 * 8,
        targetHeight: crop.height,
      );
    }
    final targetWidth = targetImg.width;
    final targetHeight = targetImg.height;
    final result = <img.Image>[];
    if (targetWidth * targetHeight > imgSizeLimit) {
      LogTool.log('esc 长图开启切割');
      int splitItemHeight = imgSizeLimit ~/ targetWidth;

      int splitCount = targetHeight ~/ splitItemHeight;

      int lastItemHeight = targetHeight % splitItemHeight;

      for (int index = 0; index < splitCount; index++) {
        final splitItem = img.copyCrop(
          targetImg,
          0,
          splitItemHeight * index,
          targetWidth,
          splitItemHeight,
        );
        result.add(splitItem);
      }
      LogTool.log(
          '切图 * $splitCount 份 width($targetWidth) height($splitItemHeight)');

      if (lastItemHeight > 0) {
        final lastItem = img.copyCrop(
          crop,
          0,
          splitItemHeight * splitCount,
          targetWidth,
          lastItemHeight,
        );
        result.add(lastItem);
        LogTool.log('切图 * 1 份 width($targetWidth) height($lastItemHeight)');
      }
    } else {
      result.add(crop);
      LogTool.log('esc 无需切割 width($targetWidth) height($targetHeight)');
    }
    return result;
  }
1
likes
100
pub points
54%
popularity

Publisher

unverified uploader

小票打印机 *ESC* 数据转换工具,主要用于将 image 图像转换成小票打印机可识别的字节数组

Repository (GitHub)
View/report issues

Documentation

API reference

License

BSD-3-Clause (LICENSE)

Dependencies

flutter, gbk_codec, hex, image

More

Packages that depend on esc_utils