Java生成缩略图之Thumbnailator

Thumbnailator 是一个为Java界面更流畅的缩略图生成库。从API提供现有的图像文件和图像对象的缩略图中简化了缩略过程，两三行代码就能够从现有图片生成缩略图，且允许微调缩略图生成，同时保持了需要写入到最低限度的代码量。同时还支持根据一个目录批量生成缩略图。

原图如下： 

1、指定大小进行缩放

1. //size(宽度, 高度)
2. /*
3. * 若图片横比200小，高比300小，不变
4. * 若图片横比200小，高比300大，高缩小到300，图片比例不变
5. * 若图片横比200大，高比300小，横缩小到200，图片比例不变
6. * 若图片横比200大，高比300大，图片按比例缩小，横为200或高为300
7. */
8. Thumbnails.of("images/a380_1280x1024.jpg")
9. .size(200, 300)
10. .toFile("c:/a380_200x300.jpg");
11. Thumbnails.of("images/a380_1280x1024.jpg")
12. .size(2560, 2048)
13. .toFile("c:/a380_2560x2048.jpg");

2、按照比例进行缩放

1. //scale(比例)
2. Thumbnails.of("images/a380_1280x1024.jpg")
3. .scale(0.25f)
4. .toFile("c:/a380_25%.jpg");
5. Thumbnails.of("images/a380_1280x1024.jpg")
6. .scale(1.10f)
7. .toFile("c:/a380_110%.jpg");

3、不按照比例，指定大小进行缩放

1. //keepAspectRatio(false) 默认是按照比例缩放的
2. Thumbnails.of("images/a380_1280x1024.jpg")
3. .size(200, 200)
4. .keepAspectRatio(false)
5. .toFile("c:/a380_200x200.jpg");

4、旋转

1. //rotate(角度),正数：顺时针 负数：逆时针
2. Thumbnails.of("images/a380_1280x1024.jpg")
3. .size(1280, 1024)
4. .rotate(90)
5. .toFile("c:/a380_rotate+90.jpg");
6. Thumbnails.of("images/a380_1280x1024.jpg")
7. .size(1280, 1024)
8. .rotate(-90)
9. .toFile("c:/a380_rotate-90.jpg");

5、水印

1. //watermark(位置，水印图，透明度)
2. Thumbnails.of("images/a380_1280x1024.jpg")
3. .size(1280, 1024)
4. .watermark(Positions.BOTTOM_RIGHT, ImageIO.read(new File("images/watermark.png")), 0.5f)
5. .outputQuality(0.8f)
6. .toFile("c:/a380_watermark_bottom_right.jpg");
7. Thumbnails.of("images/a380_1280x1024.jpg")
8. .size(1280, 1024)
9. .watermark(Positions.CENTER, ImageIO.read(new File("images/watermark.png")), 0.5f)
10. .outputQuality(0.8f)
11. .toFile("c:/a380_watermark_center.jpg");

6、裁剪

1. //sourceRegion()
2. //图片中心400*400的区域
3. Thumbnails.of("images/a380_1280x1024.jpg")
4. .sourceRegion(Positions.CENTER, 400,400)
5. .size(200, 200)
6. .keepAspectRatio(false)
7. .toFile("c:/a380_region_center.jpg");
8. //图片右下400*400的区域
9. Thumbnails.of("images/a380_1280x1024.jpg")
10. .sourceRegion(Positions.BOTTOM_RIGHT, 400,400)
11. .size(200, 200)
12. .keepAspectRatio(false)
13. .toFile("c:/a380_region_bootom_right.jpg");
14. //指定坐标
15. Thumbnails.of("images/a380_1280x1024.jpg")
16. .sourceRegion(600, 500, 400, 400)
17. .size(200, 200)
18. .keepAspectRatio(false)
19. .toFile("c:/a380_region_coord.jpg");

7、转化图像格式

1. //outputFormat(图像格式)
2. Thumbnails.of("images/a380_1280x1024.jpg")
3. .size(1280, 1024)
4. .outputFormat("png")
5. .toFile("c:/a380_1280x1024.png");
6. Thumbnails.of("images/a380_1280x1024.jpg")
7. .size(1280, 1024)
8. .outputFormat("gif")
9. .toFile("c:/a380_1280x1024.gif");

8、输出到OutputStream

1. //toOutputStream(流对象)
2. OutputStream os = new FileOutputStream("c:/a380_1280x1024_OutputStream.png");
3. Thumbnails.of("images/a380_1280x1024.jpg")
4. .size(1280, 1024)
5. .toOutputStream(os);

9、输出到BufferedImage

1. //asBufferedImage() 返回BufferedImage
2. BufferedImage thumbnail = Thumbnails.of("images/a380_1280x1024.jpg")
3. .size(1280, 1024)
4. .asBufferedImage();
5. ImageIO.write(thumbnail, "jpg", new File("c:/a380_1280x1024_BufferedImage.jpg"));

需要注意的是，对于CMYK模式的图像，由于JDK的Bug，目前还不能够处理，会出以下异常：

引用

javax.imageio.IIOException: Unsupported Image Type 
at com.sun.imageio.plugins.jpeg.JPEGImageReader.readInternal(JPEGImageReader.java:1063) 
at com.sun.imageio.plugins.jpeg.JPEGImageReader.read(JPEGImageReader.java:1034) 
at javax.imageio.ImageReader.read(ImageReader.java:940) 
at net.coobird.thumbnailator.tasks.io.FileImageSource.read(Unknown Source)

引用

  javax.imageio.IIOException: Incompatible color conversion 
    at com.sun.imageio.plugins.jpeg.JPEGImageReader.checkColorConversion(JPEGImageReader.java:973)

ICC profile

引用

  java.lang.IllegalArgumentException: Numbers of source Raster bands and source color space components do not match 
    at java.awt.image.ColorConvertOp.filter(ColorConvertOp.java:482) 
    at com.sun.imageio.plugins.jpeg.JPEGImageReader.acceptPixels(JPEGImageReader.java:1268) 
    at com.sun.imageio.plugins.jpeg.JPEGImageReader.readImage(Native Method) 
    at com.sun.imageio.plugins.jpeg.JPEGImageReader.readInternal(JPEGImageReader.java:1236) 
    at com.sun.imageio.plugins.jpeg.JPEGImageReader.read(JPEGImageReader.java:1039) 
    at javax.imageio.ImageReader.read(ImageReader.java:939)

这些问题可以JAI.create()来代替ImageIO.read()解决。而高清图的内存溢出OOM问题只能使用ImageMagick转换了。

• ThumbnailatorTest.rar (224.4 KB)