ImageCombiner图片合成工具 v2.4.1

ImageCombiner：轻量级图片合成工具

Downcodes小编今天给大家介绍一个简单实用的图片合成工具——ImageCombiner。它没有复杂的功能，专注于图片拼合，提供简洁的接口，只需几行代码即可实现图片合并（当然也可以用来合成水印）。

功能特性

ImageCombiner支持图片和文本两种素材，并提供了丰富的特性，足以满足日常的图片合成需求：

1. 素材类型：

图片

文本

2. 素材操作：

定位

缩放

旋转

圆角

透明度

颜色

字体

字号

删除线

居中绘制

文本自动换行

使用方法

ImageCombiner 使用起来非常简单，主要类只有一个，只需要创建一个 ImageCombiner 对象，指定背景图片和输出格式，然后添加各种素材元素，并设置元素的位置、大小和效果（例如圆角、颜色、透明度等），最后调用 combine() 方法即可。

代码示例：

`java

// 创建 ImageCombiner 对象，指定背景图片和输出格式

ImageCombiner combiner = new ImageCombiner("background.jpg", ImageFormat.JPEG);

// 添加图片素材

combiner.addImage("logo.png", 10, 10, 100, 100);

// 添加文本素材

combiner.addText("Hello World!", 200, 200, Color.RED, new Font("Arial", Font.BOLD, 24));

// 合成图片

BufferedImage combinedImage = combiner.combine();

// 保存图片到本地

ImageIO.write(combinedImage, "jpg", new File("output.jpg"));

`

特点

轻量级： 项目不依赖任何框架，完全基于 JDK 本身编写，没有多余的功能，性能出色。

简单易用： 简洁的接口，几行代码即可实现图片合成。

功能丰富： 支持多种素材类型和操作，满足日常图片合成需求。

安装

注意： 如果合成图片包含文字，开发机和服务器需要先安装相应的字体，否则无法显示文字。ImageCombiner 默认使用的字体是“阿里巴巴普惠体”（位于 font 目录）。

安装字体:

1. 将 font 目录下的字体文件复制到系统字体目录（不同操作系统目录位置可能不同）。

2. 运行测试项目中的 showFonts() 方法，打印系统可用字体列表，确认已安装的字体是否生效。

依赖:

ImageCombiner 依赖于 Java ImageIO 库。

使用方法:

1. 下载 ImageCombiner 项目代码。

2. 将项目添加到您的工程中。

3. 编写代码，调用 ImageCombiner 类实现图片合成功能。

示例代码

最简单的例子:

`java

import com.freewayso.imagecombiner.ImageCombiner;

import javax.imageio.ImageIO;

import java.awt.image.BufferedImage;

import java.io.File;

import java.io.IOException;

public class Main {

public static void main(String[] args) throws IOException {

// 创建 ImageCombiner 对象，指定背景图片和输出格式

ImageCombiner combiner = new ImageCombiner("background.jpg", ImageIO.read(new File("background.jpg")).getType());

// 添加图片素材

combiner.addImage("logo.png", 10, 10, 100, 100);

// 合成图片

BufferedImage combinedImage = combiner.combine();

// 保存图片到本地

ImageIO.write(combinedImage, "jpg", new File("output.jpg"));

}

}

`

完整示例:

`java

import com.freewayso.imagecombiner.ImageCombiner;

import com.freewayso.imagecombiner.ImageCombiner.ImageFormat;

import javax.imageio.ImageIO;

import java.awt.*;

import java.awt.image.BufferedImage;

import java.io.File;

import java.io.IOException;

public class Main {

public static void main(String[] args) throws IOException {

// 创建 ImageCombiner 对象，指定背景图片和输出格式

ImageCombiner combiner = new ImageCombiner("background.jpg", ImageFormat.JPEG);

// 添加图片素材

combiner.addImage("logo.png", 10, 10, 100, 100)

.setRoundedCorners(20); // 设置圆角

// 添加文本素材

combiner.addText("Hello World!", 200, 200, Color.RED, new Font("Arial", Font.BOLD, 24))

.setTransparency(0.5f) // 设置透明度

.setAlign(ImageCombiner.TextAlign.CENTER); // 设置居中对齐

// 合成图片

BufferedImage combinedImage = combiner.combine();

// 保存图片到本地

ImageIO.write(combinedImage, "jpg", new File("output.jpg"));

}

}

`

总结

ImageCombiner 是一个轻量级、简单易用、功能丰富的图片合成工具，可以帮助您快速实现图片拼合和水印合成等功能。

项目地址: https://github.com/freewayso/image-combiner

许可证: Apache-2.0 license