Flutter文档处理插件docu_ng的使用

Flutter文档处理插件DocuNG的使用

DocuNG 是一个 Flutter 包，提供了扫描、调整和管理文档图像的功能。该包支持捕获文档图像、调整其角点、增强对比度，并在不同平台上复制或共享图像。

特性

• 扫描文档：使用模态界面捕获文档图像。
• 调整文档角点：手动调整捕获文档的角点以获得更好的裁剪效果。
• 调整文档对比度：增强文档图像的对比度。
• 复制或分享图像：将图像复制到剪贴板或在不同平台上分享。

安装

在 pubspec.yaml 文件中添加以下依赖项：

dependencies:
  docu_ng: ^1.0.0

然后运行：

flutter pub get

使用

导入包

import 'package:docu_ng/docu_ng.dart';

扫描文档

scanDocument 函数会显示一个模态界面，允许用户捕获文档图像。

Uint8List? documentImage = await DocuNG().scanDocument();
if (documentImage != null) {
  // 使用捕获的文档图像
}

调整文档角点

adjustDocumentCorners 函数会显示一个模态界面，用于调整捕获文档的角点。它返回裁剪后的图像。

Uint8List? adjustedImage = await DocuNG().adjustDocumentCorners(documentImage);
if (adjustedImage != null) {
  // 使用调整后的文档图像
}

调整文档对比度

adjustDocumentContrast 函数调整文档图像的对比度并返回修改后的图像。

double contrast = 1.5; // 根据需要调整对比度值
Uint8List contrastAdjustedImage = await DocuNG().adjustDocumentContrast(documentImage, contrast);
// 使用对比度调整后的文档图像

复制图像到剪贴板

copyImageToClipboard 函数会将文档图像复制到剪贴板（在 Web 或 Windows 上）或分享它（在 Android 或 iOS 上）。

DocuNG().copyImageToClipboard(documentImage);

API 参考

Future<Uint8List?> scanDocument()

显示一个模态界面来捕获文档图像。

返回值：

• Uint8List?: 捕获的文档图像或 null 如果未捕获图像。

Future<Uint8List?> adjustDocumentCorners(Uint8List image)

显示一个模态界面来调整捕获文档图像的角点。

参数：

• Uint8List image: 捕获的文档图像。

返回值：

• Uint8List?: 调整后的文档图像或 null 如果调整未完成。

Future<Uint8List> adjustDocumentContrast(Uint8List image, double contrast)

调整文档图像的对比度。

参数：

• Uint8List image: 文档图像。
• double contrast: 应用的对比度值。

返回值：

• Uint8List: 对比度调整后的文档图像。

void copyImageToClipboard(Uint8List image)

将文档图像复制到剪贴板（在 Web 或 Windows 上）或分享它（在 Android 或 iOS 上）。

参数：

• Uint8List image: 需要复制或分享的文档图像。

示例

import 'package:flutter/material.dart';
import 'package:docu_ng/docu_ng.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

class HomeScreen extends StatefulWidget {
  [@override](/user/override)
  _HomeScreenState createState() => _HomeScreenState();
}

class _HomeScreenState extends State<HomeScreen> {
  Uint8List? _documentImage;

  Future<void> _scanDocument() async {
    Uint8List? documentImage = await DocuNG().scanDocument();
    setState(() {
      _documentImage = documentImage;
    });
  }

  Future<void> _adjustCorners() async {
    if (_documentImage != null) {
      Uint8List? adjustedImage = await DocuNG().adjustDocumentCorners(_documentImage!);
      setState(() {
        _documentImage = adjustedImage;
      });
    }
  }

  Future<void> _adjustContrast() async {
    if (_documentImage != null) {
      double contrast = 1.5;
      Uint8List contrastAdjustedImage = await DocuNG().adjustDocumentContrast(_documentImage!, contrast);
      setState(() {
        _documentImage = contrastAdjustedImage;
      });
    }
  }

  void _copyToClipboard() {
    if (_documentImage != null) {
      DocuNG().copyImageToClipboard(_documentImage!);
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('DocuNG 示例'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            if (_documentImage != null)
              Image.memory(_documentImage!),
            ElevatedButton(
              onPressed: _scanDocument,
              child: Text('扫描文档'),
            ),
            ElevatedButton(
              onPressed: _adjustCorners,
              child: Text('调整角点'),
            ),
            ElevatedButton(
              onPressed: _adjustContrast,
              child: Text('调整对比度'),
            ),
            ElevatedButton(
              onPressed: _copyToClipboard,
              child: Text('复制到剪贴板'),
            ),
          ],
        ),
      ),
    );
  }
}