Flutter图片合并插件merge_images的使用

中文文档

简介

在垂直或水平方向上合并图片（图像拼接）。

特性

• 支持垂直和水平方向。
• 提供一个帮助类来在代码中合并图片并获取结果图片，以及一个自动合并和显示图片的部件。
• 自动缩放图片以适应其他图片（垂直方向上适应宽度，在水平方向上适应高度）。

使用方法

ImagesMergeHelper

使用此帮助类在代码中合并图片。

ui.Image image = await ImagesMergeHelper.margeImages(
  [assetImage1, assetImage2, providerImage], /// 必须，图片列表
  fit: true, /// 缩放图片以适应其他图片
  direction: Axis.vertical, /// 图片的方向
  backgroundColor: Colors.black26, /// 背景颜色
);

此外，它还提供了一些函数来进行图片格式转换：

/// ui.Image 转 Uint8List
Uint8List bytes = await ImagesMergeHelper.imageToUint8List(image);

/// ui.Image 转 File
File file = await ImagesMergeHelper.imageToFile(image);

/// Uint8List 转 ui.Image
ui.Image image = await ImagesMergeHelper.uint8ListToImage(imageBytes);

/// file 转 ui.Image
ui.Image image = await ImagesMergeHelper.loadImageFromFile(file);

/// asset 转 ui.Image
ui.Image image = await ImagesMergeHelper.loadImageFromAsset(assetPath);

/// ImageProvider 转 ui.Image
ui.Image image = await ImagesMergeHelper.loadImageFromProvider(imageProvider);

ImageMerge

使用此部件自动合并和显示图片。

ImagesMerge(
  imageList, /// 必须，图片列表
  direction: Axis.vertical, /// 方向
  backgroundColor: Colors.black26, /// 背景颜色
  fit: false, /// 缩放图片以适应其他图片
  controller: captureController, /// 控制器用于获取屏幕截图
)

此外，该部件被包裹在 RepaintBoundary 中，您可以简单地传递一个 CaptureController 的实例，并通过调用 capture() 获取屏幕截图。

/// 通过 RepaintBoundary 获取部件的捕获
getCapture() async {
  Uint8List bytes = await captureController.capture();
}

许可证

MIT 许可证

以下是完整的示例代码：

import 'package:example/helper_page.dart';
import 'package:example/widget_page.dart';
import 'package:flutter/material.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(title: 'Example Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  MyHomePage({Key key, this.title}) : super(key: key);

  final String title;

  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            RaisedButton(
                onPressed: _toWidget,
                child: Text(
                  "ImagesMerge Widget",
                  style: Theme.of(context).textTheme.title,
                )),
            SizedBox(
              height: 30,
            ),
            RaisedButton(
                onPressed: _toHelper,
                child: Text(
                  "ImagesMerge Helper",
                  style: Theme.of(context).textTheme.title,
                )),
          ],
        ),
      ),
    );
  }

  _toWidget() {
    Navigator.push(context,
        MaterialPageRoute(builder: (context) => ImagesMergeWidgetPage()));
  }

  _toHelper() {
    Navigator.push(context,
        MaterialPageRoute(builder: (context) => ImagesMergeHelperPage()));
  }
}