Java图片处理工具Thumbnailator教程
最编程
2024-01-03 18:53:20
...
什么是Thumbnailator？
Thumbnailator是Google开源的优秀图片处理的第三方Java类库，比JDK自带的库要好用的多。
官网Github地址
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）。图片属性信息如下：
图片尺寸
基本说明
图片尺寸控制可以通过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");
}
}
处理完毕后图片信息如下：
可以看到确实是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");
}
}
效果如下：
通过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
效果图如下：
图片旋转
可以通过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");
}
}
图片水印
通过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");
}
}
输出结果：
输出质量
通过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")));
}
}
github：github.com/ProgramTalk…
推荐阅读
-
JAVA 基础教程］第六部分：Java 异常处理
-
ctf工具整理-持续更新-010编辑器是比较常用的，很多文件格式都可以放在010编辑器中查看是否有有效信息，比如图片格式jpg png、压缩包格式zip rar、其他文件等等。 下载链接：https://download.sweetscape.com/010EditorWin32Installer11.0.1.exe 5.4 图像隐写术查看器：stegsolve 添加前需进行 Java 配置
-
源码为您提供，零基础搭建的免费网址导航站--中国妖怪百集，收集了大量古代文献中的妖怪，非常详细的记录了妖怪的来历、描述甚至图片，让您对中国的妖怪文化有一个整体的了解，茶余饭后的消遣非常有趣，类似的网站还有很多，期待您的探索！ 导航站的另一个特点是汇集了大量咖啡平时用的非常好的工具软件，其中大部分都是在线的，不需要下载安装，包括文档协作、分享，图片、音频、视频处理，格式转换，文件传输，各个网站的视频下载等等，兼职就是一个工具百宝箱！ 如果你觉得这些网站不符合你的使用习惯，或者想添加一些自己收藏的网站，那么把源码交给你，只需简单修改就可以变成符合自己使用习惯的独特导航了！ 如何修改 导航站采用纯静态构建，下载源代码后，只需要修改 html 文件中的代码块即可，代码块结构如下： 只需要修改四个地方，分别对应网站的四个关键信息： 修改相应网站的 URL 地址 修改相应网站的徽标 修改相应网站的名称
-
JAVA 工程师 高级 JAVA 多线程下的高并发处理视频教程下载
-
使用 Thumbnailator（图像转码和缩略图生成），Java 可优雅地处理图像
-
善用 P 图片工具-AdobePhotoshopCS6 简体中文版，附安装教程，仅供学习！
-
Adobe国际认证中文官方网站】Adobe中国摄影计划，免费安装正版激活--Adobe Creative Cloud中国摄影计划。与此同时，Adobe宣布天猫为Adobe Creative Cloud中国摄影计划的电商战略合作伙伴，并将与其合作上线Adobe天猫官方旗舰店。 此举无疑一方面扩大了Adobe在中国的影响力，另一方面也有助于国内用户更好地培养正版软件意识，推动Adobe软件在中国的正版化进程。 网络异常，图片无法显示 ||网络异常 Adobe Creative Cloud中国摄影计划包括Photoshop和Lightroom Classic两大桌面创意工具，以及iOS版Photoshop Express。 其中，Adobe Lightroom Classic和Adobe Photoshop作为两款常用的图像处理软件，对于那些玩摄影、后期修图的创意设计人群无疑有着巨大的帮助，而LR+PS套装对于摄影领域用户的重要性自不必说，正版产品的性能实时更新也可以放心！体验最新功能，对于新镜头（补偿）和机身（RAW 读取）都能第一时间适应。不信你看： Photoshop 图像合成 裁剪、移除对象、润饰合成照片、玩转色彩和特效，创建精美图片和艺术品！ Lightroom Classic 照片编辑 轻松批量管理和编辑照片，内置专业创意控件和摄影师预设，让你的照片大放异彩。 手机 PS 便捷编辑 Photoshop Express 支持多种滤镜、贴纸，手机即可完成抠图、除雾等任务 人工智能编辑工具 神经滤镜、快速点击选区、自动选择主题等人工智能功能让图像编辑更轻松 创意画笔内容识别 定制艺术画笔工具，实现个性化效果；内容识别填充，智能去除无用物体。 Adobe Creative Cloud 中国摄影计划的推出，为中国的专业摄影师、摄影爱好者、后期修图和其他创意设计人员带来了全方位的内容和体验。 网络异常，图片无法显示 ||网络异常 当然，不可否认的是，"由于盗版软件缺乏开发、维护和升级成本，销售价格远低于正版软件。再加上很多普通人并不需要使用正版软件的复杂功能，版权观念较淡，还是有大量的创意设计人员会选择盗版软件"。 但事实上，当所有的软件都不再是单一的软件，而是变成一种服务时，单机版盗版的存在就逐渐成为鸡肋。因为有太多的服务让你即使是所谓的 "完美破解"，也无法享受，Adobe Cloud 就是一个很好的例子，所谓的完美破解，你只能使用 "Adobe "的一半，对于更精彩的 "云"，只能望云兴叹。更何况，越来越多的设计工具从免费走向付费，越来越多的设计师和企业已经接受了付费使用的模式。 其次，对于互联网时代的企业数字化转型而言，数字化合规至关重要。21年来，使用盗版PS和未经授权的方正字体被指侵权的事情闹得沸沸扬扬，虽然新闻真假难辨，但也给使用盗版工具的用户敲响了警钟。 付费使用正版工具，可以更放心地进行设计，不用担心版权风险！
-
深入理解并实战运用Java日志工具logback的教程
-
Java实现高清日本图片处理
-
如何在Java中使用Hutool工具处理JSON字符串的转义字符