ImgUtil工具类，图片各种处理方式集合Java工具类
温馨提示：
本文最后更新于 2022年08月30日，已超过 604 天没有更新。若文章内的图片失效（无法正常加载），请留言反馈或直接联系我。
引入maven依赖
<dependency> <groupId>cn.hutool</groupId> <artifactId>hutool-all</artifactId> <version>5.4.3</version> </dependency> 图片集合处理工具类
import java.awt.Color;
import java.awt.Font;
import java.awt.Graphics;
import java.awt.Graphics2D;
import java.awt.Image;
import java.awt.Point;
import java.awt.Rectangle;
import java.awt.font.FontRenderContext;
import java.awt.geom.AffineTransform;
import java.awt.geom.Rectangle2D;
import java.awt.image.BufferedImage;
import java.awt.image.ColorModel;
import java.awt.image.RenderedImage;
import java.io.ByteArrayInputStream;
import java.io.ByteArrayOutputStream;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.net.URL;
import java.util.Iterator;
import java.util.List;
import java.util.Random;
import javax.imageio.IIOImage;
import javax.imageio.ImageIO;
import javax.imageio.ImageReader;
import javax.imageio.ImageTypeSpecifier;
import javax.imageio.ImageWriteParam;
import javax.imageio.ImageWriter;
import javax.imageio.stream.ImageInputStream;
import javax.imageio.stream.ImageOutputStream;
/**
* @author 王小东
* @version 1.0
*/
import cn.hutool.core.codec.Base64;
import cn.hutool.core.convert.Convert;
import cn.hutool.core.img.BackgroundRemoval;
import cn.hutool.core.img.FontUtil;
import cn.hutool.core.img.GraphicsUtil;
import cn.hutool.core.img.Img;
import cn.hutool.core.io.FileUtil;
import cn.hutool.core.io.IORuntimeException;
import cn.hutool.core.io.IoUtil;
import cn.hutool.core.io.resource.Resource;
import cn.hutool.core.lang.Assert;
import cn.hutool.core.util.ArrayUtil;
import cn.hutool.core.util.NumberUtil;
import cn.hutool.core.util.ObjectUtil;
import cn.hutool.core.util.RandomUtil;
import cn.hutool.core.util.StrUtil;
import cn.hutool.core.util.URLUtil;
/**
* 图片处理工具类：
* 功能：缩放图像、切割图像、旋转、图像类型转换、彩色转黑白、文字水印、图片水印等
* @author 王小东
*/
public class ImgUtils {
public static final String IMAGE_TYPE_GIF = "gif";// 图形交换格式
public static final String IMAGE_TYPE_JPG = "jpg";// 联合照片专家组
public static final String IMAGE_TYPE_JPEG = "jpeg";// 联合照片专家组
public static final String IMAGE_TYPE_BMP = "bmp";// 英文Bitmap（位图）的简写，它是Windows操作系统中的标准图像文件格式
public static final String IMAGE_TYPE_PNG = "png";// 可移植网络图形
public static final String IMAGE_TYPE_PSD = "psd";// Photoshop的专用格式Photoshop
/**
* RGB颜色范围上限
*/
private static final int RGB_COLOR_BOUND = 256;
// ---------------------------------------------------------------------------------------------------------------------- scale
/**
* 缩放图像（按比例缩放），目标文件的扩展名决定目标文件类型
*
* @param srcImageFile 源图像文件
* @param destImageFile 缩放后的图像文件，扩展名决定目标类型
* @param scale 缩放比例。比例大于1时为放大，小于1大于0为缩小
*/
public static void scale(File srcImageFile, File destImageFile, float scale) {
scale(read(srcImageFile), destImageFile, scale);
}
/**
* 缩放图像（按比例缩放）
* 缩放后默认为jpeg格式，此方法并不关闭流
*
* @param srcStream 源图像来源流
* @param destStream 缩放后的图像写出到的流
* @param scale 缩放比例。比例大于1时为放大，小于1大于0为缩小
* @since 3.0.9
*/
public static void scale(InputStream srcStream, OutputStream destStream, float scale) {
scale(read(srcStream), destStream, scale);
}
/**
* 缩放图像（按比例缩放）
* 缩放后默认为jpeg格式，此方法并不关闭流
*
* @param srcStream 源图像来源流
* @param destStream 缩放后的图像写出到的流
* @param scale 缩放比例。比例大于1时为放大，小于1大于0为缩小
* @since 3.1.0
*/
public static void scale(ImageInputStream srcStream, ImageOutputStream destStream, float scale) {
scale(read(srcStream), destStream, scale);
}
/**
* 缩放图像（按比例缩放）
* 缩放后默认为jpeg格式，此方法并不关闭流
*
* @param srcImg 源图像来源流
* @param destFile 缩放后的图像写出到的流
* @param scale 缩放比例。比例大于1时为放大，小于1大于0为缩小
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
public static void scale(Image srcImg, File destFile, float scale) throws IORuntimeException {
Img.from(srcImg).setTargetImageType(FileUtil.extName(destFile)).scale(scale).write(destFile);
}
/**
* 缩放图像（按比例缩放）
* 缩放后默认为jpeg格式，此方法并不关闭流
*
* @param srcImg 源图像来源流
* @param out 缩放后的图像写出到的流
* @param scale 缩放比例。比例大于1时为放大，小于1大于0为缩小
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
public static void scale(Image srcImg, OutputStream out, float scale) throws IORuntimeException {
scale(srcImg, getImageOutputStream(out), scale);
}
/**
* 缩放图像（按比例缩放）
* 缩放后默认为jpeg格式，此方法并不关闭流
*
* @param srcImg 源图像来源流
* @param destImageStream 缩放后的图像写出到的流
* @param scale 缩放比例。比例大于1时为放大，小于1大于0为缩小
* @throws IORuntimeException IO异常
* @since 3.1.0
*/
public static void scale(Image srcImg, ImageOutputStream destImageStream, float scale) throws IORuntimeException {
writeJpg(scale(srcImg, scale), destImageStream);
}
/**
* 缩放图像（按比例缩放）
*
* @param srcImg 源图像来源流
* @param scale 缩放比例。比例大于1时为放大，小于1大于0为缩小
* @return {@link Image}
* @since 3.1.0
*/
public static Image scale(Image srcImg, float scale) {
return Img.from(srcImg).scale(scale).getImg();
}
/**
* 缩放图像（按长宽缩放）
* 注意：目标长宽与原图不成比例会变形
*
* @param srcImg 源图像来源流
* @param width 目标宽度
* @param height 目标高度
* @return {@link Image}
* @since 3.1.0
*/
public static Image scale(Image srcImg, int width, int height) {
return Img.from(srcImg).scale(width, height).getImg();
}
/**
* 缩放图像（按高度和宽度缩放）
* 缩放后默认格式与源图片相同，无法识别原图片默认JPG
*
* @param srcImageFile 源图像文件地址
* @param destImageFile 缩放后的图像地址
* @param width 缩放后的宽度
* @param height 缩放后的高度
* @param fixedColor 补充的颜色，不补充为<code>null</code>
* @throws IORuntimeException IO异常
*/
public static void scale(File srcImageFile, File destImageFile, int width, int height, Color fixedColor) throws IORuntimeException {
Img.from(srcImageFile)//
.setTargetImageType(FileUtil.extName(destImageFile))//
.scale(width, height, fixedColor)//
.write(destImageFile);
}
/**
* 缩放图像（按高度和宽度缩放）
* 缩放后默认为jpeg格式，此方法并不关闭流
*
* @param srcStream 源图像流
* @param destStream 缩放后的图像目标流
* @param width 缩放后的宽度
* @param height 缩放后的高度
* @param fixedColor 比例不对时补充的颜色，不补充为<code>null</code>
* @throws IORuntimeException IO异常
*/
public static void scale(InputStream srcStream, OutputStream destStream, int width, int height, Color fixedColor) throws IORuntimeException {
scale(read(srcStream), getImageOutputStream(destStream), width, height, fixedColor);
}
/**
* 缩放图像（按高度和宽度缩放）
* 缩放后默认为jpeg格式，此方法并不关闭流
*
* @param srcStream 源图像流
* @param destStream 缩放后的图像目标流
* @param width 缩放后的宽度
* @param height 缩放后的高度
* @param fixedColor 比例不对时补充的颜色，不补充为<code>null</code>
* @throws IORuntimeException IO异常
*/
public static void scale(ImageInputStream srcStream, ImageOutputStream destStream, int width, int height, Color fixedColor) throws IORuntimeException {
scale(read(srcStream), destStream, width, height, fixedColor);
}
/**
* 缩放图像（按高度和宽度缩放）
* 缩放后默认为jpeg格式，此方法并不关闭流
*
* @param srcImage 源图像
* @param destImageStream 缩放后的图像目标流
* @param width 缩放后的宽度
* @param height 缩放后的高度
* @param fixedColor 比例不对时补充的颜色，不补充为<code>null</code>
* @throws IORuntimeException IO异常
*/
public static void scale(Image srcImage, ImageOutputStream destImageStream, int width, int height, Color fixedColor) throws IORuntimeException {
writeJpg(scale(srcImage, width, height, fixedColor), destImageStream);
}
/**
* 缩放图像（按高度和宽度缩放）
* 缩放后默认为jpeg格式
*
* @param srcImage 源图像
* @param width 缩放后的宽度
* @param height 缩放后的高度
* @param fixedColor 比例不对时补充的颜色，不补充为<code>null</code>
* @return {@link Image}
*/
public static Image scale(Image srcImage, int width, int height, Color fixedColor) {
return Img.from(srcImage).scale(width, height, fixedColor).getImg();
}
// ---------------------------------------------------------------------------------------------------------------------- cut
/**
* 图像切割(按指定起点坐标和宽高切割)
*
* @param srcImgFile 源图像文件
* @param destImgFile 切片后的图像文件
* @param rectangle 矩形对象，表示矩形区域的x，y，width，height
* @since 3.1.0
*/
public static void cut(File srcImgFile, File destImgFile, Rectangle rectangle) {
cut(read(srcImgFile), destImgFile, rectangle);
}
/**
* 图像切割(按指定起点坐标和宽高切割)，此方法并不关闭流
*
* @param srcStream 源图像流
* @param destStream 切片后的图像输出流
* @param rectangle 矩形对象，表示矩形区域的x，y，width，height
* @since 3.1.0
*/
public static void cut(InputStream srcStream, OutputStream destStream, Rectangle rectangle) {
cut(read(srcStream), destStream, rectangle);
}
/**
* 图像切割(按指定起点坐标和宽高切割)，此方法并不关闭流
*
* @param srcStream 源图像流
* @param destStream 切片后的图像输出流
* @param rectangle 矩形对象，表示矩形区域的x，y，width，height
* @since 3.1.0
*/
public static void cut(ImageInputStream srcStream, ImageOutputStream destStream, Rectangle rectangle) {
cut(read(srcStream), destStream, rectangle);
}
/**
* 图像切割(按指定起点坐标和宽高切割)，此方法并不关闭流
*
* @param srcImage 源图像
* @param destFile 输出的文件
* @param rectangle 矩形对象，表示矩形区域的x，y，width，height
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
public static void cut(Image srcImage, File destFile, Rectangle rectangle) throws IORuntimeException {
write(cut(srcImage, rectangle), destFile);
}
/**
* 图像切割(按指定起点坐标和宽高切割)，此方法并不关闭流
*
* @param srcImage 源图像
* @param out 切片后的图像输出流
* @param rectangle 矩形对象，表示矩形区域的x，y，width，height
* @throws IORuntimeException IO异常
* @since 3.1.0
*/
public static void cut(Image srcImage, OutputStream out, Rectangle rectangle) throws IORuntimeException {
cut(srcImage, getImageOutputStream(out), rectangle);
}
/**
* 图像切割(按指定起点坐标和宽高切割)，此方法并不关闭流
*
* @param srcImage 源图像
* @param destImageStream 切片后的图像输出流
* @param rectangle 矩形对象，表示矩形区域的x，y，width，height
* @throws IORuntimeException IO异常
* @since 3.1.0
*/
public static void cut(Image srcImage, ImageOutputStream destImageStream, Rectangle rectangle) throws IORuntimeException {
writeJpg(cut(srcImage, rectangle), destImageStream);
}
/**
* 图像切割(按指定起点坐标和宽高切割)
*
* @param srcImage 源图像
* @param rectangle 矩形对象，表示矩形区域的x，y，width，height
* @return {@link BufferedImage}
* @since 3.1.0
*/
public static Image cut(Image srcImage, Rectangle rectangle) {
return Img.from(srcImage).setPositionBaseCentre(false).cut(rectangle).getImg();
}
/**
* 图像切割(按指定起点坐标和宽高切割)，填充满整个图片（直径取长宽最小值）
*
* @param srcImage 源图像
* @param x 原图的x坐标起始位置
* @param y 原图的y坐标起始位置
* @return {@link Image}
* @since 4.1.15
*/
public static Image cut(Image srcImage, int x, int y) {
return cut(srcImage, x, y, -1);
}
/**
* 图像切割(按指定起点坐标和宽高切割)
*
* @param srcImage 源图像
* @param x 原图的x坐标起始位置
* @param y 原图的y坐标起始位置
* @param radius 半径，小于0表示填充满整个图片（直径取长宽最小值）
* @return {@link Image}
* @since 4.1.15
*/
public static Image cut(Image srcImage, int x, int y, int radius) {
return Img.from(srcImage).cut(x, y, radius).getImg();
}
/**
* 图像切片（指定切片的宽度和高度）
*
* @param srcImageFile 源图像
* @param descDir 切片目标文件夹
* @param destWidth 目标切片宽度。默认200
* @param destHeight 目标切片高度。默认150
*/
public static void slice(File srcImageFile, File descDir, int destWidth, int destHeight) {
slice(read(srcImageFile), descDir, destWidth, destHeight);
}
/**
* 图像切片（指定切片的宽度和高度）
*
* @param srcImage 源图像
* @param descDir 切片目标文件夹
* @param destWidth 目标切片宽度。默认200
* @param destHeight 目标切片高度。默认150
*/
public static void slice(Image srcImage, File descDir, int destWidth, int destHeight) {
if (destWidth <= 0) {
destWidth = 200; // 切片宽度
}
if (destHeight <= 0) {
destHeight = 150; // 切片高度
}
int srcWidth = srcImage.getWidth(null); // 源图宽度
int srcHeight = srcImage.getHeight(null); // 源图高度
if(srcWidth < destWidth){
destWidth = srcWidth;
}
if(srcHeight < destHeight){
destHeight = srcHeight;
}
int cols; // 切片横向数量
int rows; // 切片纵向数量
// 计算切片的横向和纵向数量
if (srcWidth % destWidth == 0) {
cols = srcWidth / destWidth;
} else {
cols = (int) Math.floor((double) srcWidth / destWidth) + 1;
}
if (srcHeight % destHeight == 0) {
rows = srcHeight / destHeight;
} else {
rows = (int) Math.floor((double) srcHeight / destHeight) + 1;
}
// 循环建立切片
Image tag;
for (int i = 0; i < rows; i++) {
for (int j = 0; j < cols; j++) {
// 四个参数分别为图像起点坐标和宽高
// 即: CropImageFilter(int x,int y,int width,int height)
tag = cut(srcImage, new Rectangle(j * destWidth, i * destHeight, destWidth, destHeight));
// 输出为文件
write(tag, FileUtil.file(descDir, "_r" + i + "_c" + j + ".jpg"));
}
}
}
/**
* 图像切割（指定切片的行数和列数）
*
* @param srcImageFile 源图像文件
* @param destDir 切片目标文件夹
* @param rows 目标切片行数。默认2，必须是范围 [1, 20] 之内
* @param cols 目标切片列数。默认2，必须是范围 [1, 20] 之内
*/
public static void sliceByRowsAndCols(File srcImageFile, File destDir, int rows, int cols) {
try {
sliceByRowsAndCols(ImageIO.read(srcImageFile), destDir, rows, cols);
} catch (IOException e) {
throw new IORuntimeException(e);
}
}
/**
* 图像切割（指定切片的行数和列数）
*
* @param srcImage 源图像
* @param destDir 切片目标文件夹
* @param rows 目标切片行数。默认2，必须是范围 [1, 20] 之内
* @param cols 目标切片列数。默认2，必须是范围 [1, 20] 之内
*/
public static void sliceByRowsAndCols(Image srcImage, File destDir, int rows, int cols) {
if (false == destDir.exists()) {
FileUtil.mkdir(destDir);
} else if (false == destDir.isDirectory()) {
throw new IllegalArgumentException("Destination Dir must be a Directory !");
}
try {
if (rows <= 0 || rows > 20) {
rows = 2; // 切片行数
}
if (cols <= 0 || cols > 20) {
cols = 2; // 切片列数
}
// 读取源图像
final BufferedImage bi = toBufferedImage(srcImage);
int srcWidth = bi.getWidth(); // 源图宽度
int srcHeight = bi.getHeight(); // 源图高度
int destWidth = NumberUtil.partValue(srcWidth, cols); // 每张切片的宽度
int destHeight = NumberUtil.partValue(srcHeight, rows); // 每张切片的高度
// 循环建立切片
Image tag;
for (int i = 0; i < rows; i++) {
for (int j = 0; j < cols; j++) {
tag = cut(bi, new Rectangle(j * destWidth, i * destHeight, destWidth, destHeight));
// 输出为文件
ImageIO.write(toRenderedImage(tag), IMAGE_TYPE_JPEG, new File(destDir, "_r" + i + "_c" + j + ".jpg"));
}
}
} catch (IOException e) {
throw new IORuntimeException(e);
}
}
// ---------------------------------------------------------------------------------------------------------------------- convert
/**
* 图像类型转换：GIF=》JPG、GIF=》PNG、PNG=》JPG、PNG=》GIF(X)、BMP=》PNG
*
* @param srcImageFile 源图像文件
* @param destImageFile 目标图像文件
*/
public static void convert(File srcImageFile, File destImageFile) {
Assert.notNull(srcImageFile);
Assert.notNull(destImageFile);
Assert.isFalse(srcImageFile.equals(destImageFile), "Src file is equals to dest file!");
final String srcExtName = FileUtil.extName(srcImageFile);
final String destExtName = FileUtil.extName(destImageFile);
if (StrUtil.equalsIgnoreCase(srcExtName, destExtName)) {
// 扩展名相同直接复制文件
FileUtil.copy(srcImageFile, destImageFile, true);
}
ImageOutputStream imageOutputStream = null;
try {
imageOutputStream = getImageOutputStream(destImageFile);
convert(read(srcImageFile), destExtName, imageOutputStream, StrUtil.equalsIgnoreCase(IMAGE_TYPE_PNG, srcExtName));
} finally {
IoUtil.close(imageOutputStream);
}
}
/**
* 图像类型转换：GIF=》JPG、GIF=》PNG、PNG=》JPG、PNG=》GIF(X)、BMP=》PNG<br/>
* 此方法并不关闭流
*
* @param srcStream 源图像流
* @param formatName 包含格式非正式名称的 String：如JPG、JPEG、GIF等
* @param destStream 目标图像输出流
* @since 3.0.9
*/
public static void convert(InputStream srcStream, String formatName, OutputStream destStream) {
write(read(srcStream), formatName, getImageOutputStream(destStream));
}
/**
* 图像类型转换：GIF=》JPG、GIF=》PNG、PNG=》JPG、PNG=》GIF(X)、BMP=》PNG<br/>
* 此方法并不关闭流
*
* @param srcImage 源图像流
* @param formatName 包含格式非正式名称的 String：如JPG、JPEG、GIF等
* @param destImageStream 目标图像输出流
* @param isSrcPng 源图片是否为PNG格式
* @since 4.1.14
*/
public static void convert(Image srcImage, String formatName, ImageOutputStream destImageStream, boolean isSrcPng) {
try {
ImageIO.write(isSrcPng ? copyImage(srcImage, BufferedImage.TYPE_INT_RGB) : toBufferedImage(srcImage), formatName, destImageStream);
} catch (IOException e) {
throw new IORuntimeException(e);
}
}
// ---------------------------------------------------------------------------------------------------------------------- grey
/**
* 彩色转为黑白
*
* @param srcImageFile 源图像地址
* @param destImageFile 目标图像地址
*/
public static void gray(File srcImageFile, File destImageFile) {
gray(read(srcImageFile), destImageFile);
}
/**
* 彩色转为黑白<br/>
* 此方法并不关闭流
*
* @param srcStream 源图像流
* @param destStream 目标图像流
* @since 3.0.9
*/
public static void gray(InputStream srcStream, OutputStream destStream) {
gray(read(srcStream), getImageOutputStream(destStream));
}
/**
* 彩色转为黑白<br/>
* 此方法并不关闭流
*
* @param srcStream 源图像流
* @param destStream 目标图像流
* @since 3.0.9
*/
public static void gray(ImageInputStream srcStream, ImageOutputStream destStream) {
gray(read(srcStream), destStream);
}
/**
* 彩色转为黑白
*
* @param srcImage 源图像流
* @param outFile 目标文件
* @since 3.2.2
*/
public static void gray(Image srcImage, File outFile) {
write(gray(srcImage), outFile);
}
/**
* 彩色转为黑白<br/>
* 此方法并不关闭流
*
* @param srcImage 源图像流
* @param out 目标图像流
* @since 3.2.2
*/
public static void gray(Image srcImage, OutputStream out) {
gray(srcImage, getImageOutputStream(out));
}
/**
* 彩色转为黑白<br/>
* 此方法并不关闭流
*
* @param srcImage 源图像流
* @param destImageStream 目标图像流
* @throws IORuntimeException IO异常
* @since 3.0.9
*/
public static void gray(Image srcImage, ImageOutputStream destImageStream) throws IORuntimeException {
writeJpg(gray(srcImage), destImageStream);
}
/**
* 彩色转为黑白
*
* @param srcImage 源图像流
* @return {@link Image}灰度后的图片
* @since 3.1.0
*/
public static Image gray(Image srcImage) {
return Img.from(srcImage).gray().getImg();
}
// ---------------------------------------------------------------------------------------------------------------------- binary
/**
* 彩色转为黑白二值化图片，根据目标文件扩展名确定转换后的格式
*
* @param srcImageFile 源图像地址
* @param destImageFile 目标图像地址
*/
public static void binary(File srcImageFile, File destImageFile) {
binary(read(srcImageFile), destImageFile);
}
/**
* 彩色转为黑白二值化图片
* 此方法并不关闭流
*
* @param srcStream 源图像流
* @param destStream 目标图像流
* @param imageType 图片格式(扩展名)
* @since 4.0.5
*/
public static void binary(InputStream srcStream, OutputStream destStream, String imageType) {
binary(read(srcStream), getImageOutputStream(destStream), imageType);
}
/**
* 彩色转为黑白黑白二值化图片
* 此方法并不关闭流
*
* @param srcStream 源图像流
* @param destStream 目标图像流
* @param imageType 图片格式(扩展名)
* @since 4.0.5
*/
public static void binary(ImageInputStream srcStream, ImageOutputStream destStream, String imageType) {
binary(read(srcStream), destStream, imageType);
}
/**
* 彩色转为黑白二值化图片，根据目标文件扩展名确定转换后的格式
*
* @param srcImage 源图像流
* @param outFile 目标文件
* @since 4.0.5
*/
public static void binary(Image srcImage, File outFile) {
write(binary(srcImage), outFile);
}
/**
* 彩色转为黑白二值化图片
* 此方法并不关闭流，输出JPG格式
*
* @param srcImage 源图像流
* @param out 目标图像流
* @param imageType 图片格式(扩展名)
* @since 4.0.5
*/
public static void binary(Image srcImage, OutputStream out, String imageType) {
binary(srcImage, getImageOutputStream(out), imageType);
}
/**
* 彩色转为黑白二值化图片
* 此方法并不关闭流，输出JPG格式
*
* @param srcImage 源图像流
* @param destImageStream 目标图像流
* @param imageType 图片格式(扩展名)
* @throws IORuntimeException IO异常
* @since 4.0.5
*/
public static void binary(Image srcImage, ImageOutputStream destImageStream, String imageType) throws IORuntimeException {
write(binary(srcImage), imageType, destImageStream);
}
/**
* 彩色转为黑白二值化图片
*
* @param srcImage 源图像流
* @return {@link Image}二值化后的图片
* @since 4.0.5
*/
public static Image binary(Image srcImage) {
return Img.from(srcImage).binary().getImg();
}
// ---------------------------------------------------------------------------------------------------------------------- press
/**
* 给图片添加文字水印
*
* @param imageFile 源图像文件
* @param destFile 目标图像文件
* @param pressText 水印文字
* @param color 水印的字体颜色
* @param font {@link Font} 字体相关信息，如果默认则为{@code null}
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
* @param y 修正值。 默认在中间，偏移量相对于中间偏移
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
*/
public static void pressText(File imageFile, File destFile, String pressText, Color color, Font font, int x, int y, float alpha) {
pressText(read(imageFile), destFile, pressText, color, font, x, y, alpha);
}
/**
* 给图片添加文字水印
* 此方法并不关闭流
*
* @param srcStream 源图像流
* @param destStream 目标图像流
* @param pressText 水印文字
* @param color 水印的字体颜色
* @param font {@link Font} 字体相关信息，如果默认则为{@code null}
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
* @param y 修正值。 默认在中间，偏移量相对于中间偏移
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
*/
public static void pressText(InputStream srcStream, OutputStream destStream, String pressText, Color color, Font font, int x, int y, float alpha) {
pressText(read(srcStream), getImageOutputStream(destStream), pressText, color, font, x, y, alpha);
}
/**
* 给图片添加文字水印
* 此方法并不关闭流
*
* @param srcStream 源图像流
* @param destStream 目标图像流
* @param pressText 水印文字
* @param color 水印的字体颜色
* @param font {@link Font} 字体相关信息，如果默认则为{@code null}
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
* @param y 修正值。 默认在中间，偏移量相对于中间偏移
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
*/
public static void pressText(ImageInputStream srcStream, ImageOutputStream destStream, String pressText, Color color, Font font, int x, int y, float alpha) {
pressText(read(srcStream), destStream, pressText, color, font, x, y, alpha);
}
/**
* 给图片添加文字水印
* 此方法并不关闭流
*
* @param srcImage 源图像
* @param destFile 目标流
* @param pressText 水印文字
* @param color 水印的字体颜色
* @param font {@link Font} 字体相关信息，如果默认则为{@code null}
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
* @param y 修正值。 默认在中间，偏移量相对于中间偏移
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
public static void pressText(Image srcImage, File destFile, String pressText, Color color, Font font, int x, int y, float alpha) throws IORuntimeException {
write(pressText(srcImage, pressText, color, font, x, y, alpha), destFile);
}
/**
* 给图片添加文字水印
* 此方法并不关闭流
*
* @param srcImage 源图像
* @param to 目标流
* @param pressText 水印文字
* @param color 水印的字体颜色
* @param font {@link Font} 字体相关信息，如果默认则为{@code null}
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
* @param y 修正值。 默认在中间，偏移量相对于中间偏移
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
public static void pressText(Image srcImage, OutputStream to, String pressText, Color color, Font font, int x, int y, float alpha) throws IORuntimeException {
pressText(srcImage, getImageOutputStream(to), pressText, color, font, x, y, alpha);
}
/**
* 给图片添加文字水印
* 此方法并不关闭流
*
* @param srcImage 源图像
* @param destImageStream 目标图像流
* @param pressText 水印文字
* @param color 水印的字体颜色
* @param font {@link Font} 字体相关信息，如果默认则为{@code null}
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
* @param y 修正值。 默认在中间，偏移量相对于中间偏移
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
* @throws IORuntimeException IO异常
*/
public static void pressText(Image srcImage, ImageOutputStream destImageStream, String pressText, Color color, Font font, int x, int y, float alpha) throws IORuntimeException {
writeJpg(pressText(srcImage, pressText, color, font, x, y, alpha), destImageStream);
}
/**
* 给图片添加文字水印
* 此方法并不关闭流
*
* @param srcImage 源图像
* @param pressText 水印文字
* @param color 水印的字体颜色
* @param font {@link Font} 字体相关信息，如果默认则为{@code null}
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
* @param y 修正值。 默认在中间，偏移量相对于中间偏移
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
* @return 处理后的图像
* @since 3.2.2
*/
public static Image pressText(Image srcImage, String pressText, Color color, Font font, int x, int y, float alpha) {
return Img.from(srcImage).pressText(pressText, color, font, x, y, alpha).getImg();
}
/**
* 给图片添加图片水印
*
* @param srcImageFile 源图像文件
* @param destImageFile 目标图像文件
* @param pressImg 水印图片
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
* @param y 修正值。 默认在中间，偏移量相对于中间偏移
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
*/
public static void pressImage(File srcImageFile, File destImageFile, Image pressImg, int x, int y, float alpha) {
pressImage(read(srcImageFile), destImageFile, pressImg, x, y, alpha);
}
/**
* 给图片添加图片水印
* 此方法并不关闭流
*
* @param srcStream 源图像流
* @param destStream 目标图像流
* @param pressImg 水印图片，可以使用{@link ImageIO#read(File)}方法读取文件
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
* @param y 修正值。 默认在中间，偏移量相对于中间偏移
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
*/
public static void pressImage(InputStream srcStream, OutputStream destStream, Image pressImg, int x, int y, float alpha) {
pressImage(read(srcStream), getImageOutputStream(destStream), pressImg, x, y, alpha);
}
/**
* 给图片添加图片水印
* 此方法并不关闭流
*
* @param srcStream 源图像流
* @param destStream 目标图像流
* @param pressImg 水印图片，可以使用{@link ImageIO#read(File)}方法读取文件
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
* @param y 修正值。 默认在中间，偏移量相对于中间偏移
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
* @throws IORuntimeException IO异常
*/
public static void pressImage(ImageInputStream srcStream, ImageOutputStream destStream, Image pressImg, int x, int y, float alpha) throws IORuntimeException {
pressImage(read(srcStream), destStream, pressImg, x, y, alpha);
}
/**
* 给图片添加图片水印
* 此方法并不关闭流
*
* @param srcImage 源图像流
* @param outFile 写出文件
* @param pressImg 水印图片，可以使用{@link ImageIO#read(File)}方法读取文件
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
* @param y 修正值。 默认在中间，偏移量相对于中间偏移
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
public static void pressImage(Image srcImage, File outFile, Image pressImg, int x, int y, float alpha) throws IORuntimeException {
write(pressImage(srcImage, pressImg, x, y, alpha), outFile);
}
/**
* 给图片添加图片水印
* 此方法并不关闭流
*
* @param srcImage 源图像流
* @param out 目标图像流
* @param pressImg 水印图片，可以使用{@link ImageIO#read(File)}方法读取文件
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
* @param y 修正值。 默认在中间，偏移量相对于中间偏移
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
public static void pressImage(Image srcImage, OutputStream out, Image pressImg, int x, int y, float alpha) throws IORuntimeException {
pressImage(srcImage, getImageOutputStream(out), pressImg, x, y, alpha);
}
/**
* 给图片添加图片水印
* 此方法并不关闭流
*
* @param srcImage 源图像流
* @param destImageStream 目标图像流
* @param pressImg 水印图片，可以使用{@link ImageIO#read(File)}方法读取文件
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
* @param y 修正值。 默认在中间，偏移量相对于中间偏移
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
* @throws IORuntimeException IO异常
*/
public static void pressImage(Image srcImage, ImageOutputStream destImageStream, Image pressImg, int x, int y, float alpha) throws IORuntimeException {
writeJpg(pressImage(srcImage, pressImg, x, y, alpha), destImageStream);
}
/**
* 给图片添加图片水印
* 此方法并不关闭流
*
* @param srcImage 源图像流
* @param pressImg 水印图片，可以使用{@link ImageIO#read(File)}方法读取文件
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
* @param y 修正值。 默认在中间，偏移量相对于中间偏移
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
* @return 结果图片
*/
public static Image pressImage(Image srcImage, Image pressImg, int x, int y, float alpha) {
return Img.from(srcImage).pressImage(pressImg, x, y, alpha).getImg();
}
/**
* 给图片添加图片水印
* 此方法并不关闭流
*
* @param srcImage 源图像流
* @param pressImg 水印图片，可以使用{@link ImageIO#read(File)}方法读取文件
* @param rectangle 矩形对象，表示矩形区域的x，y，width，height，x,y从背景图片中心计算
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
* @return 结果图片
* @since 4.1.14
*/
public static Image pressImage(Image srcImage, Image pressImg, Rectangle rectangle, float alpha) {
return Img.from(srcImage).pressImage(pressImg, rectangle, alpha).getImg();
}
// ---------------------------------------------------------------------------------------------------------------------- rotate
/**
* 旋转图片为指定角度
* 此方法不会关闭输出流
*
* @param imageFile 被旋转图像文件
* @param degree 旋转角度
* @param outFile 输出文件
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
public static void rotate(File imageFile, int degree, File outFile) throws IORuntimeException {
rotate(read(imageFile), degree, outFile);
}
/**
* 旋转图片为指定角度
* 此方法不会关闭输出流
*
* @param image 目标图像
* @param degree 旋转角度
* @param outFile 输出文件
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
public static void rotate(Image image, int degree, File outFile) throws IORuntimeException {
write(rotate(image, degree), outFile);
}
/**
* 旋转图片为指定角度
* 此方法不会关闭输出流
*
* @param image 目标图像
* @param degree 旋转角度
* @param out 输出流
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
public static void rotate(Image image, int degree, OutputStream out) throws IORuntimeException {
writeJpg(rotate(image, degree), getImageOutputStream(out));
}
/**
* 旋转图片为指定角度
* 此方法不会关闭输出流，输出格式为JPG
*
* @param image 目标图像
* @param degree 旋转角度
* @param out 输出图像流
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
public static void rotate(Image image, int degree, ImageOutputStream out) throws IORuntimeException {
writeJpg(rotate(image, degree), out);
}
/**
* 旋转图片为指定角度
* @param image 目标图像
* @param degree 旋转角度
* @return 旋转后的图片
* @since 3.2.2
*/
public static Image rotate(Image image, int degree) {
return Img.from(image).rotate(degree).getImg();
}
// ---------------------------------------------------------------------------------------------------------------------- flip
/**
* 水平翻转图像
*
* @param imageFile 图像文件
* @param outFile 输出文件
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
public static void flip(File imageFile, File outFile) throws IORuntimeException {
flip(read(imageFile), outFile);
}
/**
* 水平翻转图像
*
* @param image 图像
* @param outFile 输出文件
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
public static void flip(Image image, File outFile) throws IORuntimeException {
write(flip(image), outFile);
}
/**
* 水平翻转图像
*
* @param image 图像
* @param out 输出
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
public static void flip(Image image, OutputStream out) throws IORuntimeException {
flip(image, getImageOutputStream(out));
}
/**
* 水平翻转图像，写出格式为JPG
*
* @param image 图像
* @param out 输出
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
public static void flip(Image image, ImageOutputStream out) throws IORuntimeException {
writeJpg(flip(image), out);
}
/**
* 水平翻转图像
*
* @param image 图像
* @return 翻转后的图片
* @since 3.2.2
*/
public static Image flip(Image image) {
return Img.from(image).flip().getImg();
}
// ---------------------------------------------------------------------------------------------------------------------- compress
/**
* 压缩图像，输出图像只支持jpg文件
*
* @param imageFile 图像文件
* @param outFile 输出文件，只支持jpg文件
* @param quality 压缩比例，必须为0~1
* @throws IORuntimeException IO异常
* @since 4.3.2
*/
public static void compress(File imageFile, File outFile, float quality) throws IORuntimeException {
Img.from(imageFile).setQuality(quality).write(outFile);
}
// ---------------------------------------------------------------------------------------------------------------------- other
/**
* {@link Image} 转 {@link RenderedImage}
* 首先尝试强转，否则新建一个{@link BufferedImage}后重新绘制
*
* @param img {@link Image}
* @return {@link BufferedImage}
* @since 4.3.2
*/
public static RenderedImage toRenderedImage(Image img) {
if (img instanceof RenderedImage) {
return (RenderedImage) img;
}
return copyImage(img, BufferedImage.TYPE_INT_RGB);
}
/**
* {@link Image} 转 {@link BufferedImage}
* 首先尝试强转，否则新建一个{@link BufferedImage}后重新绘制
*
* @param img {@link Image}
* @return {@link BufferedImage}
*/
public static BufferedImage toBufferedImage(Image img) {
if (img instanceof BufferedImage) {
return (BufferedImage) img;
}
return copyImage(img, BufferedImage.TYPE_INT_RGB);
}
/**
* {@link Image} 转 {@link BufferedImage}
* 如果源图片的RGB模式与目标模式一致，则直接转换，否则重新绘制
*
* @param image {@link Image}
* @param imageType 目标图片类型
* @return {@link BufferedImage}
* @since 4.3.2
*/
public static BufferedImage toBufferedImage(Image image, String imageType) {
BufferedImage bufferedImage;
if (false == imageType.equalsIgnoreCase(IMAGE_TYPE_PNG)) {
// 当目标为非PNG类图片时，源图片统一转换为RGB格式
if (image instanceof BufferedImage) {
bufferedImage = (BufferedImage) image;
if (BufferedImage.TYPE_INT_RGB != bufferedImage.getType()) {
bufferedImage = copyImage(image, BufferedImage.TYPE_INT_RGB);
}
} else {
bufferedImage = copyImage(image, BufferedImage.TYPE_INT_RGB);
}
} else {
bufferedImage = toBufferedImage(image);
}
return bufferedImage;
}
/**
* 将已有Image复制新的一份出来
*
* @param img {@link Image}
* @param imageType 目标图片类型，{@link BufferedImage}中的常量，例如黑白等
* @return {@link BufferedImage}
* @see BufferedImage#TYPE_INT_RGB
* @see BufferedImage#TYPE_INT_ARGB
* @see BufferedImage#TYPE_INT_ARGB_PRE
* @see BufferedImage#TYPE_INT_BGR
* @see BufferedImage#TYPE_3BYTE_BGR
* @see BufferedImage#TYPE_4BYTE_ABGR
* @see BufferedImage#TYPE_4BYTE_ABGR_PRE
* @see BufferedImage#TYPE_BYTE_GRAY
* @see BufferedImage#TYPE_USHORT_GRAY
* @see BufferedImage#TYPE_BYTE_BINARY
* @see BufferedImage#TYPE_BYTE_INDEXED
* @see BufferedImage#TYPE_USHORT_565_RGB
* @see BufferedImage#TYPE_USHORT_555_RGB
*/
public static BufferedImage copyImage(Image img, int imageType) {
return copyImage(img, imageType, null);
}
/**
* 将已有Image复制新的一份出来
*
* @param img {@link Image}
* @param imageType 目标图片类型，{@link BufferedImage}中的常量，例如黑白等
* @param backgroundColor 背景色，{@code null} 表示默认背景色（黑色或者透明）
* @return {@link BufferedImage}
* @see BufferedImage#TYPE_INT_RGB
* @see BufferedImage#TYPE_INT_ARGB
* @see BufferedImage#TYPE_INT_ARGB_PRE
* @see BufferedImage#TYPE_INT_BGR
* @see BufferedImage#TYPE_3BYTE_BGR
* @see BufferedImage#TYPE_4BYTE_ABGR
* @see BufferedImage#TYPE_4BYTE_ABGR_PRE
* @see BufferedImage#TYPE_BYTE_GRAY
* @see BufferedImage#TYPE_USHORT_GRAY
* @see BufferedImage#TYPE_BYTE_BINARY
* @see BufferedImage#TYPE_BYTE_INDEXED
* @see BufferedImage#TYPE_USHORT_565_RGB
* @see BufferedImage#TYPE_USHORT_555_RGB
* @since 4.5.17
*/
public static BufferedImage copyImage(Image img, int imageType, Color backgroundColor) {
final BufferedImage bimage = new BufferedImage(img.getWidth(null), img.getHeight(null), imageType);
final Graphics2D bGr = GraphicsUtil.createGraphics(bimage, backgroundColor);
bGr.drawImage(img, 0, 0, null);
bGr.dispose();
return bimage;
}
/**
* 将Base64编码的图像信息转为 {@link BufferedImage}
*
* @param base64 图像的Base64表示
* @return {@link BufferedImage}
* @throws IORuntimeException IO异常
*/
public static BufferedImage toImage(String base64) throws IORuntimeException {
return toImage(Base64.decode(base64));
}
/**
* 将的图像bytes转为 {@link BufferedImage}
*
* @param imageBytes 图像bytes
* @return {@link BufferedImage}
* @throws IORuntimeException IO异常
*/
public static BufferedImage toImage(byte[] imageBytes) throws IORuntimeException {
return read(new ByteArrayInputStream(imageBytes));
}
/**
* 将图片对象转换为InputStream形式
*
* @param image 图片对象
* @param imageType 图片类型
* @return Base64的字符串表现形式
* @since 4.2.4
*/
public static ByteArrayInputStream toStream(Image image, String imageType) {
return IoUtil.toStream(toBytes(image, imageType));
}
/**
* 将图片对象转换为Base64的Data URI形式，格式为：data:image/[imageType];base64,[data]
*
* @param image 图片对象
* @param imageType 图片类型
* @return Base64的字符串表现形式
* @since 5.3.6
*/
public static String toBase64DataUri(Image image, String imageType) {
return URLUtil.getDataUri(
"image/" + imageType, "base64",
toBase64(image, imageType));
}
/**
* 将图片对象转换为Base64形式
*
* @param image 图片对象
* @param imageType 图片类型
* @return Base64的字符串表现形式
* @since 4.1.8
*/
public static String toBase64(Image image, String imageType) {
return Base64.encode(toBytes(image, imageType));
}
/**
* 将图片对象转换为bytes形式
*
* @param image 图片对象
* @param imageType 图片类型
* @return Base64的字符串表现形式
* @since 5.2.4
*/
public static byte[] toBytes(Image image, String imageType) {
final ByteArrayOutputStream out = new ByteArrayOutputStream();
write(image, imageType, out);
return out.toByteArray();
}
/**
* 根据文字创建PNG图片
*
* @param str 文字
* @param font 字体{@link Font}
* @param backgroundColor 背景颜色，默认透明
* @param fontColor 字体颜色，默认黑色
* @param out 图片输出地
* @throws IORuntimeException IO异常
*/
public static void createImage(String str, Font font, Color backgroundColor, Color fontColor, ImageOutputStream out) throws IORuntimeException {
writePng(createImage(str, font, backgroundColor, fontColor, BufferedImage.TYPE_INT_ARGB), out);
}
/**
* 根据文字创建图片
*
* @param str 文字
* @param font 字体{@link Font}
* @param backgroundColor 背景颜色，默认透明
* @param fontColor 字体颜色，默认黑色
* @param imageType 图片类型，见：{@link BufferedImage}
* @return 图片
* @throws IORuntimeException IO异常
*/
public static BufferedImage createImage(String str, Font font, Color backgroundColor, Color fontColor, int imageType) throws IORuntimeException {
// 获取font的样式应用在str上的整个矩形
final Rectangle2D r = getRectangle(str, font);
// 获取单个字符的高度
int unitHeight = (int) Math.floor(r.getHeight());
// 获取整个str用了font样式的宽度这里用四舍五入后+1保证宽度绝对能容纳这个字符串作为图片的宽度
int width = (int) Math.round(r.getWidth()) + 1;
// 把单个字符的高度+3保证高度绝对能容纳字符串作为图片的高度
int height = unitHeight + 3;
// 创建图片
final BufferedImage image = new BufferedImage(width, height, imageType);
final Graphics g = image.getGraphics();
if (null != backgroundColor) {
// 先用背景色填充整张图片,也就是背景
g.setColor(backgroundColor);
g.fillRect(0, 0, width, height);
}
g.setColor(ObjectUtil.defaultIfNull(fontColor, Color.BLACK));
g.setFont(font);// 设置画笔字体
g.drawString(str, 0, font.getSize());// 画出字符串
g.dispose();
return image;
}
/**
* 获取font的样式应用在str上的整个矩形
*
* @param str 字符串，必须非空
* @param font 字体，必须非空
* @return {@link Rectangle2D}
* @since 5.3.3
*/
public static Rectangle2D getRectangle(String str, Font font) {
return font.getStringBounds(str,
new FontRenderContext(AffineTransform.getScaleInstance(1, 1),
false,
false));
}
/**
* 根据文件创建字体<br/>
* 首先尝试创建{@link Font#TRUETYPE_FONT}字体，此类字体无效则创建{@link Font#TYPE1_FONT}
*
* @param fontFile 字体文件
* @return {@link Font}
* @since 3.0.9
*/
public static Font createFont(File fontFile) {
return FontUtil.createFont(fontFile);
}
/**
* 根据文件创建字体
* 首先尝试创建{@link Font#TRUETYPE_FONT}字体，此类字体无效则创建{@link Font#TYPE1_FONT}
*
* @param fontStream 字体流
* @return {@link Font}
* @since 3.0.9
*/
public static Font createFont(InputStream fontStream) {
return FontUtil.createFont(fontStream);
}
/**
* 创建{@link Graphics2D}
*
* @param image {@link BufferedImage}
* @param color {@link Color}背景颜色以及当前画笔颜色
* @return {@link Graphics2D}
* @see GraphicsUtil#createGraphics(BufferedImage, Color)
* @since 3.2.3
*/
public static Graphics2D createGraphics(BufferedImage image, Color color) {
return GraphicsUtil.createGraphics(image, color);
}
/**
* 写出图像为JPG格式
*
* @param image {@link Image}
* @param destImageStream 写出到的目标流
* @throws IORuntimeException IO异常
*/
public static void writeJpg(Image image, ImageOutputStream destImageStream) throws IORuntimeException {
write(image, IMAGE_TYPE_JPG, destImageStream);
}
/**
* 写出图像为PNG格式
*
* @param image {@link Image}
* @param destImageStream 写出到的目标流
* @throws IORuntimeException IO异常
*/
public static void writePng(Image image, ImageOutputStream destImageStream) throws IORuntimeException {
write(image, IMAGE_TYPE_PNG, destImageStream);
}
/**
* 写出图像为JPG格式
*
* @param image {@link Image}
* @param out 写出到的目标流
* @throws IORuntimeException IO异常
* @since 4.0.10
*/
public static void writeJpg(Image image, OutputStream out) throws IORuntimeException {
write(image, IMAGE_TYPE_JPG, out);
}
/**
* 写出图像为PNG格式
*
* @param image {@link Image}
* @param out 写出到的目标流
* @throws IORuntimeException IO异常
* @since 4.0.10
*/
public static void writePng(Image image, OutputStream out) throws IORuntimeException {
write(image, IMAGE_TYPE_PNG, out);
}
/**
* 按照目标格式写出图像：GIF=》JPG、GIF=》PNG、PNG=》JPG、PNG=》GIF(X)、BMP=》PNG<br/>
* 此方法并不关闭流
*
* @param srcStream 源图像流
* @param formatName 包含格式非正式名称的 String：如JPG、JPEG、GIF等
* @param destStream 目标图像输出流
* @since 5.0.0
*/
public static void write(ImageInputStream srcStream, String formatName, ImageOutputStream destStream) {
write(read(srcStream), formatName, destStream);
}
/**
* 写出图像：GIF=》JPG、GIF=》PNG、PNG=》JPG、PNG=》GIF(X)、BMP=》PNG<br/>
* 此方法并不关闭流
*
* @param image {@link Image}
* @param imageType 图片类型（图片扩展名）
* @param out 写出到的目标流
* @throws IORuntimeException IO异常
* @since 3.1.2
*/
public static void write(Image image, String imageType, OutputStream out) throws IORuntimeException {
write(image, imageType, getImageOutputStream(out));
}
/**
* 写出图像为指定格式：GIF=》JPG、GIF=》PNG、PNG=》JPG、PNG=》GIF(X)、BMP=》PNG<br/>
* 此方法并不关闭流
*
* @param image {@link Image}
* @param imageType 图片类型（图片扩展名）
* @param destImageStream 写出到的目标流
* @return 是否成功写出，如果返回false表示未找到合适的Writer
* @throws IORuntimeException IO异常
* @since 3.1.2
*/
public static boolean write(Image image, String imageType, ImageOutputStream destImageStream) throws IORuntimeException {
return write(image, imageType, destImageStream, 1);
}
/**
* 写出图像为指定格式
*
* @param image {@link Image}
* @param imageType 图片类型（图片扩展名）
* @param destImageStream 写出到的目标流
* @param quality 质量，数字为0~1（不包括0和1）表示质量压缩比，除此数字外设置表示不压缩
* @return 是否成功写出，如果返回false表示未找到合适的Writer
* @throws IORuntimeException IO异常
* @since 4.3.2
*/
public static boolean write(Image image, String imageType, ImageOutputStream destImageStream, float quality) throws IORuntimeException {
if (StrUtil.isBlank(imageType)) {
imageType = IMAGE_TYPE_JPG;
}
final ImageWriter writer = getWriter(image, imageType);
return write(toBufferedImage(image, imageType), writer, destImageStream, quality);
}
/**
* 写出图像为目标文件扩展名对应的格式
*
* @param image {@link Image}
* @param targetFile 目标文件
* @throws IORuntimeException IO异常
* @since 3.1.0
*/
public static void write(Image image, File targetFile) throws IORuntimeException {
ImageOutputStream out = null;
try {
out = getImageOutputStream(targetFile);
write(image, FileUtil.extName(targetFile), out);
} finally {
IoUtil.close(out);
}
}
/**
* 通过{@link ImageWriter}写出图片到输出流
*
* @param image 图片
* @param writer {@link ImageWriter}
* @param output 输出的Image流{@link ImageOutputStream}
* @param quality 质量，数字为0~1（不包括0和1）表示质量压缩比，除此数字外设置表示不压缩
* @return 是否成功写出
* @since 4.3.2
*/
public static boolean write(Image image, ImageWriter writer, ImageOutputStream output, float quality) {
if (writer == null) {
return false;
}
writer.setOutput(output);
final RenderedImage renderedImage = toRenderedImage(image);
// 设置质量
ImageWriteParam imgWriteParams = null;
if (quality > 0 && quality < 1) {
imgWriteParams = writer.getDefaultWriteParam();
if (imgWriteParams.canWriteCompressed()) {
imgWriteParams.setCompressionMode(ImageWriteParam.MODE_EXPLICIT);
imgWriteParams.setCompressionQuality(quality);
final ColorModel colorModel = renderedImage.getColorModel();// ColorModel.getRGBdefault();
imgWriteParams.setDestinationType(new ImageTypeSpecifier(colorModel, colorModel.createCompatibleSampleModel(16, 16)));
}
}
try {
if (null != imgWriteParams) {
writer.write(null, new IIOImage(renderedImage, null, null), imgWriteParams);
} else {
writer.write(renderedImage);
}
output.flush();
} catch (IOException e) {
throw new IORuntimeException(e);
} finally {
writer.dispose();
}
return true;
}
/**
* 获得{@link ImageReader}
*
* @param type 图片文件类型，例如 "jpeg" 或 "tiff"
* @return {@link ImageReader}
*/
public static ImageReader getReader(String type) {
final Iterator<ImageReader> iterator = ImageIO.getImageReadersByFormatName(type);
if (iterator.hasNext()) {
return iterator.next();
}
return null;
}
/**
* 从文件中读取图片，请使用绝对路径，使用相对路径会相对于ClassPath
*
* @param imageFilePath 图片文件路径
* @return 图片
* @since 4.1.15
*/
public static BufferedImage read(String imageFilePath) {
return read(FileUtil.file(imageFilePath));
}
/**
* 从文件中读取图片
*
* @param imageFile 图片文件
* @return 图片
* @since 3.2.2
*/
public static BufferedImage read(File imageFile) {
BufferedImage result;
try {
result = ImageIO.read(imageFile);
} catch (IOException e) {
throw new IORuntimeException(e);
}
if (null == result) {
throw new IllegalArgumentException("Image type of file [" + imageFile.getName() + "] is not supported!");
}
return result;
}
/**
* 从{@link Resource}中读取图片
*
* @param resource 图片资源
* @return 图片
* @since 4.4.1
*/
public static BufferedImage read(Resource resource) {
return read(resource.getStream());
}
/**
* 从流中读取图片
*
* @param imageStream 图片文件
* @return 图片
* @since 3.2.2
*/
public static BufferedImage read(InputStream imageStream) {
BufferedImage result;
try {
result = ImageIO.read(imageStream);
} catch (IOException e) {
throw new IORuntimeException(e);
}
if (null == result) {
throw new IllegalArgumentException("Image type is not supported!");
}
return result;
}
/**
* 从图片流中读取图片
*
* @param imageStream 图片文件
* @return 图片
* @since 3.2.2
*/
public static BufferedImage read(ImageInputStream imageStream) {
BufferedImage result;
try {
result = ImageIO.read(imageStream);
} catch (IOException e) {
throw new IORuntimeException(e);
}
if (null == result) {
throw new IllegalArgumentException("Image type is not supported!");
}
return result;
}
/**
* 从URL中读取图片
*
* @param imageUrl 图片文件
* @return 图片
* @since 3.2.2
*/
public static BufferedImage read(URL imageUrl) {
BufferedImage result;
try {
result = ImageIO.read(imageUrl);
} catch (IOException e) {
throw new IORuntimeException(e);
}
if (null == result) {
throw new IllegalArgumentException("Image type of [" + imageUrl.toString() + "] is not supported!");
}
return result;
}
/**
* 获取{@link ImageOutputStream}
*
* @param out {@link OutputStream}
* @return {@link ImageOutputStream}
* @throws IORuntimeException IO异常
* @since 3.1.2
*/
public static ImageOutputStream getImageOutputStream(OutputStream out) throws IORuntimeException {
ImageOutputStream result;
try {
result = ImageIO.createImageOutputStream(out);
} catch (IOException e) {
throw new IORuntimeException(e);
}
if (null == result) {
throw new IllegalArgumentException("Image type is not supported!");
}
return result;
}
/**
* 获取{@link ImageOutputStream}
*
* @param outFile {@link File}
* @return {@link ImageOutputStream}
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
public static ImageOutputStream getImageOutputStream(File outFile) throws IORuntimeException {
ImageOutputStream result;
try {
result = ImageIO.createImageOutputStream(outFile);
} catch (IOException e) {
throw new IORuntimeException(e);
}
if (null == result) {
throw new IllegalArgumentException("Image type of file [" + outFile.getName() + "] is not supported!");
}
return result;
}
/**
* 获取{@link ImageInputStream}
*
* @param in {@link InputStream}
* @return {@link ImageInputStream}
* @throws IORuntimeException IO异常
* @since 3.1.2
*/
public static ImageInputStream getImageInputStream(InputStream in) throws IORuntimeException {
ImageOutputStream result;
try {
result = ImageIO.createImageOutputStream(in);
} catch (IOException e) {
throw new IORuntimeException(e);
}
if (null == result) {
throw new IllegalArgumentException("Image type is not supported!");
}
return result;
}
/**
* 根据给定的Image对象和格式获取对应的{@link ImageWriter}，如果未找到合适的Writer，返回null
*
* @param img {@link Image}
* @param formatName 图片格式，例如"jpg"、"png"
* @return {@link ImageWriter}
* @since 4.3.2
*/
public static ImageWriter getWriter(Image img, String formatName) {
final ImageTypeSpecifier type = ImageTypeSpecifier.createFromRenderedImage(toRenderedImage(img));
final Iterator<ImageWriter> iter = ImageIO.getImageWriters(type, formatName);
return iter.hasNext() ? iter.next() : null;
}
/**
* 根据给定的图片格式或者扩展名获取{@link ImageWriter}，如果未找到合适的Writer，返回null
*
* @param formatName 图片格式或扩展名，例如"jpg"、"png"
* @return {@link ImageWriter}
* @since 4.3.2
*/
public static ImageWriter getWriter(String formatName) {
ImageWriter writer = null;
Iterator<ImageWriter> iter = ImageIO.getImageWritersByFormatName(formatName);
if (iter.hasNext()) {
writer = iter.next();
}
if (null == writer) {
// 尝试扩展名获取
iter = ImageIO.getImageWritersBySuffix(formatName);
if (iter.hasNext()) {
writer = iter.next();
}
}
return writer;
}
// -------------------------------------------------------------------------------------------------------------------- Color
/**
* Color对象转16进制表示，例如#fcf6d6
*
* @param color {@link Color}
* @return 16进制的颜色值，例如#fcf6d6
* @since 4.1.14
*/
public static String toHex(Color color) {
return toHex(color.getRed(), color.getGreen(), color.getBlue());
}
/**
* RGB颜色值转换成十六进制颜色码
*
* @param r 红(R)
* @param g 绿(G)
* @param b 蓝(B)
* @return 返回字符串形式的 十六进制颜色码 如
*/
public static String toHex(int r, int g, int b) {
// rgb 小于 255
if (r < 0 || r > 255 || g < 0 || g > 255 || b < 0 || b > 255) {
throw new IllegalArgumentException("RGB must be 0~255!");
}
return String.format("#%02X%02X%02X", r, g, b);
}
/**
* 16进制的颜色值转换为Color对象，例如#fcf6d6
*
* @param hex 16进制的颜色值，例如#fcf6d6
* @return {@link Color}
* @since 4.1.14
*/
public static Color hexToColor(String hex) {
return getColor(Integer.parseInt(StrUtil.removePrefix(hex, "#"), 16));
}
/**
* 获取一个RGB值对应的颜色
*
* @param rgb RGB值
* @return {@link Color}
* @since 4.1.14
*/
public static Color getColor(int rgb) {
return new Color(rgb);
}
/**
* 将颜色值转换成具体的颜色类型 汇集了常用的颜色集，支持以下几种形式：
*
* <pre>
* 1. 颜色的英文名（大小写皆可）
* 2. 16进制表示，例如：#fcf6d6或者$fcf6d6
* 3. RGB形式，例如：13,148,252
* </pre>
* <p>
* 方法来自：com.lnwazg.kit
*
* @param colorName 颜色的英文名，16进制表示或RGB表示
* @return {@link Color}
* @since 4.1.14
*/
public static Color getColor(String colorName) {
if (StrUtil.isBlank(colorName)) {
return null;
}
colorName = colorName.toUpperCase();
if ("BLACK".equals(colorName)) {
return Color.BLACK;
} else if ("WHITE".equals(colorName)) {
return Color.WHITE;
} else if ("LIGHTGRAY".equals(colorName) || "LIGHT_GRAY".equals(colorName)) {
return Color.LIGHT_GRAY;
} else if ("GRAY".equals(colorName)) {
return Color.GRAY;
} else if ("DARKGRAY".equals(colorName) || "DARK_GRAY".equals(colorName)) {
return Color.DARK_GRAY;
} else if ("RED".equals(colorName)) {
return Color.RED;
} else if ("PINK".equals(colorName)) {
return Color.PINK;
} else if ("ORANGE".equals(colorName)) {
return Color.ORANGE;
} else if ("YELLOW".equals(colorName)) {
return Color.YELLOW;
} else if ("GREEN".equals(colorName)) {
return Color.GREEN;
} else if ("MAGENTA".equals(colorName)) {
return Color.MAGENTA;
} else if ("CYAN".equals(colorName)) {
return Color.CYAN;
} else if ("BLUE".equals(colorName)) {
return Color.BLUE;
} else if ("DARKGOLD".equals(colorName)) {
// 暗金色
return hexToColor("#9e7e67");
} else if ("LIGHTGOLD".equals(colorName)) {
// 亮金色
return hexToColor("#ac9c85");
} else if (StrUtil.startWith(colorName, '#')) {
return hexToColor(colorName);
} else if (StrUtil.startWith(colorName, '$')) {
// 由于#在URL传输中无法传输，因此用$代替#
return hexToColor("#" + colorName.substring(1));
} else {
// rgb值
final List<String> rgb = StrUtil.split(colorName, ',');
if (3 == rgb.size()) {
final Integer r = Convert.toInt(rgb.get(0));
final Integer g = Convert.toInt(rgb.get(1));
final Integer b = Convert.toInt(rgb.get(2));
if (false == ArrayUtil.hasNull(r, g, b)) {
return new Color(r, g, b);
}
} else {
return null;
}
}
return null;
}
/**
* 生成随机颜色
*
* @return 随机颜色
* @since 3.1.2
*/
public static Color randomColor() {
return randomColor(null);
}
/**
* 生成随机颜色
*
* @param random 随机对象 {@link Random}
* @return 随机颜色
* @since 3.1.2
*/
public static Color randomColor(Random random) {
if (null == random) {
random = RandomUtil.getRandom();
}
return new Color(random.nextInt(RGB_COLOR_BOUND), random.nextInt(RGB_COLOR_BOUND), random.nextInt(RGB_COLOR_BOUND));
}
/**
* 获得修正后的矩形坐标位置，变为以背景中心为基准坐标（即x,y == 0,0时，处于背景正中）
*
* @param rectangle 矩形
* @param backgroundWidth 参考宽（背景宽）
* @param backgroundHeight 参考高（背景高）
* @return 修正后的{@link Point}
* @since 5.3.6
*/
public static Point getPointBaseCentre(Rectangle rectangle, int backgroundWidth, int backgroundHeight) {
return new Point(
rectangle.x + (Math.abs(backgroundWidth - rectangle.width) / 2), //
rectangle.y + (Math.abs(backgroundHeight - rectangle.height) / 2)//
);
}
// ------------------------------------------------------------------------------------------------------ 背景图换算
/**
* 背景移除
* 图片去底工具
* 将 "纯色背景的图片" 还原成 "透明背景的图片"
* 将纯色背景的图片转成矢量图
* 取图片边缘的像素点和获取到的图片主题色作为要替换的背景色
* 再加入一定的容差值,然后将所有像素点与该颜色进行比较
* 发现相同则将颜色不透明度设置为0,使颜色完全透明.
*
* @param inputPath 要处理图片的路径
* @param outputPath 输出图片的路径
* @param tolerance 容差值[根据图片的主题色,加入容差值,值的范围在0~255之间]
* @return 返回处理结果 true:图片处理完成 false:图片处理失败
*/
public static boolean backgroundRemoval(String inputPath, String outputPath, int tolerance) {
return BackgroundRemoval.backgroundRemoval(inputPath, outputPath, tolerance);
}
/**
* 背景移除
* 图片去底工具
* 将 "纯色背景的图片" 还原成 "透明背景的图片"
* 将纯色背景的图片转成矢量图
* 取图片边缘的像素点和获取到的图片主题色作为要替换的背景色
* 再加入一定的容差值,然后将所有像素点与该颜色进行比较
* 发现相同则将颜色不透明度设置为0,使颜色完全透明.
*
* @param input 需要进行操作的图片
* @param output 最后输出的文件
* @param tolerance 容差值[根据图片的主题色,加入容差值,值的取值范围在0~255之间]
* @return 返回处理结果 true:图片处理完成 false:图片处理失败
*/
public static boolean backgroundRemoval(File input, File output, int tolerance) {
return BackgroundRemoval.backgroundRemoval(input, output, tolerance);
}
/**
* 背景移除
* 图片去底工具
* 将 "纯色背景的图片" 还原成 "透明背景的图片"
* 将纯色背景的图片转成矢量图
* 取图片边缘的像素点和获取到的图片主题色作为要替换的背景色
* 再加入一定的容差值,然后将所有像素点与该颜色进行比较
* 发现相同则将颜色不透明度设置为0,使颜色完全透明.
*
* @param input 需要进行操作的图片
* @param output 最后输出的文件
* @param override 指定替换成的背景颜色 为null时背景为透明
* @param tolerance 容差值[根据图片的主题色,加入容差值,值的取值范围在0~255之间]
* @return 返回处理结果 true:图片处理完成 false:图片处理失败
*/
public static boolean backgroundRemoval(File input, File output, Color override, int tolerance) {
return BackgroundRemoval.backgroundRemoval(input, output, override, tolerance);
}
/**
* 背景移除
* 图片去底工具
* 将 "纯色背景的图片" 还原成 "透明背景的图片"
* 将纯色背景的图片转成矢量图
* 取图片边缘的像素点和获取到的图片主题色作为要替换的背景色
* 再加入一定的容差值,然后将所有像素点与该颜色进行比较
* 发现相同则将颜色不透明度设置为0,使颜色完全透明.
*
* @param bufferedImage 需要进行处理的图片流
* @param override 指定替换成的背景颜色 为null时背景为透明
* @param tolerance 容差值[根据图片的主题色,加入容差值,值的取值范围在0~255之间]
* @return 返回处理好的图片流
*/
public static BufferedImage backgroundRemoval(BufferedImage bufferedImage, Color override, int tolerance) {
return BackgroundRemoval.backgroundRemoval(bufferedImage, override, tolerance);
}
/**
* 背景移除
* 图片去底工具
* 将 "纯色背景的图片" 还原成 "透明背景的图片"
* 将纯色背景的图片转成矢量图
* 取图片边缘的像素点和获取到的图片主题色作为要替换的背景色
* 再加入一定的容差值,然后将所有像素点与该颜色进行比较
* 发现相同则将颜色不透明度设置为0,使颜色完全透明.
*
* @param outputStream 需要进行处理的图片字节数组流
* @param override 指定替换成的背景颜色 为null时背景为透明
* @param tolerance 容差值[根据图片的主题色,加入容差值,值的取值范围在0~255之间]
* @return 返回处理好的图片流
*/
public static BufferedImage backgroundRemoval(ByteArrayOutputStream outputStream, Color override, int tolerance) {
return BackgroundRemoval.backgroundRemoval(outputStream, override, tolerance);
}
}
正文到此结束
- 本文标签： Java 后端 工具类
- 本文链接： http://www.92cxy.cn/article/29
- 版权声明： 本文由王小东原创发布，转载请遵循《署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0)》许可协议授权
热门推荐
相关文章
该篇文章的评论功能已被站长关闭
