Flutter工具类插件esc_utils的使用

Flutter工具类插件esc_utils的使用

esc_utils 是一个用于将图像数据转换为小票打印机可识别的字节数组的工具。该工具使用 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. Uint8List 转 ESC 字节数组

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

// Uint8List 转 ESC 字节数组
static Future<List<int>> decodeBytes(Uint8List imgData) async {
  final img.Image image = await cropImage(imgData); // 假设 cropImage 是一个已定义的方法
  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); // 假设 cropImage 是一个已定义的方法
  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;
}