diff --git a/hutool-swing/src/main/java/org/dromara/hutool/swing/DesktopUtil.java b/hutool-swing/src/main/java/org/dromara/hutool/swing/DesktopUtil.java
index b0095a284..2af642757 100644
--- a/hutool-swing/src/main/java/org/dromara/hutool/swing/DesktopUtil.java
+++ b/hutool-swing/src/main/java/org/dromara/hutool/swing/DesktopUtil.java
@@ -34,7 +34,7 @@ public class DesktopUtil {
*
* @return {@link Desktop}
*/
- public static Desktop getDsktop() {
+ public static Desktop getDesktop() {
return Desktop.getDesktop();
}
@@ -54,9 +54,9 @@ public class DesktopUtil {
* @since 4.6.3
*/
public static void browse(final URI uri) {
- final Desktop dsktop = getDsktop();
+ final Desktop desktop = getDesktop();
try {
- dsktop.browse(uri);
+ desktop.browse(uri);
} catch (final IOException e) {
throw new IORuntimeException(e);
}
@@ -68,9 +68,9 @@ public class DesktopUtil {
* @param file URL地址
*/
public static void open(final File file) {
- final Desktop dsktop = getDsktop();
+ final Desktop desktop = getDesktop();
try {
- dsktop.open(file);
+ desktop.open(file);
} catch (final IOException e) {
throw new IORuntimeException(e);
}
@@ -82,9 +82,9 @@ public class DesktopUtil {
* @param file 文件
*/
public static void edit(final File file) {
- final Desktop dsktop = getDsktop();
+ final Desktop desktop = getDesktop();
try {
- dsktop.edit(file);
+ desktop.edit(file);
} catch (final IOException e) {
throw new IORuntimeException(e);
}
@@ -96,9 +96,9 @@ public class DesktopUtil {
* @param file 文件
*/
public static void print(final File file) {
- final Desktop dsktop = getDsktop();
+ final Desktop desktop = getDesktop();
try {
- dsktop.print(file);
+ desktop.print(file);
} catch (final IOException e) {
throw new IORuntimeException(e);
}
@@ -110,9 +110,9 @@ public class DesktopUtil {
* @param mailAddress 邮件地址
*/
public static void mail(final String mailAddress) {
- final Desktop dsktop = getDsktop();
+ final Desktop desktop = getDesktop();
try {
- dsktop.mail(UrlUtil.toURI(mailAddress));
+ desktop.mail(UrlUtil.toURI(mailAddress));
} catch (final IOException e) {
throw new IORuntimeException(e);
}
diff --git a/hutool-swing/src/main/java/org/dromara/hutool/swing/RobotUtil.java b/hutool-swing/src/main/java/org/dromara/hutool/swing/RobotUtil.java
index a63fac5e3..f92ee125f 100644
--- a/hutool-swing/src/main/java/org/dromara/hutool/swing/RobotUtil.java
+++ b/hutool-swing/src/main/java/org/dromara/hutool/swing/RobotUtil.java
@@ -201,7 +201,13 @@ public class RobotUtil {
* @return 写出到的文件
*/
public static File captureScreen(final File outFile) {
- ImgUtil.write(captureScreen(), outFile);
+ BufferedImage image = null;
+ try{
+ image = captureScreen();
+ ImgUtil.write(image, outFile);
+ } finally {
+ ImgUtil.flush(image);
+ }
return outFile;
}
diff --git a/hutool-swing/src/main/java/org/dromara/hutool/swing/captcha/AbstractCaptcha.java b/hutool-swing/src/main/java/org/dromara/hutool/swing/captcha/AbstractCaptcha.java
index 1af6ee501..81edaa76f 100644
--- a/hutool-swing/src/main/java/org/dromara/hutool/swing/captcha/AbstractCaptcha.java
+++ b/hutool-swing/src/main/java/org/dromara/hutool/swing/captcha/AbstractCaptcha.java
@@ -112,7 +112,15 @@ public abstract class AbstractCaptcha implements ICaptcha {
generateCode();
final ByteArrayOutputStream out = new ByteArrayOutputStream();
- ImgUtil.writePng(createImage(this.code), out);
+
+ Image image = null;
+ try{
+ image = createImage(this.code);
+ ImgUtil.writePng(image, out);
+ } finally {
+ ImgUtil.flush(image);
+ }
+
this.imageBytes = out.toByteArray();
}
@@ -189,7 +197,8 @@ public abstract class AbstractCaptcha implements ICaptcha {
}
/**
- * 获取验证码图
+ * 获取验证码图
+ * 注意返回的{@link BufferedImage}使用完毕后需要调用{@link BufferedImage#flush()}释放资源
*
* @return 验证码图
*/
diff --git a/hutool-swing/src/main/java/org/dromara/hutool/swing/img/BackgroundRemoval.java b/hutool-swing/src/main/java/org/dromara/hutool/swing/img/BackgroundRemoval.java
index 8c73a371f..88433727a 100644
--- a/hutool-swing/src/main/java/org/dromara/hutool/swing/img/BackgroundRemoval.java
+++ b/hutool-swing/src/main/java/org/dromara/hutool/swing/img/BackgroundRemoval.java
@@ -12,9 +12,10 @@
package org.dromara.hutool.swing.img;
+import org.dromara.hutool.core.array.ArrayUtil;
import org.dromara.hutool.core.io.IORuntimeException;
import org.dromara.hutool.core.io.file.FileTypeUtil;
-import org.dromara.hutool.core.array.ArrayUtil;
+import org.dromara.hutool.core.lang.Assert;
import org.dromara.hutool.core.text.StrUtil;
import org.dromara.hutool.swing.img.color.ColorUtil;
@@ -33,9 +34,7 @@ import java.util.List;
import java.util.Map;
/**
- * 图片背景识别处理、背景替换、背景设置为矢量图
- * 根据一定规则算出图片背景色的RGB值，进行替换
- * 2020-05-21 16:36
+ * 图片背景识别处理、背景替换、背景设置为矢量图，根据一定规则算出图片背景色的RGB值，进行替换
*
* @author Dai Yuanchuan
**/
@@ -45,7 +44,7 @@ public class BackgroundRemoval {
* 目前暂时支持的图片类型数组
* 其他格式的不保证结果
*/
- public static String[] IMAGES_TYPE = {"jpg", "png"};
+ public static String[] IMAGES_TYPE = {ImgUtil.IMAGE_TYPE_JPG, ImgUtil.IMAGE_TYPE_JPEG, ImgUtil.IMAGE_TYPE_PNG};
/**
* 背景移除
@@ -59,10 +58,9 @@ public class BackgroundRemoval {
* @param inputPath 要处理图片的路径
* @param outputPath 输出图片的路径
* @param tolerance 容差值[根据图片的主题色,加入容差值,值的范围在0~255之间]
- * @return 返回处理结果 true:图片处理完成 false:图片处理失败
*/
- public static boolean backgroundRemoval(final String inputPath, final String outputPath, final int tolerance) {
- return backgroundRemoval(new File(inputPath), new File(outputPath), tolerance);
+ public static void backgroundRemoval(final String inputPath, final String outputPath, final int tolerance) {
+ backgroundRemoval(new File(inputPath), new File(outputPath), tolerance);
}
/**
@@ -77,10 +75,9 @@ public class BackgroundRemoval {
* @param input 需要进行操作的图片
* @param output 最后输出的文件
* @param tolerance 容差值[根据图片的主题色,加入容差值,值的取值范围在0~255之间]
- * @return 返回处理结果 true:图片处理完成 false:图片处理失败
*/
- public static boolean backgroundRemoval(final File input, final File output, final int tolerance) {
- return backgroundRemoval(input, output, null, tolerance);
+ public static void backgroundRemoval(final File input, final File output, final int tolerance) {
+ backgroundRemoval(input, output, null, tolerance);
}
/**
@@ -93,22 +90,20 @@ public class BackgroundRemoval {
* 发现相同则将颜色不透明度设置为0,使颜色完全透明.
*
* @param input 需要进行操作的图片
- * @param output 最后输出的文件
+ * @param output 最后输出的文件，必须为.png
* @param override 指定替换成的背景颜色 为null时背景为透明
* @param tolerance 容差值[根据图片的主题色,加入容差值,值的取值范围在0~255之间]
- * @return 返回处理结果 true:图片处理完成 false:图片处理失败
*/
- public static boolean backgroundRemoval(final File input, final File output, final Color override, final int tolerance) {
- if (fileTypeValidation(input, IMAGES_TYPE)) {
- return false;
- }
+ public static void backgroundRemoval(final File input, final File output, final Color override, final int tolerance) {
+ fileTypeValidation(input, IMAGES_TYPE);
+ BufferedImage bufferedImage = null;
try {
// 获取图片左上、中上、右上、右中、右下、下中、左下、左中、8个像素点rgb的16进制值
- final BufferedImage bufferedImage = ImageIO.read(input);
+ bufferedImage = ImgUtil.read(input);
// 图片输出的格式为 png
- return ImageIO.write(backgroundRemoval(bufferedImage, override, tolerance), "png", output);
- } catch (final IOException e) {
- throw new IORuntimeException(e);
+ ImgUtil.write(backgroundRemoval(bufferedImage, override, tolerance), output);
+ } finally {
+ ImgUtil.flush(bufferedImage);
}
}
@@ -132,7 +127,7 @@ public class BackgroundRemoval {
// 绘制icon
final ImageIcon imageIcon = new ImageIcon(bufferedImage);
final BufferedImage image = new BufferedImage(imageIcon.getIconWidth(), imageIcon.getIconHeight(),
- BufferedImage.TYPE_4BYTE_ABGR);
+ BufferedImage.TYPE_4BYTE_ABGR);
// 绘图工具
final Graphics graphics = image.getGraphics();
graphics.drawImage(imageIcon.getImage(), 0, 0, imageIcon.getImageObserver());
@@ -147,7 +142,7 @@ public class BackgroundRemoval {
int rgb = image.getRGB(x, y);
final String hex = ColorUtil.toHex((rgb & 0xff0000) >> 16, (rgb & 0xff00) >> 8, (rgb & 0xff));
final boolean isTrue = ArrayUtil.contains(removeRgb, hex) ||
- areColorsWithinTolerance(hexToRgb(mainColor), new Color(Integer.parseInt(hex.substring(1), 16)), tolerance);
+ areColorsWithinTolerance(hexToRgb(mainColor), new Color(Integer.parseInt(hex.substring(1), 16)), tolerance);
if (isTrue) {
rgb = override == null ? ((alpha + 1) << 24) | (rgb & 0x00ffffff) : override.getRGB();
}
@@ -254,13 +249,13 @@ public class BackgroundRemoval {
*/
public static boolean areColorsWithinTolerance(final Color color1, final Color color2, final Color tolerance) {
return (color1.getRed() - color2.getRed() < tolerance.getRed() && color1
- .getRed() - color2.getRed() > -tolerance.getRed())
- && (color1.getBlue() - color2.getBlue() < tolerance
- .getBlue() && color1.getBlue() - color2.getBlue() > -tolerance
- .getBlue())
- && (color1.getGreen() - color2.getGreen() < tolerance
- .getGreen() && color1.getGreen()
- - color2.getGreen() > -tolerance.getGreen());
+ .getRed() - color2.getRed() > -tolerance.getRed())
+ && (color1.getBlue() - color2.getBlue() < tolerance
+ .getBlue() && color1.getBlue() - color2.getBlue() > -tolerance
+ .getBlue())
+ && (color1.getGreen() - color2.getGreen() < tolerance
+ .getGreen() && color1.getGreen()
+ - color2.getGreen() > -tolerance.getGreen());
}
/**
@@ -335,7 +330,7 @@ public class BackgroundRemoval {
final int rgbLength = 3;
if (strings.length == rgbLength) {
return ColorUtil.toHex(Integer.parseInt(strings[0]), Integer.parseInt(strings[1]),
- Integer.parseInt(strings[2]));
+ Integer.parseInt(strings[2]));
}
return StrUtil.EMPTY;
}
@@ -348,18 +343,14 @@ public class BackgroundRemoval {
*
* @param input 需要进行验证的文件
* @param imagesType 文件包含的类型数组
- * @return 返回布尔值 false:给定文件的文件类型在文件数组中 true:给定文件的文件类型 不在给定数组中。
*/
- private static boolean fileTypeValidation(final File input, final String[] imagesType) {
- if (!input.exists()) {
- throw new IllegalArgumentException("给定文件为空");
- }
+ private static void fileTypeValidation(final File input, final String[] imagesType) {
+ Assert.isTrue(input.exists(), "File {} not exist!", input);
// 获取图片类型
final String type = FileTypeUtil.getType(input);
// 类型对比
if (!ArrayUtil.contains(imagesType, type)) {
- throw new IllegalArgumentException(StrUtil.format("文件类型{}不支持", type));
+ throw new IllegalArgumentException(StrUtil.format("Format {} of File not supported!", type));
}
- return false;
}
}
diff --git a/hutool-swing/src/main/java/org/dromara/hutool/swing/img/FontUtil.java b/hutool-swing/src/main/java/org/dromara/hutool/swing/img/FontUtil.java
index 85d588e72..3020933f4 100644
--- a/hutool-swing/src/main/java/org/dromara/hutool/swing/img/FontUtil.java
+++ b/hutool-swing/src/main/java/org/dromara/hutool/swing/img/FontUtil.java
@@ -19,6 +19,9 @@ import java.awt.Dimension;
import java.awt.Font;
import java.awt.FontFormatException;
import java.awt.FontMetrics;
+import java.awt.font.FontRenderContext;
+import java.awt.geom.AffineTransform;
+import java.awt.geom.Rectangle2D;
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
@@ -119,4 +122,19 @@ public class FontUtil {
return new Dimension(width, height);
}
+ /**
+ * 获取font的样式应用在str上的整个矩形
+ *
+ * @param str 字符串，必须非空
+ * @param font 字体，必须非空
+ * @return {@link Rectangle2D}
+ * @since 5.3.3
+ */
+ public static Rectangle2D getRectangle(final String str, final Font font) {
+ return font.getStringBounds(str,
+ new FontRenderContext(AffineTransform.getScaleInstance(1, 1),
+ false,
+ false));
+ }
+
}
diff --git a/hutool-swing/src/main/java/org/dromara/hutool/swing/img/GraphicsUtil.java b/hutool-swing/src/main/java/org/dromara/hutool/swing/img/GraphicsUtil.java
index d1bbbf668..cd3baa4dc 100644
--- a/hutool-swing/src/main/java/org/dromara/hutool/swing/img/GraphicsUtil.java
+++ b/hutool-swing/src/main/java/org/dromara/hutool/swing/img/GraphicsUtil.java
@@ -185,8 +185,8 @@ public class GraphicsUtil {
* @return 画笔对象
*/
public static Graphics drawImg(final Graphics g, final Image img, final Point point) {
- return drawImg(g, img,
- new Rectangle(point.x, point.y, img.getWidth(null), img.getHeight(null)));
+ g.drawImage(img, point.x, point.y, null);
+ return g;
}
/**
diff --git a/hutool-swing/src/main/java/org/dromara/hutool/swing/img/Img.java b/hutool-swing/src/main/java/org/dromara/hutool/swing/img/Img.java
index e9f860833..1d35fb811 100644
--- a/hutool-swing/src/main/java/org/dromara/hutool/swing/img/Img.java
+++ b/hutool-swing/src/main/java/org/dromara/hutool/swing/img/Img.java
@@ -758,10 +758,13 @@ public class Img implements Flushable, Serializable {
* 结果类型设定见{@link #setTargetImageType(String)}
*
* @param out 写出到的目标流
+ * @return this
* @throws IORuntimeException IO异常
*/
- public void write(final OutputStream out) throws IORuntimeException {
+ public Img write(final OutputStream out) throws IORuntimeException {
write(ImgUtil.getImageOutputStream(out));
+
+ return this;
}
/**
@@ -769,9 +772,10 @@ public class Img implements Flushable, Serializable {
* 结果类型设定见{@link #setTargetImageType(String)}
*
* @param targetImageStream 写出到的目标流
+ * @return this
* @throws IORuntimeException IO异常
*/
- public void write(final ImageOutputStream targetImageStream) throws IORuntimeException {
+ public Img write(final ImageOutputStream targetImageStream) throws IORuntimeException {
Assert.notBlank(this.targetImageType, "Target image type is blank !");
Assert.notNull(targetImageStream, "Target output stream is null !");
@@ -779,6 +783,8 @@ public class Img implements Flushable, Serializable {
Assert.notNull(targetImage, "Target image is null !");
ImgUtil.write(targetImage, this.targetImageType, targetImageStream, this.quality, this.backgroundColor);
+
+ return this;
}
/**
@@ -786,8 +792,9 @@ public class Img implements Flushable, Serializable {
*
* @param targetFile 目标文件
* @throws IORuntimeException IO异常
+ * @return this
*/
- public void write(final File targetFile) throws IORuntimeException {
+ public Img write(final File targetFile) throws IORuntimeException {
final String formatName = FileNameUtil.extName(targetFile);
if (StrUtil.isNotBlank(formatName)) {
this.targetImageType = formatName;
@@ -805,6 +812,7 @@ public class Img implements Flushable, Serializable {
} finally {
IoUtil.closeQuietly(out);
}
+ return this;
}
@Override
diff --git a/hutool-swing/src/main/java/org/dromara/hutool/swing/img/ImgUtil.java b/hutool-swing/src/main/java/org/dromara/hutool/swing/img/ImgUtil.java
index 74cd43c8a..1aebce731 100644
--- a/hutool-swing/src/main/java/org/dromara/hutool/swing/img/ImgUtil.java
+++ b/hutool-swing/src/main/java/org/dromara/hutool/swing/img/ImgUtil.java
@@ -34,7 +34,6 @@ import javax.imageio.stream.ImageOutputStream;
import javax.swing.ImageIcon;
import java.awt.*;
import java.awt.color.ColorSpace;
-import java.awt.font.FontRenderContext;
import java.awt.geom.AffineTransform;
import java.awt.geom.Rectangle2D;
import java.awt.image.*;
@@ -88,7 +87,13 @@ public class ImgUtil {
* @param scale 缩放比例。比例大于1时为放大，小于1大于0为缩小
*/
public static void scale(final File srcImageFile, final File destImageFile, final float scale) {
- scale(read(srcImageFile), destImageFile, scale);
+ BufferedImage image = null;
+ try {
+ image = read(srcImageFile);
+ scale(image, destImageFile, scale);
+ } finally {
+ flush(image);
+ }
}
/**
@@ -101,27 +106,39 @@ public class ImgUtil {
* @since 3.0.9
*/
public static void scale(final InputStream srcStream, final OutputStream destStream, final float scale) {
- scale(read(srcStream), destStream, scale);
+ BufferedImage image = null;
+ try {
+ image = read(srcStream);
+ scale(image, destStream, scale);
+ } finally {
+ flush(image);
+ }
}
/**
* 缩放图像（按比例缩放）
* 缩放后默认为jpeg格式，此方法并不关闭流
*
- * @param srcStream 源图像来源流
- * @param destStream 缩放后的图像写出到的流
- * @param scale 缩放比例。比例大于1时为放大，小于1大于0为缩小
+ * @param srcStream 源图像来源流
+ * @param targetStream 缩放后的图像写出到的流
+ * @param scale 缩放比例。比例大于1时为放大，小于1大于0为缩小
* @since 3.1.0
*/
- public static void scale(final ImageInputStream srcStream, final ImageOutputStream destStream, final float scale) {
- scale(read(srcStream), destStream, scale);
+ public static void scale(final ImageInputStream srcStream, final ImageOutputStream targetStream, final float scale) {
+ BufferedImage image = null;
+ try {
+ image = read(srcStream);
+ scale(image, targetStream, scale);
+ } finally {
+ flush(image);
+ }
}
/**
* 缩放图像（按比例缩放）
* 缩放后默认为jpeg格式，此方法并不关闭流
*
- * @param srcImg 源图像来源流
+ * @param srcImg 源图像来源流，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param destFile 缩放后的图像写出到的流
* @param scale 缩放比例。比例大于1时为放大，小于1大于0为缩小
* @throws IORuntimeException IO异常
@@ -135,7 +152,7 @@ public class ImgUtil {
* 缩放图像（按比例缩放）
* 缩放后默认为jpeg格式，此方法并不关闭流
*
- * @param srcImg 源图像来源流
+ * @param srcImg 源图像来源流，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param out 缩放后的图像写出到的流
* @param scale 缩放比例。比例大于1时为放大，小于1大于0为缩小
* @throws IORuntimeException IO异常
@@ -149,7 +166,7 @@ public class ImgUtil {
* 缩放图像（按比例缩放）
* 缩放后默认为jpeg格式，此方法并不关闭流
*
- * @param srcImg 源图像来源流
+ * @param srcImg 源图像来源流，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param destImageStream 缩放后的图像写出到的流
* @param scale 缩放比例。比例大于1时为放大，小于1大于0为缩小
* @throws IORuntimeException IO异常
@@ -162,7 +179,7 @@ public class ImgUtil {
/**
* 缩放图像（按比例缩放）
*
- * @param srcImg 源图像来源流
+ * @param srcImg 源图像来源流，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param scale 缩放比例。比例大于1时为放大，小于1大于0为缩小
* @return {@link Image}
* @since 3.1.0
@@ -175,7 +192,7 @@ public class ImgUtil {
* 缩放图像（按长宽缩放）
* 注意：目标长宽与原图不成比例会变形
*
- * @param srcImg 源图像来源流
+ * @param srcImg 源图像来源流，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param width 目标宽度
* @param height 目标高度
* @return {@link Image}
@@ -189,18 +206,23 @@ public class ImgUtil {
* 缩放图像（按高度和宽度缩放）
* 缩放后默认格式与源图片相同，无法识别原图片默认JPG
*
- * @param srcImageFile 源图像文件地址
- * @param destImageFile 缩放后的图像地址
- * @param width 缩放后的宽度
- * @param height 缩放后的高度
- * @param fixedColor 补充的颜色，不补充为{@code null}
+ * @param srcImageFile 源图像文件地址
+ * @param targetImageFile 缩放后的图像地址
+ * @param width 缩放后的宽度
+ * @param height 缩放后的高度
+ * @param fixedColor 补充的颜色，不补充为{@code null}
* @throws IORuntimeException IO异常
*/
- public static void scale(final File srcImageFile, final File destImageFile, final int width, final int height, final Color fixedColor) throws IORuntimeException {
- Img.from(srcImageFile)//
- .setTargetImageType(FileNameUtil.extName(destImageFile))//
- .scale(width, height, fixedColor)//
- .write(destImageFile);
+ public static void scale(final File srcImageFile, final File targetImageFile, final int width, final int height, final Color fixedColor) throws IORuntimeException {
+ Img img = null;
+ try {
+ img = Img.from(srcImageFile);
+ img.setTargetImageType(FileNameUtil.extName(targetImageFile))
+ .scale(width, height, fixedColor)//
+ .write(targetImageFile);
+ } finally {
+ IoUtil.flush(img);
+ }
}
/**
@@ -222,15 +244,21 @@ public class ImgUtil {
* 缩放图像（按高度和宽度缩放）
* 缩放后默认为jpeg格式，此方法并不关闭流
*
- * @param srcStream 源图像流
- * @param destStream 缩放后的图像目标流
- * @param width 缩放后的宽度
- * @param height 缩放后的高度
- * @param fixedColor 比例不对时补充的颜色，不补充为{@code null}
+ * @param srcStream 源图像流
+ * @param targetStream 缩放后的图像目标流
+ * @param width 缩放后的宽度
+ * @param height 缩放后的高度
+ * @param fixedColor 比例不对时补充的颜色，不补充为{@code null}
* @throws IORuntimeException IO异常
*/
- public static void scale(final ImageInputStream srcStream, final ImageOutputStream destStream, final int width, final int height, final Color fixedColor) throws IORuntimeException {
- scale(read(srcStream), destStream, width, height, fixedColor);
+ public static void scale(final ImageInputStream srcStream, final ImageOutputStream targetStream, final int width, final int height, final Color fixedColor) throws IORuntimeException {
+ BufferedImage image = null;
+ try {
+ image = read(srcStream);
+ scale(image, targetStream, width, height, fixedColor);
+ } finally {
+ flush(image);
+ }
}
/**
@@ -274,37 +302,55 @@ public class ImgUtil {
* @since 3.1.0
*/
public static void cut(final File srcImgFile, final File destImgFile, final Rectangle rectangle) {
- cut(read(srcImgFile), destImgFile, rectangle);
+ BufferedImage image = null;
+ try {
+ image = read(srcImgFile);
+ cut(image, destImgFile, rectangle);
+ } finally {
+ flush(image);
+ }
}
/**
* 图像切割(按指定起点坐标和宽高切割)，此方法并不关闭流
*
- * @param srcStream 源图像流
- * @param destStream 切片后的图像输出流
- * @param rectangle 矩形对象，表示矩形区域的x，y，width，height
+ * @param srcStream 源图像流
+ * @param targetStream 切片后的图像输出流
+ * @param rectangle 矩形对象，表示矩形区域的x，y，width，height
* @since 3.1.0
*/
- public static void cut(final InputStream srcStream, final OutputStream destStream, final Rectangle rectangle) {
- cut(read(srcStream), destStream, rectangle);
+ public static void cut(final InputStream srcStream, final OutputStream targetStream, final Rectangle rectangle) {
+ BufferedImage image = null;
+ try {
+ image = read(srcStream);
+ cut(image, targetStream, rectangle);
+ } finally {
+ flush(image);
+ }
}
/**
* 图像切割(按指定起点坐标和宽高切割)，此方法并不关闭流
*
- * @param srcStream 源图像流
- * @param destStream 切片后的图像输出流
- * @param rectangle 矩形对象，表示矩形区域的x，y，width，height
+ * @param srcStream 源图像流
+ * @param targetStream 切片后的图像输出流
+ * @param rectangle 矩形对象，表示矩形区域的x，y，width，height
* @since 3.1.0
*/
- public static void cut(final ImageInputStream srcStream, final ImageOutputStream destStream, final Rectangle rectangle) {
- cut(read(srcStream), destStream, rectangle);
+ public static void cut(final ImageInputStream srcStream, final ImageOutputStream targetStream, final Rectangle rectangle) {
+ BufferedImage image = null;
+ try {
+ image = read(srcStream);
+ cut(image, targetStream, rectangle);
+ } finally {
+ flush(image);
+ }
}
/**
* 图像切割(按指定起点坐标和宽高切割)，此方法并不关闭流
*
- * @param srcImage 源图像
+ * @param srcImage 源图像，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param destFile 输出的文件
* @param rectangle 矩形对象，表示矩形区域的x，y，width，height
* @throws IORuntimeException IO异常
@@ -330,20 +376,20 @@ public class ImgUtil {
/**
* 图像切割(按指定起点坐标和宽高切割)，此方法并不关闭流
*
- * @param srcImage 源图像
- * @param destImageStream 切片后的图像输出流
- * @param rectangle 矩形对象，表示矩形区域的x，y，width，height
+ * @param srcImage 源图像，使用结束后需手动调用{@link #flush(Image)}释放资源
+ * @param targetImageStream 切片后的图像输出流
+ * @param rectangle 矩形对象，表示矩形区域的x，y，width，height
* @throws IORuntimeException IO异常
* @since 3.1.0
*/
- public static void cut(final Image srcImage, final ImageOutputStream destImageStream, final Rectangle rectangle) throws IORuntimeException {
- writeJpg(cut(srcImage, rectangle), destImageStream);
+ public static void cut(final Image srcImage, final ImageOutputStream targetImageStream, final Rectangle rectangle) throws IORuntimeException {
+ writeJpg(cut(srcImage, rectangle), targetImageStream);
}
/**
* 图像切割(按指定起点坐标和宽高切割)
*
- * @param srcImage 源图像
+ * @param srcImage 源图像，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param rectangle 矩形对象，表示矩形区域的x，y，width，height
* @return {@link BufferedImage}
* @since 3.1.0
@@ -355,7 +401,7 @@ public class ImgUtil {
/**
* 图像切割(按指定起点坐标和宽高切割)，填充满整个图片（直径取长宽最小值）
*
- * @param srcImage 源图像
+ * @param srcImage 源图像，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param x 原图的x坐标起始位置
* @param y 原图的y坐标起始位置
* @return {@link Image}
@@ -368,7 +414,7 @@ public class ImgUtil {
/**
* 图像切割(按指定起点坐标和宽高切割)
*
- * @param srcImage 源图像
+ * @param srcImage 源图像，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param x 原图的x坐标起始位置
* @param y 原图的y坐标起始位置
* @param radius 半径，小于0表示填充满整个图片（直径取长宽最小值）
@@ -384,50 +430,56 @@ public class ImgUtil {
*
* @param srcImageFile 源图像
* @param descDir 切片目标文件夹
- * @param destWidth 目标切片宽度。默认200
- * @param destHeight 目标切片高度。默认150
+ * @param targetWidth 目标切片宽度。默认200
+ * @param targetHeight 目标切片高度。默认150
*/
- public static void slice(final File srcImageFile, final File descDir, final int destWidth, final int destHeight) {
- slice(read(srcImageFile), descDir, destWidth, destHeight);
+ public static void slice(final File srcImageFile, final File descDir, final int targetWidth, final int targetHeight) {
+ BufferedImage image = null;
+ try {
+ image = read(srcImageFile);
+ slice(image, descDir, targetWidth, targetHeight);
+ } finally {
+ flush(image);
+ }
}
/**
* 图像切片（指定切片的宽度和高度）
*
- * @param srcImage 源图像
- * @param descDir 切片目标文件夹
- * @param destWidth 目标切片宽度。默认200
- * @param destHeight 目标切片高度。默认150
+ * @param srcImage 源图像，使用结束后需手动调用{@link #flush(Image)}释放资源
+ * @param descDir 切片目标文件夹
+ * @param targetWidth 目标切片宽度。默认200
+ * @param targetHeight 目标切片高度。默认150
*/
- public static void slice(final Image srcImage, final File descDir, int destWidth, int destHeight) {
- if (destWidth <= 0) {
- destWidth = 200; // 切片宽度
+ public static void slice(final Image srcImage, final File descDir, int targetWidth, int targetHeight) {
+ if (targetWidth <= 0) {
+ targetWidth = 200; // 切片宽度
}
- if (destHeight <= 0) {
- destHeight = 150; // 切片高度
+ if (targetHeight <= 0) {
+ targetHeight = 150; // 切片高度
}
final int srcWidth = srcImage.getWidth(null); // 源图宽度
final int srcHeight = srcImage.getHeight(null); // 源图高度
- if (srcWidth < destWidth) {
- destWidth = srcWidth;
+ if (srcWidth < targetWidth) {
+ targetWidth = srcWidth;
}
- if (srcHeight < destHeight) {
- destHeight = srcHeight;
+ if (srcHeight < targetHeight) {
+ targetHeight = srcHeight;
}
final int cols; // 切片横向数量
final int rows; // 切片纵向数量
// 计算切片的横向和纵向数量
- if (srcWidth % destWidth == 0) {
- cols = srcWidth / destWidth;
+ if (srcWidth % targetWidth == 0) {
+ cols = srcWidth / targetWidth;
} else {
- cols = (int) Math.floor((double) srcWidth / destWidth) + 1;
+ cols = (int) Math.floor((double) srcWidth / targetWidth) + 1;
}
- if (srcHeight % destHeight == 0) {
- rows = srcHeight / destHeight;
+ if (srcHeight % targetHeight == 0) {
+ rows = srcHeight / targetHeight;
} else {
- rows = (int) Math.floor((double) srcHeight / destHeight) + 1;
+ rows = (int) Math.floor((double) srcHeight / targetHeight) + 1;
}
// 循环建立切片
Image tag;
@@ -435,7 +487,7 @@ public class ImgUtil {
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));
+ tag = cut(srcImage, new Rectangle(j * targetWidth, i * targetHeight, targetWidth, targetHeight));
// 输出为文件
write(tag, FileUtil.file(descDir, "_r" + i + "_c" + j + ".jpg"));
}
@@ -452,13 +504,19 @@ public class ImgUtil {
* @param cols 目标切片列数。默认2，必须是范围 [1, 20] 之内
*/
public static void sliceByRowsAndCols(final File srcImageFile, final File targetDir, final String formatName, final int rows, final int cols) {
- sliceByRowsAndCols(read(srcImageFile), targetDir, formatName, rows, cols);
+ BufferedImage image = null;
+ try {
+ image = read(srcImageFile);
+ sliceByRowsAndCols(image, targetDir, formatName, rows, cols);
+ } finally {
+ flush(image);
+ }
}
/**
* 图像切割（指定切片的行数和列数），默认RGB模式
*
- * @param srcImage 源图像，如果非{@link BufferedImage}，则默认使用RGB模式
+ * @param srcImage 源图像，如果非{@link BufferedImage}，则默认使用RGB模式，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param destDir 切片目标文件夹
* @param formatName 格式名称，即图片格式后缀
* @param rows 目标切片行数。默认2，必须是范围 [1, 20] 之内
@@ -517,7 +575,13 @@ public class ImgUtil {
FileUtil.copy(srcImageFile, targetImageFile, true);
}
- Img.from(srcImageFile).write(targetImageFile);
+ Img img = null;
+ try {
+ img = Img.from(srcImageFile);
+ img.write(targetImageFile);
+ } finally {
+ IoUtil.flush(img);
+ }
}
/**
@@ -530,14 +594,20 @@ public class ImgUtil {
* @since 3.0.9
*/
public static void convert(final InputStream srcStream, final String formatName, final OutputStream targetStream) {
- write(read(srcStream), formatName, getImageOutputStream(targetStream));
+ BufferedImage image = null;
+ try {
+ image = read(srcStream);
+ write(image, formatName, getImageOutputStream(targetStream));
+ } finally {
+ flush(image);
+ }
}
/**
* 图像类型转换：GIF=》JPG、GIF=》PNG、PNG=》JPG、PNG=》GIF(X)、BMP=》PNG
* 此方法并不关闭流
*
- * @param srcImage 源图像流
+ * @param srcImage 源图像流，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param formatName 包含格式非正式名称的 String：如JPG、JPEG、GIF等
* @param targetImageStream 目标图像输出流
* @since 4.1.14
@@ -552,41 +622,59 @@ public class ImgUtil {
/**
* 彩色转为黑白
*
- * @param srcImageFile 源图像地址
- * @param destImageFile 目标图像地址
+ * @param srcImageFile 源图像地址
+ * @param targetImageFile 目标图像地址
*/
- public static void gray(final File srcImageFile, final File destImageFile) {
- gray(read(srcImageFile), destImageFile);
+ public static void gray(final File srcImageFile, final File targetImageFile) {
+ BufferedImage image = null;
+ try {
+ image = read(srcImageFile);
+ gray(image, targetImageFile);
+ } finally {
+ flush(image);
+ }
}
/**
* 彩色转为黑白
* 此方法并不关闭流
*
- * @param srcStream 源图像流
- * @param destStream 目标图像流
+ * @param srcStream 源图像流
+ * @param targetStream 目标图像流
* @since 3.0.9
*/
- public static void gray(final InputStream srcStream, final OutputStream destStream) {
- gray(read(srcStream), getImageOutputStream(destStream));
+ public static void gray(final InputStream srcStream, final OutputStream targetStream) {
+ BufferedImage image = null;
+ try {
+ image = read(srcStream);
+ gray(image, targetStream);
+ } finally {
+ flush(image);
+ }
}
/**
* 彩色转为黑白
* 此方法并不关闭流
*
- * @param srcStream 源图像流
- * @param destStream 目标图像流
+ * @param srcStream 源图像流
+ * @param targetStream 目标图像流
* @since 3.0.9
*/
- public static void gray(final ImageInputStream srcStream, final ImageOutputStream destStream) {
- gray(read(srcStream), destStream);
+ public static void gray(final ImageInputStream srcStream, final ImageOutputStream targetStream) {
+ BufferedImage image = null;
+ try {
+ image = read(srcStream);
+ gray(image, targetStream);
+ } finally {
+ flush(image);
+ }
}
/**
* 彩色转为黑白
*
- * @param srcImage 源图像流
+ * @param srcImage 源图像流，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param outFile 目标文件
* @since 3.2.2
*/
@@ -598,7 +686,7 @@ public class ImgUtil {
* 彩色转为黑白
* 此方法并不关闭流
*
- * @param srcImage 源图像流
+ * @param srcImage 源图像流，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param out 目标图像流
* @since 3.2.2
*/
@@ -610,19 +698,19 @@ public class ImgUtil {
* 彩色转为黑白
* 此方法并不关闭流
*
- * @param srcImage 源图像流
- * @param destImageStream 目标图像流
+ * @param srcImage 源图像流，使用结束后需手动调用{@link #flush(Image)}释放资源
+ * @param targetImageStream 目标图像流
* @throws IORuntimeException IO异常
* @since 3.0.9
*/
- public static void gray(final Image srcImage, final ImageOutputStream destImageStream) throws IORuntimeException {
- writeJpg(gray(srcImage), destImageStream);
+ public static void gray(final Image srcImage, final ImageOutputStream targetImageStream) throws IORuntimeException {
+ writeJpg(gray(srcImage), targetImageStream);
}
/**
* 彩色转为黑白
*
- * @param srcImage 源图像流
+ * @param srcImage 源图像流，使用结束后需手动调用{@link #flush(Image)}释放资源
* @return {@link Image}灰度后的图片
* @since 3.1.0
*/
@@ -636,11 +724,17 @@ public class ImgUtil {
/**
* 彩色转为黑白二值化图片，根据目标文件扩展名确定转换后的格式
*
- * @param srcImageFile 源图像地址
- * @param destImageFile 目标图像地址
+ * @param srcImageFile 源图像地址
+ * @param targetImageFile 目标图像地址
*/
- public static void binary(final File srcImageFile, final File destImageFile) {
- binary(read(srcImageFile), destImageFile);
+ public static void binary(final File srcImageFile, final File targetImageFile) {
+ BufferedImage image = null;
+ try {
+ image = read(srcImageFile);
+ binary(image, targetImageFile);
+ } finally {
+ flush(image);
+ }
}
/**
@@ -653,26 +747,38 @@ public class ImgUtil {
* @since 4.0.5
*/
public static void binary(final InputStream srcStream, final OutputStream destStream, final String imageType) {
- binary(read(srcStream), getImageOutputStream(destStream), imageType);
+ BufferedImage image = null;
+ try {
+ image = read(srcStream);
+ binary(image, getImageOutputStream(destStream), imageType);
+ } finally {
+ flush(image);
+ }
}
/**
* 彩色转为黑白黑白二值化图片
* 此方法并不关闭流
*
- * @param srcStream 源图像流
- * @param destStream 目标图像流
- * @param imageType 图片格式(扩展名)
+ * @param srcStream 源图像流
+ * @param targetStream 目标图像流
+ * @param imageType 图片格式(扩展名)
* @since 4.0.5
*/
- public static void binary(final ImageInputStream srcStream, final ImageOutputStream destStream, final String imageType) {
- binary(read(srcStream), destStream, imageType);
+ public static void binary(final ImageInputStream srcStream, final ImageOutputStream targetStream, final String imageType) {
+ BufferedImage image = null;
+ try {
+ image = read(srcStream);
+ binary(image, targetStream, imageType);
+ } finally {
+ flush(image);
+ }
}
/**
* 彩色转为黑白二值化图片，根据目标文件扩展名确定转换后的格式
*
- * @param srcImage 源图像流
+ * @param srcImage 源图像流，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param outFile 目标文件
* @since 4.0.5
*/
@@ -684,7 +790,7 @@ public class ImgUtil {
* 彩色转为黑白二值化图片
* 此方法并不关闭流，输出JPG格式
*
- * @param srcImage 源图像流
+ * @param srcImage 源图像流，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param out 目标图像流
* @param imageType 图片格式(扩展名)
* @since 4.0.5
@@ -697,20 +803,20 @@ public class ImgUtil {
* 彩色转为黑白二值化图片
* 此方法并不关闭流，输出JPG格式
*
- * @param srcImage 源图像流
- * @param destImageStream 目标图像流
- * @param imageType 图片格式(扩展名)
+ * @param srcImage 源图像流，使用结束后需手动调用{@link #flush(Image)}释放资源
+ * @param targetImageStream 目标图像流
+ * @param imageType 图片格式(扩展名)
* @throws IORuntimeException IO异常
* @since 4.0.5
*/
- public static void binary(final Image srcImage, final ImageOutputStream destImageStream, final String imageType) throws IORuntimeException {
- write(binary(srcImage), imageType, destImageStream);
+ public static void binary(final Image srcImage, final ImageOutputStream targetImageStream, final String imageType) throws IORuntimeException {
+ write(binary(srcImage), imageType, targetImageStream);
}
/**
* 彩色转为黑白二值化图片
*
- * @param srcImage 源图像流
+ * @param srcImage 源图像流，使用结束后需手动调用{@link #flush(Image)}释放资源
* @return {@link Image}二值化后的图片
* @since 4.0.5
*/
@@ -724,45 +830,57 @@ public class ImgUtil {
/**
* 给图片添加文字水印
*
- * @param imageFile 源图像文件
- * @param destFile 目标图像文件
- * @param pressText 水印文字
+ * @param imageFile 源图像文件
+ * @param targetFile 目标图像文件
+ * @param pressText 水印文字
*/
- public static void pressText(final File imageFile, final File destFile, final DisplayText pressText) {
- pressText(read(imageFile), destFile, pressText);
+ public static void pressText(final File imageFile, final File targetFile, final DisplayText pressText) {
+ BufferedImage image = null;
+ try {
+ image = read(imageFile);
+ pressText(image, targetFile, pressText);
+ } finally {
+ flush(image);
+ }
}
/**
* 给图片添加文字水印
* 此方法并不关闭流
*
- * @param srcStream 源图像流
- * @param destStream 目标图像流
- * @param pressText 水印文本信息
+ * @param srcStream 源图像流
+ * @param targetStream 目标图像流
+ * @param pressText 水印文本信息
*/
- public static void pressText(final InputStream srcStream, final OutputStream destStream, final DisplayText pressText) {
- pressText(read(srcStream), getImageOutputStream(destStream), pressText);
+ public static void pressText(final InputStream srcStream, final OutputStream targetStream, final DisplayText pressText) {
+ BufferedImage image = null;
+ try {
+ image = read(srcStream);
+ pressText(image, getImageOutputStream(targetStream), pressText);
+ } finally {
+ flush(image);
+ }
}
/**
* 给图片添加文字水印
* 此方法并不关闭流
*
- * @param srcImage 源图像
- * @param destFile 目标流
- * @param pressText 水印文字信息
+ * @param srcImage 源图像，使用结束后需手动调用{@link #flush(Image)}释放资源
+ * @param targetFile 目标流
+ * @param pressText 水印文字信息
* @throws IORuntimeException IO异常
* @since 3.2.2
*/
- public static void pressText(final Image srcImage, final File destFile, final DisplayText pressText) throws IORuntimeException {
- write(pressText(srcImage, pressText), destFile);
+ public static void pressText(final Image srcImage, final File targetFile, final DisplayText pressText) throws IORuntimeException {
+ write(pressText(srcImage, pressText), targetFile);
}
/**
* 给图片添加文字水印
* 此方法并不关闭流
*
- * @param srcImage 源图像
+ * @param srcImage 源图像，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param to 目标流
* @param pressText 水印文字信息
* @throws IORuntimeException IO异常
@@ -776,20 +894,20 @@ public class ImgUtil {
* 给图片添加文字水印
* 此方法并不关闭流
*
- * @param srcImage 源图像
- * @param destImageStream 目标图像流
- * @param pressText 水印文字信息
+ * @param srcImage 源图像，使用结束后需手动调用{@link #flush(Image)}释放资源
+ * @param targetImageStream 目标图像流
+ * @param pressText 水印文字信息
* @throws IORuntimeException IO异常
*/
- public static void pressText(final Image srcImage, final ImageOutputStream destImageStream, final DisplayText pressText) throws IORuntimeException {
- writeJpg(pressText(srcImage, pressText), destImageStream);
+ public static void pressText(final Image srcImage, final ImageOutputStream targetImageStream, final DisplayText pressText) throws IORuntimeException {
+ writeJpg(pressText(srcImage, pressText), targetImageStream);
}
/**
* 给图片添加文字水印
* 此方法并不关闭流
*
- * @param srcImage 源图像
+ * @param srcImage 源图像，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param pressText 水印文字信息
* @return 处理后的图像
* @since 3.2.2
@@ -802,7 +920,7 @@ public class ImgUtil {
* 给图片添加全屏文字水印
* 此方法并不关闭流
*
- * @param srcImage 源图像
+ * @param srcImage 源图像，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param pressText 水印文字
* @param color 水印的字体颜色
* @param font {@link Font} 字体相关信息，如果默认则为{@code null}
@@ -819,37 +937,49 @@ public class ImgUtil {
/**
* 给图片添加图片水印
*
- * @param srcImageFile 源图像文件
- * @param destImageFile 目标图像文件
- * @param pressImg 水印图片
- * @param x 修正值。 默认在中间，偏移量相对于中间偏移
- * @param y 修正值。 默认在中间，偏移量相对于中间偏移
- * @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
+ * @param srcImageFile 源图像文件
+ * @param targetImageFile 目标图像文件
+ * @param pressImg 水印图片，使用结束后需手动调用{@link #flush(Image)}释放资源
+ * @param x 修正值。 默认在中间，偏移量相对于中间偏移
+ * @param y 修正值。 默认在中间，偏移量相对于中间偏移
+ * @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
*/
- public static void pressImage(final File srcImageFile, final File destImageFile, final Image pressImg, final int x, final int y, final float alpha) {
- pressImage(read(srcImageFile), destImageFile, pressImg, x, y, alpha);
+ public static void pressImage(final File srcImageFile, final File targetImageFile, final Image pressImg, final int x, final int y, final float alpha) {
+ BufferedImage image = null;
+ try {
+ image = read(srcImageFile);
+ pressImage(image, targetImageFile, pressImg, x, y, alpha);
+ } finally {
+ flush(image);
+ }
}
/**
* 给图片添加图片水印
* 此方法并不关闭流
*
- * @param srcStream 源图像流
- * @param destStream 目标图像流
- * @param pressImg 水印图片，可以使用{@link ImageIO#read(File)}方法读取文件
- * @param x 修正值。 默认在中间，偏移量相对于中间偏移
- * @param y 修正值。 默认在中间，偏移量相对于中间偏移
- * @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
+ * @param srcStream 源图像流
+ * @param targetStream 目标图像流
+ * @param pressImg 水印图片，可以使用{@link ImageIO#read(File)}方法读取文件
+ * @param x 修正值。 默认在中间，偏移量相对于中间偏移
+ * @param y 修正值。 默认在中间，偏移量相对于中间偏移
+ * @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
*/
- public static void pressImage(final InputStream srcStream, final OutputStream destStream, final Image pressImg, final int x, final int y, final float alpha) {
- pressImage(read(srcStream), getImageOutputStream(destStream), pressImg, x, y, alpha);
+ public static void pressImage(final InputStream srcStream, final OutputStream targetStream, final Image pressImg, final int x, final int y, final float alpha) {
+ BufferedImage image = null;
+ try {
+ image = read(srcStream);
+ pressImage(image, getImageOutputStream(targetStream), pressImg, x, y, alpha);
+ } finally {
+ flush(image);
+ }
}
/**
* 给图片添加图片水印
* 此方法并不关闭流
*
- * @param srcImage 源图像流
+ * @param srcImage 源图像流，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param outFile 写出文件
* @param pressImg 水印图片，可以使用{@link ImageIO#read(File)}方法读取文件
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
@@ -863,10 +993,10 @@ public class ImgUtil {
}
/**
- * 给图片添加图片水印
+ * 给图片添加图片水印，写出目标图片格式为JPG
* 此方法并不关闭流
*
- * @param srcImage 源图像流
+ * @param srcImage 源图像流，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param out 目标图像流
* @param pressImg 水印图片，可以使用{@link ImageIO#read(File)}方法读取文件
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
@@ -880,26 +1010,26 @@ public class ImgUtil {
}
/**
- * 给图片添加图片水印
+ * 给图片添加图片水印，写出目标图片格式为JPG
* 此方法并不关闭流
*
- * @param srcImage 源图像流
- * @param destImageStream 目标图像流
- * @param pressImg 水印图片，可以使用{@link ImageIO#read(File)}方法读取文件
- * @param x 修正值。 默认在中间，偏移量相对于中间偏移
- * @param y 修正值。 默认在中间，偏移量相对于中间偏移
- * @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
+ * @param srcImage 源图像流，使用结束后需手动调用{@link #flush(Image)}释放资源
+ * @param targetImageStream 目标图像流
+ * @param pressImg 水印图片，可以使用{@link ImageIO#read(File)}方法读取文件
+ * @param x 修正值。 默认在中间，偏移量相对于中间偏移
+ * @param y 修正值。 默认在中间，偏移量相对于中间偏移
+ * @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
* @throws IORuntimeException IO异常
*/
- public static void pressImage(final Image srcImage, final ImageOutputStream destImageStream, final Image pressImg, final int x, final int y, final float alpha) throws IORuntimeException {
- writeJpg(pressImage(srcImage, pressImg, x, y, alpha), destImageStream);
+ public static void pressImage(final Image srcImage, final ImageOutputStream targetImageStream, final Image pressImg, final int x, final int y, final float alpha) throws IORuntimeException {
+ writeJpg(pressImage(srcImage, pressImg, x, y, alpha), targetImageStream);
}
/**
* 给图片添加图片水印
* 此方法并不关闭流
*
- * @param srcImage 源图像流
+ * @param srcImage 源图像流，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param pressImg 水印图片，可以使用{@link ImageIO#read(File)}方法读取文件
* @param x 修正值。 默认在中间，偏移量相对于中间偏移
* @param y 修正值。 默认在中间，偏移量相对于中间偏移
@@ -914,7 +1044,7 @@ public class ImgUtil {
* 给图片添加图片水印
* 此方法并不关闭流
*
- * @param srcImage 源图像流
+ * @param srcImage 源图像流，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param pressImg 水印图片，可以使用{@link ImageIO#read(File)}方法读取文件
* @param rectangle 矩形对象，表示矩形区域的x，y，width，height，x,y从背景图片中心计算
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
@@ -926,44 +1056,56 @@ public class ImgUtil {
}
/**
- * 给图片添加全屏图片水印
+ * 给图片添加全屏图片水印
*
* @param imageFile 源图像文件
- * @param destFile 目标图像文件
+ * @param targetFile 目标图像文件
* @param pressImageFile 水印图像文件
* @param lineHeight 行高
* @param degree 水印图像旋转角度，（单位：弧度），以圆点（0,0）为圆心，正代表顺时针，负代表逆时针
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
* @throws IORuntimeException IO异常
*/
- public static void pressImageFull(final File imageFile, final File destFile, final File pressImageFile,
+ public static void pressImageFull(final File imageFile, final File targetFile, final File pressImageFile,
final int lineHeight, final int degree, final float alpha) throws IORuntimeException {
- write(pressImageFull(read(imageFile), read(pressImageFile), lineHeight, degree, alpha), destFile);
+ BufferedImage image = null;
+ try {
+ image = read(imageFile);
+ write(pressImageFull(image, read(pressImageFile), lineHeight, degree, alpha), targetFile);
+ } finally {
+ flush(image);
+ }
}
/**
- * 给图片添加全屏图像水印
+ * 给图片添加全屏图像水印，写出格式为JPG
* 此方法并不关闭流
*
- * @param srcStream 源图像流
- * @param destStream 目标图像流
- * @param pressStream 水印图像流
- * @param lineHeight 行高
- * @param degree 水印图像旋转角度，（单位：弧度），以圆点（0,0）为圆心，正代表顺时针，负代表逆时针
- * @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
+ * @param srcStream 源图像流
+ * @param targetStream 目标图像流
+ * @param pressStream 水印图像流
+ * @param lineHeight 行高
+ * @param degree 水印图像旋转角度，（单位：弧度），以圆点（0,0）为圆心，正代表顺时针，负代表逆时针
+ * @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
* @throws IORuntimeException IO异常
*/
- public static void pressImageFull(final InputStream srcStream, final OutputStream destStream,
+ public static void pressImageFull(final InputStream srcStream, final OutputStream targetStream,
final InputStream pressStream, final int lineHeight, final int degree, final float alpha) throws IORuntimeException {
- writeJpg(pressImageFull(read(srcStream), read(pressStream), lineHeight, degree, alpha), destStream);
+ BufferedImage image = null;
+ try {
+ image = read(srcStream);
+ writeJpg(pressImageFull(image, read(pressStream), lineHeight, degree, alpha), targetStream);
+ } finally {
+ flush(image);
+ }
}
/**
* 给图片添加全屏图像水印
* 此方法并不关闭流
*
- * @param srcImage 源图像
- * @param pressImage 水印图像
+ * @param srcImage 源图像，使用结束后需手动调用{@link #flush(Image)}释放资源
+ * @param pressImage 水印图像，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param lineHeight 行高
* @param degree 水印图像旋转角度，（单位：弧度），以圆点（0,0）为圆心，正代表顺时针，负代表逆时针，（单位：弧度），以圆点（0,0）为圆心，正代表顺时针，负代表逆时针
* @param alpha 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字
@@ -987,14 +1129,20 @@ public class ImgUtil {
* @since 3.2.2
*/
public static void rotate(final File imageFile, final int degree, final File outFile) throws IORuntimeException {
- rotate(read(imageFile), degree, outFile);
+ BufferedImage image = null;
+ try {
+ image = read(imageFile);
+ rotate(image, degree, outFile);
+ } finally {
+ flush(image);
+ }
}
/**
* 旋转图片为指定角度
* 此方法不会关闭输出流
*
- * @param image 目标图像
+ * @param image 需要旋转的图像，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param degree 旋转角度
* @param outFile 输出文件
* @throws IORuntimeException IO异常
@@ -1008,7 +1156,7 @@ public class ImgUtil {
* 旋转图片为指定角度
* 此方法不会关闭输出流
*
- * @param image 目标图像
+ * @param image 需要旋转的图像，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param degree 旋转角度
* @param out 输出流
* @throws IORuntimeException IO异常
@@ -1022,7 +1170,7 @@ public class ImgUtil {
* 旋转图片为指定角度
* 此方法不会关闭输出流，输出格式为JPG
*
- * @param image 目标图像
+ * @param image 需要旋转的图像，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param degree 旋转角度
* @param out 输出图像流
* @throws IORuntimeException IO异常
@@ -1036,7 +1184,7 @@ public class ImgUtil {
* 旋转图片为指定角度
* 来自：http://blog.51cto.com/cping1982/130066
*
- * @param image 目标图像
+ * @param image 需要旋转的图像，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param degree 旋转角度
* @return 旋转后的图片
* @since 3.2.2
@@ -1057,13 +1205,19 @@ public class ImgUtil {
* @since 3.2.2
*/
public static void flip(final File imageFile, final File outFile) throws IORuntimeException {
- flip(read(imageFile), outFile);
+ BufferedImage image = null;
+ try {
+ image = read(imageFile);
+ flip(image, outFile);
+ } finally {
+ flush(image);
+ }
}
/**
* 水平翻转图像
*
- * @param image 图像
+ * @param image 图像，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param outFile 输出文件
* @throws IORuntimeException IO异常
* @since 3.2.2
@@ -1075,7 +1229,7 @@ public class ImgUtil {
/**
* 水平翻转图像
*
- * @param image 图像
+ * @param image 图像，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param out 输出
* @throws IORuntimeException IO异常
* @since 3.2.2
@@ -1087,7 +1241,7 @@ public class ImgUtil {
/**
* 水平翻转图像，写出格式为JPG
*
- * @param image 图像
+ * @param image 图像，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param out 输出
* @throws IORuntimeException IO异常
* @since 3.2.2
@@ -1099,7 +1253,7 @@ public class ImgUtil {
/**
* 水平翻转图像
*
- * @param image 图像
+ * @param image 图像，使用结束后需手动调用{@link #flush(Image)}释放资源
* @return 翻转后的图片
* @since 3.2.2
*/
@@ -1120,7 +1274,13 @@ public class ImgUtil {
* @since 4.3.2
*/
public static void compress(final File imageFile, final File outFile, final float quality) throws IORuntimeException {
- Img.from(imageFile).setQuality(quality).write(outFile);
+ Img img = null;
+ try {
+ img = Img.from(imageFile);
+ img.setQuality(quality).write(outFile);
+ } finally {
+ IoUtil.flush(img);
+ }
}
// endregion
@@ -1230,6 +1390,8 @@ public class ImgUtil {
}
// endregion
+ // region ----- copyImage
+
/**
* 将已有Image复制新的一份出来
*
@@ -1285,13 +1447,21 @@ public class ImgUtil {
img.getWidth(null),
img.getHeight(null),
imageType);
+
final Graphics2D bGr = GraphicsUtil.createGraphics(bImage, backgroundColor);
- bGr.drawImage(img, 0, 0, null);
- bGr.dispose();
+ try {
+ GraphicsUtil.drawImg(bGr, img, new Point());
+ } finally {
+ bGr.dispose();
+ }
return bImage;
}
+ // endregion
+
+ // region ----- toXXX
+
/**
* 将Base64编码的图像信息转为 {@link BufferedImage}
*
@@ -1366,6 +1536,8 @@ public class ImgUtil {
return out.toByteArrayZeroCopyIfPossible();
}
+ // endregion
+
// region ----- createImage
/**
@@ -1373,7 +1545,7 @@ public class ImgUtil {
*
* @param width 宽度
* @param height 高度
- * @param transparency 透明模式，见 {@link java.awt.Transparency}
+ * @param transparency 透明模式，见 {@link Transparency}
* @return {@link BufferedImage}
* @since 5.7.13
*/
@@ -1394,7 +1566,13 @@ public class ImgUtil {
* @throws IORuntimeException IO异常
*/
public static void createTransparentImage(final String str, final Font font, final Color fontColor, final ImageOutputStream out) throws IORuntimeException {
- writePng(createImage(str, font, null, fontColor, BufferedImage.TYPE_INT_ARGB), out);
+ BufferedImage image = null;
+ try {
+ image = createImage(str, font, null, fontColor, BufferedImage.TYPE_INT_ARGB);
+ writePng(image, out);
+ } finally {
+ flush(image);
+ }
}
/**
@@ -1408,7 +1586,13 @@ public class ImgUtil {
* @throws IORuntimeException IO异常
*/
public static void createImage(final String str, final Font font, final Color backgroundColor, final Color fontColor, final ImageOutputStream out) throws IORuntimeException {
- writePng(createImage(str, font, backgroundColor, fontColor, BufferedImage.TYPE_INT_ARGB), out);
+ BufferedImage image = null;
+ try {
+ image = createImage(str, font, backgroundColor, fontColor, BufferedImage.TYPE_INT_ARGB);
+ writePng(image, out);
+ } finally {
+ flush(image);
+ }
}
/**
@@ -1424,7 +1608,7 @@ public class ImgUtil {
*/
public static BufferedImage createImage(final String str, final Font font, final Color backgroundColor, final Color fontColor, final int imageType) throws IORuntimeException {
// 获取font的样式应用在str上的整个矩形
- final Rectangle2D r = getRectangle(str, font);
+ final Rectangle2D r = FontUtil.getRectangle(str, font);
// 获取单个字符的高度
final int unitHeight = (int) Math.floor(r.getHeight());
// 获取整个str用了font样式的宽度这里用四舍五入后+1保证宽度绝对能容纳这个字符串作为图片的宽度
@@ -1442,49 +1626,34 @@ public class ImgUtil {
}
// endregion
- /**
- * 获取font的样式应用在str上的整个矩形
- *
- * @param str 字符串，必须非空
- * @param font 字体，必须非空
- * @return {@link Rectangle2D}
- * @since 5.3.3
- */
- public static Rectangle2D getRectangle(final String str, final Font font) {
- return font.getStringBounds(str,
- new FontRenderContext(AffineTransform.getScaleInstance(1, 1),
- false,
- false));
- }
-
// region ----- write
/**
* 写出图像为JPG格式
*
- * @param image {@link Image}
- * @param destImageStream 写出到的目标流
+ * @param image {@link Image}
+ * @param targetImageStream 写出到的目标流
* @throws IORuntimeException IO异常
*/
- public static void writeJpg(final Image image, final ImageOutputStream destImageStream) throws IORuntimeException {
- write(image, IMAGE_TYPE_JPG, destImageStream);
+ public static void writeJpg(final Image image, final ImageOutputStream targetImageStream) throws IORuntimeException {
+ write(image, IMAGE_TYPE_JPG, targetImageStream);
}
/**
* 写出图像为PNG格式
*
- * @param image {@link Image}
- * @param destImageStream 写出到的目标流
+ * @param image {@link Image}，使用结束后需手动调用{@link #flush(Image)}释放资源
+ * @param targetImageStream 写出到的目标流
* @throws IORuntimeException IO异常
*/
- public static void writePng(final Image image, final ImageOutputStream destImageStream) throws IORuntimeException {
- write(image, IMAGE_TYPE_PNG, destImageStream);
+ public static void writePng(final Image image, final ImageOutputStream targetImageStream) throws IORuntimeException {
+ write(image, IMAGE_TYPE_PNG, targetImageStream);
}
/**
* 写出图像为JPG格式
*
- * @param image {@link Image}
+ * @param image {@link Image}，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param out 写出到的目标流
* @throws IORuntimeException IO异常
* @since 4.0.10
@@ -1496,7 +1665,7 @@ public class ImgUtil {
/**
* 写出图像为PNG格式
*
- * @param image {@link Image}
+ * @param image {@link Image}，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param out 写出到的目标流
* @throws IORuntimeException IO异常
* @since 4.0.10
@@ -1509,20 +1678,26 @@ public class ImgUtil {
* 按照目标格式写出图像：GIF=》JPG、GIF=》PNG、PNG=》JPG、PNG=》GIF(X)、BMP=》PNG
* 此方法并不关闭流
*
- * @param srcStream 源图像流
- * @param formatName 包含格式非正式名称的 String：如JPG、JPEG、GIF等
- * @param destStream 目标图像输出流
+ * @param srcStream 源图像流
+ * @param formatName 包含格式非正式名称的 String：如JPG、JPEG、GIF等
+ * @param targetStream 目标图像输出流
* @since 5.0.0
*/
- public static void write(final ImageInputStream srcStream, final String formatName, final ImageOutputStream destStream) {
- write(read(srcStream), formatName, destStream);
+ public static void write(final ImageInputStream srcStream, final String formatName, final ImageOutputStream targetStream) {
+ BufferedImage image = null;
+ try {
+ image = read(srcStream);
+ write(image, formatName, targetStream);
+ } finally {
+ flush(image);
+ }
}
/**
* 写出图像：GIF=》JPG、GIF=》PNG、PNG=》JPG、PNG=》GIF(X)、BMP=》PNG
* 此方法并不关闭流
*
- * @param image {@link Image}
+ * @param image {@link Image}，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param imageType 图片类型（图片扩展名）
* @param out 写出到的目标流
* @throws IORuntimeException IO异常
@@ -1535,22 +1710,21 @@ public class ImgUtil {
/**
* 写出图像为目标文件扩展名对应的格式
*
- * @param image {@link Image}
+ * @param image {@link Image}，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param targetFile 目标文件
* @throws IORuntimeException IO异常
* @since 3.1.0
*/
public static void write(final Image image, final File targetFile) throws IORuntimeException {
- final String imageType = FileNameUtil.extName(targetFile);
- ImgWriter.of(image, imageType).write(targetFile);
+ ImgWriter.of(image, FileNameUtil.extName(targetFile)).write(targetFile);
}
/**
* 写出图像为指定格式：GIF=》JPG、GIF=》PNG、PNG=》JPG、PNG=》GIF(X)、BMP=》PNG
* 此方法并不关闭流
*
- * @param image {@link Image}
- * @param imageType 图片类型（图片扩展名）
+ * @param image {@link Image}，使用结束后需手动调用{@link #flush(Image)}释放资源
+ * @param imageType 图片类型（图片扩展名）
* @param targetImageStream 写出到的目标流
* @throws IORuntimeException IO异常
* @since 3.1.2
@@ -1562,7 +1736,7 @@ public class ImgUtil {
/**
* 写出图像为指定格式
*
- * @param image {@link Image}
+ * @param image {@link Image}，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param imageType 图片类型（图片扩展名），{@code null}表示使用RGB模式（JPG）
* @param out 写出到的目标流
* @param quality 质量，数字为0~1（不包括0和1）表示质量压缩比，除此数字外设置表示不压缩
@@ -1579,7 +1753,7 @@ public class ImgUtil {
/**
* 通过{@link ImageWriter}写出图片到输出流
*
- * @param image 图片
+ * @param image 图片，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param imageType 图片类型
* @param output 输出的Image流{@link ImageOutputStream}
* @param quality 质量，数字为0~1（不包括0和1）表示质量压缩比，除此数字外设置表示不压缩
@@ -1594,7 +1768,7 @@ public class ImgUtil {
/**
* 根据给定的Image对象和格式获取对应的{@link ImageWriter}，如果未找到合适的Writer，返回null
*
- * @param img {@link Image}
+ * @param img {@link Image}，使用结束后需手动调用{@link #flush(Image)}释放资源
* @param formatName 图片格式，例如"jpg"、"png"，{@code null}则使用默认值"jpg"
* @return {@link ImageWriter}
* @since 4.3.2
@@ -1909,10 +2083,9 @@ public class ImgUtil {
* @param inputPath 要处理图片的路径
* @param outputPath 输出图片的路径
* @param tolerance 容差值[根据图片的主题色,加入容差值,值的范围在0~255之间]
- * @return 返回处理结果 true:图片处理完成 false:图片处理失败
*/
- public static boolean backgroundRemoval(final String inputPath, final String outputPath, final int tolerance) {
- return BackgroundRemoval.backgroundRemoval(inputPath, outputPath, tolerance);
+ public static void backgroundRemoval(final String inputPath, final String outputPath, final int tolerance) {
+ BackgroundRemoval.backgroundRemoval(inputPath, outputPath, tolerance);
}
/**
@@ -1927,10 +2100,9 @@ public class ImgUtil {
* @param input 需要进行操作的图片
* @param output 最后输出的文件
* @param tolerance 容差值[根据图片的主题色,加入容差值,值的取值范围在0~255之间]
- * @return 返回处理结果 true:图片处理完成 false:图片处理失败
*/
- public static boolean backgroundRemoval(final File input, final File output, final int tolerance) {
- return BackgroundRemoval.backgroundRemoval(input, output, tolerance);
+ public static void backgroundRemoval(final File input, final File output, final int tolerance) {
+ BackgroundRemoval.backgroundRemoval(input, output, tolerance);
}
/**
@@ -1946,10 +2118,9 @@ public class ImgUtil {
* @param output 最后输出的文件
* @param override 指定替换成的背景颜色 为null时背景为透明
* @param tolerance 容差值[根据图片的主题色,加入容差值,值的取值范围在0~255之间]
- * @return 返回处理结果 true:图片处理完成 false:图片处理失败
*/
- public static boolean backgroundRemoval(final File input, final File output, final Color override, final int tolerance) {
- return BackgroundRemoval.backgroundRemoval(input, output, override, tolerance);
+ public static void backgroundRemoval(final File input, final File output, final Color override, final int tolerance) {
+ BackgroundRemoval.backgroundRemoval(input, output, override, tolerance);
}
/**
diff --git a/hutool-swing/src/main/java/org/dromara/hutool/swing/img/ImgWriter.java b/hutool-swing/src/main/java/org/dromara/hutool/swing/img/ImgWriter.java
index c613d22ac..3066a60af 100644
--- a/hutool-swing/src/main/java/org/dromara/hutool/swing/img/ImgWriter.java
+++ b/hutool-swing/src/main/java/org/dromara/hutool/swing/img/ImgWriter.java
@@ -24,16 +24,18 @@ import javax.imageio.ImageWriter;
import javax.imageio.stream.ImageOutputStream;
import java.awt.Color;
import java.awt.Image;
+import java.awt.image.BufferedImage;
import java.awt.image.ColorModel;
import java.awt.image.RenderedImage;
import java.io.File;
+import java.io.Flushable;
import java.io.IOException;
import java.io.OutputStream;
/**
* 图片写出封装
*/
-public class ImgWriter {
+public class ImgWriter implements Flushable {
/**
* 创建图片写出器
@@ -138,6 +140,16 @@ public class ImgWriter {
}
}
+ @Override
+ public void flush() {
+ final RenderedImage renderedImage = this.image;
+ if(renderedImage instanceof BufferedImage){
+ ImgUtil.flush((BufferedImage) renderedImage);
+ } else if(renderedImage instanceof Image){
+ ImgUtil.flush((Image) renderedImage);
+ }
+ }
+
/**
* 构建图片写出参数
*
diff --git a/hutool-swing/src/test/java/org/dromara/hutool/swing/img/ImgTest.java b/hutool-swing/src/test/java/org/dromara/hutool/swing/img/ImgTest.java
index 9dfd060c4..0d1901610 100644
--- a/hutool-swing/src/test/java/org/dromara/hutool/swing/img/ImgTest.java
+++ b/hutool-swing/src/test/java/org/dromara/hutool/swing/img/ImgTest.java
@@ -107,6 +107,7 @@ public class ImgTest {
final Image img = ImgUtil.getImage(UrlUtil.getURL(file));
ImgUtil.scale(img, fileScale, 0.8f);
+ ImgUtil.flush(img);
}
@Test