原文链接:https://zhuanlan.zhihu.com/p/604121848
Thumbnailator是Google开源的优秀图片处理的第三方Java类库,比JDK自带的库要好用的多。
Maven依赖
目前最新版本是0.4.19
<dependency>
<groupId>net.coobird</groupId>
<artifactId>thumbnailator</artifactId>
<version>0.4.19</version>
</dependency>
图片处理步骤
Thumbnailtor
处理图片的步骤可以看我绘制的下图来说明。
主要分为三个步骤。
构建Thumbnails.Builder
要使用thumbnailtor
,主要使用Thumbnails
类,该类采用建造者模式设计,类中提供了很多返回Builder
的静态方法。
正如上图所示,Thumbnails
提供了通过字符串图片地址、File对象、URI对象等方式创建Thumbnails
对象的方式。
of方法
of方法提供了多种参数,当然参数虽然不同,功能却是相同的。并且of支持多个参数,可以同时处理多个图片,不过要特别注意,处理多个图片的时候,输出方法也要使用支持输出多个图片的方法。
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.net.URL;
public class ThumbnailsOfDemo {
public static void main(String[] args) throws IOException {
// 参数是本地文件路径,支持多参数
Thumbnails.of("input/logo.png")
.scale(1D)
.toFile("output/o1.png");
// File类型的参数,支持多参数
Thumbnails.of(new File("input/logo.png"))
.scale(1D)
.toFile("output/o2.png");
// BufferedImage类型参数
BufferedImage bufferedImage = ImageIO.read(new File("input/logo.png"));
Thumbnails.of(bufferedImage)
.scale(1D)
.toFile("output/o3.png");
// FileInputStream类型
File file = new File("input/logo.png");
FileInputStream fis = new FileInputStream(file);
Thumbnails.of(fis)
.scale(1D)
.toFile("output/o4.png");
// 网络图片
Thumbnails.of(new URL("https://programtalk-1256529903.cos.ap-beijing.myqcloud.com/202302061502561.png"))
.scale(1D)
.toFile("output/o4.png");
}
}
scale
代表缩放,toFile
是输出图片的方法,先不要管,后面会讲到。代码执行完毕后,会生成五个图片。
fromFilenames方法
Thumbnails.fromFilenames(Iterable<String> files)
方法支持接入多个图片,也就是说能处理多个图片。
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import net.coobird.thumbnailator.name.Rename;
import java.io.File;
import java.io.IOException;
import java.util.Arrays;
import java.util.List;
public class ThumbnailsFromFilenamesDemo {
/**
* 使用FromFiles处理多个图片。
*/
public static void main(String[] args) throws IOException {
// 参数是本地文件路径,支持多参数
File file = new File("input"); // input文件夹下有多个图片
File[] files = file.listFiles();
assert files != null;
List<String> filenames = Arrays.stream(files).map(File::getPath).toList();
Thumbnails.fromFilenames(filenames)
.scale(1D)
// 这里必须使用`toFiles`,因为处理的是多图
.toFiles(new File("output"), Rename.SUFFIX_HYPHEN_THUMBNAIL);
}
}
toFiles
的用法后面会讲解。
fromFiles方法
Thumbnails.fromFiles方法(Iterable<File> files)
方法支持接入多个图片,也就是说能处理多个图片。不同于fromFilenames
的是它的参数是Iterable<File>
类型。
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import net.coobird.thumbnailator.name.Rename;
import java.io.File;
import java.io.IOException;
import java.util.Arrays;
public class ThumbnailsFromFilesDemo {
/**
* 使用fromFiles处理多个图片。
*/
public static void main(String[] args) throws IOException {
File file = new File("input");
File[] files = file.listFiles();
assert files != null;
Thumbnails.fromFiles(Arrays.asList(files))
.scale(1D)
// 这里必须使用`toFiles`,因为处理的是多图
.toFiles(new File("output"), Rename.SUFFIX_HYPHEN_THUMBNAIL);
}
}
fromURLs方法
Thumbnails.fromURLs
用于批量处理网络图片。
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import java.io.File;
import java.io.IOException;
import java.net.URL;
import java.util.List;
public class ThumbnailsFromURLsDemo {
/**
* 使用fromURLs处理多个图片。
*/
public static void main(String[] args) throws IOException {
Thumbnails.fromURLs(List.of(new URL("https://programtalk-1256529903.cos.ap-beijing.myqcloud.com/202302061502561.png")
, new URL("https://itlab1024-1256529903.cos.ap-beijing.myqcloud.com/202301311404082.png")))
.scale(1D)
.toFiles(List.of(new File("output/fromURLs1.jpg"), new File("output/fromURLs2.jpg")));
}
}
fromImages方法
Thumbnails.fromImages
批量处理BufferedImage
类型的图片。
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import javax.imageio.ImageIO;
import java.io.File;
import java.io.IOException;
import java.net.URL;
import java.util.List;
public class ThumbnailsFromImagesDemo {
/**
* 使用fromImages处理多个图片。
*/
public static void main(String[] args) throws IOException {
Thumbnails.fromImages(List.of(ImageIO.read(new URL("https://programtalk-1256529903.cos.ap-beijing.myqcloud.com/202302061502561.png"))
, ImageIO.read(new URL("https://itlab1024-1256529903.cos.ap-beijing.myqcloud.com/202301311404082.png"))))
.scale(1D)
.toFiles(List.of(new File("output/fromImages1.jpg"), new File("output/fromImages2.jpg")));
}
}
fromInputStreams方法
Thumbnails.fromInputStreams
批量处理InputStream
类型的图片。
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.util.List;
public class ThumbnailsFromInputStreamsDemo {
/**
* 使用fromInputStreams处理多个图片。
*/
public static void main(String[] args) throws IOException {
Thumbnails.fromInputStreams(List.of(new FileInputStream("input/logo.png")
, new FileInputStream("input/logo.png")))
.scale(1D)
.toFiles(List.of(new File("output/fromInputStreams.jpg"), new File("output/fromInputStreams.jpg")));
}
}
图片处理
讲解图片处理前,先准备一张图片(wx.png)。图片属性信息如下:
image-20230206163350487
图片尺寸
基本说明
图片尺寸控制可以通过width
、height
,size
, forceSize
,scale
方法控制。
width
、height
,size
方法会默认保证原始图片比例(可以通过设置keepAspectRatio(false)
取消,如果取消则等价于forceSize
方法。),因为收到原始图片宽高比例的限制,即便设置了宽高可能也不会引起图片的尺寸(像素)变化(可能会导致图片大小变化)。
forceSize
则会强制保证宽高,可能会导致图片拉伸。
scale
是设置图片宽高比例,不大于1的数参数。
有以下异常情况要注意:
- 调用
width
和height
方法后不能再使用size
或者scale
方法,否则会抛出异常。 - 调用
size
方法后不能再使用scale
方法,否则会抛出异常。 - 调用
scale
方法后不能调用size
、scale
或keepAspectRatio(boolean)
方法,否则会抛出异常。
代码示例
原图是宽=1710
,高=624
,宽高比≈2.74
,那么目标的宽度是100,高度就会被计算为100 / 2.74 ≈ 36
。
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import java.io.IOException;
public class ThumbnailsSizeDemo {
public static void main(String[] args) throws IOException {
Thumbnails.of("input/wx.png")
.size(100, 100)
.toFile("output/o1.png");
}
}
处理完毕后图片信息如下:
size处理结果
可以看到确实是100X36
的分辨率。
如果想不保证宽高比例,可以使用forceSize
方法。
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import java.io.IOException;
public class ThumbnailsSizeDemo {
public static void main(String[] args) throws IOException {
Thumbnails.of("input/wx.png")
.forceSize(100, 100)
.toFile("output/o1.png");
}
}
效果如下:
forceSize
通过scale,设置宽高比例来修改尺寸。
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import java.io.IOException;
public class ThumbnailsSizeDemo {
public static void main(String[] args) throws IOException {
Thumbnails.of("input/wx.png")
.scale(0.8)
.toFile("output/o1.png");
}
}
代码中设置了scale=0.8
效果图如下:
scale
图片旋转
可以通过rotate(double angle)
,来旋转图片,参数是度,比如30代表30度。
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import java.io.IOException;
public class ThumbnailsRotateDemo {
public static void main(String[] args) throws IOException {
Thumbnails.of("input/wx.png")
.rotate(30) // 旋转30度
// 此处size必须设置
.size(100, 10)
.toFile("output/o1.png");
}
}
image-20230206175947372
图片水印
通过watermark
设置水印,有多个多态方法。
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import net.coobird.thumbnailator.geometry.Positions;
import javax.imageio.ImageIO;
import java.io.File;
import java.io.IOException;
public class ThumbnailsWatermarkDemo {
public static void main(String[] args) throws IOException {
Thumbnails.of("input/wx.png")
// 水印放到右下角
.watermark(Positions.BOTTOM_RIGHT, ImageIO.read(new File("input/watermark.png")), 0.5f)
.scale(1.74)
.toFile("output/o1.png");
}
}
输出图片
输出格式
outputFormat(String format)
方法用于设置输出文件格式。支持的格式可以通过ImageIO.getWriterFormatNames()
获取。
我这里打印的格式列表是JPG jpg tiff bmp BMP gif GIF WBMP png PNG JPEG tif TIF TIFF jpeg wbmp
。
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import javax.imageio.ImageIO;
import java.io.IOException;
public class ThumbnailsOutputFormatDemo {
public static void main(String[] args) throws IOException {
String[] writerFormatNames = ImageIO.getWriterFormatNames();
for (String writerFormatName : writerFormatNames) {
System.out.print(writerFormatName + " "); // JPG jpg tiff bmp BMP gif GIF WBMP png PNG JPEG tif TIF TIFF jpeg wbmp
}
Thumbnails.of("input/wx.png")
.scale(1.75)
// 如果不设置默认跟原图片一致
.outputFormat("JPG")
// 设置质量
.outputQuality(1F)
.toFile("output/o1");
}
}
输出结果:
outputFormat
输出质量
通过outputQuality(float quality)
设置输出质量,参数介于0和1之间,支持小数,数字越小质量越差。
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import java.io.IOException;
public class ThumbnailsOutputQualityDemo {
public static void main(String[] args) throws IOException {
Thumbnails.of("input/wx.png")
.scale(1.75)
// 设置质量
.outputQuality(1F)
.toFile("output/o1");
}
}
输出到文件
单文件
使用toFile
方法,将处理后的文件输出到指定文件,参数是文件路径,不是必须要指定文件后缀。
toFile
要求文件读入的时候必须是单个源,例如如果是Thumbnails.of("input/logo.jpg","input/logo2.jpg")
,使用toFile
输出会抛出异常。
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import javax.imageio.ImageIO;
import java.io.IOException;
public class ThumbnailsToFileDemo {
public static void main(String[] args) throws IOException {
Thumbnails.of("input/logo.jpg")
.scale(1.75)
// 默认如果文件已经存在,则不覆盖,可以设置allowOverwrite=true。
.allowOverwrite(true)
// 可以不指定文件后缀,默认是png
.toFile("output/logo-new");
}
}
默认如果文件已经存在,则不覆盖,可以设置allowOverwrite=true。
多文件
批量接入的文件处理完毕后,可以通过toFiles
输出到指定目录下。
toFiles
有三种多态方法
public void toFiles(File destinationDir, Rename rename) throws IOException // ①
public void toFiles(Rename rename) throws IOException // ②
public void toFiles(Iterable<File> iterable) throws IOException { // ③
①:第一个参数是文件夹路径,第二个参数是文件名处理类型。
NO_CHANGE
:文件名不修改。
PREFIX_DOT_THUMBNAIL
:追加 thumbnail.
到文件名的开头。例如,给定 picture.jpg
,结果为thumbnail.picture.jpg
。
SUFFIX_DOT_THUMBNAIL
:.thumbnail
追加到文件扩展名之前的文件名。例如,给定 picture.jpg
,结果为 picture.thumbnail.jpg
SUFFIX_HYPHEN_THUMBNAIL
:-thumbnail
追加到文件扩展名之前的文件名。例如,给定 picture.jpg
,结果为 picture-thumbnail.jpg
。
②:此方法是①的简化,等价于①中的第一个参数destinationDir
为空。
③:参数是Iterable
类型,也就是说可以给每个文件设置输出文件名。
代码示例如下:
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import net.coobird.thumbnailator.name.Rename;
import java.io.File;
import java.io.IOException;
import java.util.List;
public class ThumbnailsToFilesDemo {
public static void main(String[] args) throws IOException {
Thumbnails.of("input/logo.jpg", "input/logo.png")
.scale(1.75)
// 默认如果文件已经存在,则不覆盖,可以设置allowOverwrite=true。
.allowOverwrite(true)
// 可以不指定文件后缀,默认是png
//.toFiles(new File("output"), Rename.NO_CHANGE);
//.toFiles(Rename.NO_CHANGE);
.toFiles(List.of(new File("output/1"), new File("output/2")));
}
}
输出到输出流
单流
toOutputStream
是将一个文件输出到输出流中。
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStream;
public class ThumbnailsToOutputStreamDemo {
public static void main(String[] args) throws IOException {
OutputStream os = new FileOutputStream("output/logo.png");
Thumbnails.of("input/logo.jpg")
.scale(1.75)
.toOutputStream(os);
}
}
多流
toOutputStreams
是将一个文件输出到多个输出流中。
package cn.programtalk;
import net.coobird.thumbnailator.Thumbnails;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.List;
public class ThumbnailsToOutputStreamsDemo {
public static void main(String[] args) throws IOException {
Thumbnails.of("input/logo.jpg", "input/logo.png")
.scale(1.75)
// 这里文件后缀最好指定,写入到磁盘的文件没有文件后缀。
.toOutputStreams(List.of(new FileOutputStream("output/1.jpg"), new FileOutputStream("output/2.png")));
}
}
标签:java,Thumbnails,Thumbnailator,Java,IOException,import,public,png,图片
From: https://www.cnblogs.com/fswhq/p/17729487.html