Java图片处理工具Thumbnailator教程 | 您所在的位置:网站首页 › thumbnailator原理 › Java图片处理工具Thumbnailator教程 |
什么是Thumbnailator?
Thumbnailator是Google开源的优秀图片处理的第三方Java类库,比JDK自带的库要好用的多。 官网Github地址 Maven依赖目前最新版本是0.4.19 net.coobird thumbnailator 0.4.19 复制代码 图片处理步骤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 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 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 files)方法支持接入多个图片,也就是说能处理多个图片。不同于fromFilenames的是它的参数是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.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 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… |
CopyRight 2018-2019 实验室设备网 版权所有 |