Flutter图片水印插件watermark_unique的使用

watermark_unique 是一个用于在图片上添加文本和图像水印的Flutter插件。你可以自定义水印的位置、颜色、背景颜色和填充等属性。

插件功能

• 向图片中添加文本
• 向图片中添加水印
• 通过File或Uint8List获取结果

可修改的参数

• 文本内容
• X轴位置
• Y轴位置
• 文字大小
• 文字颜色（带有透明度）
• 背景文字颜色（可选/带有透明度）
• 如果存在背景，则为文本设置内边距（可选）
• 图片质量
• 图像格式（用于压缩）

使用方法

添加文本水印示例（仅适用于iOS或Android）

import 'package:watermark_unique/watermark_unique.dart';

final image = await watermarkPlugin.addTextWatermark(
  filePath: photo!.path, // 图片文件路径
  text: 'Test watermark text', // 水印文本
  x: 500, // X轴位置
  y: 400, // Y轴位置
  textSize: 250, // 文字大小
  color: Colors.purpleAccent, // 文字颜色
  isNeedRotateToPortrait: true, // 将图片旋转为纵向（默认：false）仅限Android
  backgroundTextColor: Colors.black.withOpacity(0.5), // 背景文字颜色（可选）
  quality: 100, // 带有水印的图片质量
  backgroundTextPaddingLeft: 12, // 背景文本左边距（可选）
  backgroundTextPaddingTop: 12, // 背景文本顶边距（可选）
  backgroundTextPaddingRight: 12, // 背景文本右边距（可选）
  backgroundTextPaddingBottom: 12, // 背景文本底边距（可选）
  imageFormat: ImageFormat.jpeg, // 用于压缩的图像格式
);

添加图像水印示例（仅适用于iOS或Android）

final image = await watermarkPlugin.addImageWatermark(
  filePath: photo!.path, // 图片文件路径
  watermarkImagePath: watermark!.path, // 水印图片文件路径
  x: 500, // X轴位置
  y: 400, // Y轴位置
  quality: 100, // 带有水印的图片质量
  imageFormat: ImageFormat.jpeg, // 用于压缩的图像格式
  watermarkWidth: 300, // 水印图片宽度
  watermarkHeight: 300,  // 水印图片高度
);

添加文本水印并以Uint8List形式获取结果（支持iOS、Android和Web）

final image = await watermarkPlugin.addTextWatermarkUint8List(
  filePath: photo!.path, // 图片文件路径
  text: 'Test watermark text', // 水印文本
  x: 500, // X轴位置
  y: 400, // Y轴位置
  textSize: 250, // 文字大小
  color: Colors.purpleAccent, // 文字颜色
  isNeedRotateToPortrait: true, // 将图片旋转为纵向（默认：false）仅限Android
  backgroundTextColor: Colors.black, // 背景文字颜色（可选）
  backgroundTextPaddingLeft: 12, // 背景文本左边距（可选）
  backgroundTextPaddingTop: 12, // 背景文本顶边距（可选）
  backgroundTextPaddingRight: 12, // 背景文本右边距（可选）
  backgroundTextPaddingBottom: 12, // 背景文本底边距（可选）
);

添加图像水印并以Uint8List形式获取结果（支持iOS、Android和Web）

final image = await watermarkPlugin.addImageWatermarkUint8List(
  filePath: photo!.path, // 图片文件路径
  watermarkImagePath: watermark!.path, // 水印图片文件路径
  x: 500, // X轴位置
  y: 400, // Y轴位置
  watermarkWidth: 300, // 水印图片宽度
  watermarkHeight: 300,  // 水印图片高度
);

示例截图

完整的示例Demo

下面是一个完整的Flutter应用示例，展示了如何使用watermark_unique插件：

import 'package:flutter/material.dart';
import 'package:image_picker/image_picker.dart';
import 'package:watermark_unique/watermark_unique.dart';

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Center(child: Text('Watermark Example')),
        ),
        body: const WatermarkExample(),
      ),
    );
  }
}

class WatermarkExample extends StatefulWidget {
  const WatermarkExample({Key? key}) : super(key: key);

  @override
  _WatermarkExampleState createState() => _WatermarkExampleState();
}

class _WatermarkExampleState extends State<WatermarkExample> {
  final ImagePicker _picker = ImagePicker();
  XFile? _image;
  XFile? _watermark;

  Future<void> _pickImage() async {
    final pickedFile = await _picker.pickImage(source: ImageSource.gallery);
    if (pickedFile != null) {
      setState(() {
        _image = pickedFile;
      });
    }
  }

  Future<void> _pickWatermark() async {
    final pickedFile = await _picker.pickImage(source: ImageSource.gallery);
    if (pickedFile != null) {
      setState(() {
        _watermark = pickedFile;
      });
    }
  }

  Future<void> _addTextWatermark() async {
    if (_image == null) return;

    final result = await watermarkPlugin.addTextWatermark(
      filePath: _image!.path,
      text: 'Hello Watermark',
      x: 100,
      y: 100,
      textSize: 50,
      color: Colors.red,
      quality: 100,
      imageFormat: ImageFormat.jpeg,
    );

    // Handle the result as needed.
  }

  Future<void> _addImageWatermark() async {
    if (_image == null || _watermark == null) return;

    final result = await watermarkPlugin.addImageWatermark(
      filePath: _image!.path,
      watermarkImagePath: _watermark!.path,
      x: 100,
      y: 100,
      quality: 100,
      imageFormat: ImageFormat.jpeg,
      watermarkWidth: 100,
      watermarkHeight: 100,
    );

    // Handle the result as needed.
  }

  @override
  Widget build(BuildContext context) {
    return Padding(
      padding: const EdgeInsets.all(8.0),
      child: Column(
        children: [
          ElevatedButton(
            onPressed: _pickImage,
            child: Text('Pick an Image'),
          ),
          SizedBox(height: 20),
          ElevatedButton(
            onPressed: _pickWatermark,
            child: Text('Pick a Watermark Image'),
          ),
          SizedBox(height: 20),
          ElevatedButton(
            onPressed: _addTextWatermark,
            child: Text('Add Text Watermark'),
          ),
          SizedBox(height: 20),
          ElevatedButton(
            onPressed: _addImageWatermark,
            child: Text('Add Image Watermark'),
          ),
          if (_image != null) ...[
            SizedBox(height: 20),
            Image.file(File(_image!.path)),
          ],
        ],
      ),
    );
  }
}

以上代码展示了如何从相册中选择图片，并添加文本和图像水印的基本用法。根据需要调整参数可以实现不同的效果。