Java生成缩略图之Thumbnailator

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

http://code.google.com/p/thumbnailator/

版本：thumbnailator-0.4.2.jar

原图如下：


1、指定大小进行缩放

//size(宽度, 高度)

/*  
 * 若图片横比200小，高比300小，不变  
 * 若图片横比200小，高比300大，高缩小到300，图片比例不变  
 * 若图片横比200大，高比300小，横缩小到200，图片比例不变  
 * 若图片横比200大，高比300大，图片按比例缩小，横为200或高为300  
 */ 
Thumbnails.of("images/a380_1280x1024.jpg") 
        .size(200, 300)
        .toFile("c:/a380_200x300.jpg");

Thumbnails.of("images/a380_1280x1024.jpg") 
        .size(2560, 2048) 
        .toFile("c:/a380_2560x2048.jpg");

2、按照比例进行缩放

//scale(比例)
Thumbnails.of("images/a380_1280x1024.jpg") 
        .scale(0.25f)
        .toFile("c:/a380_25%.jpg");

Thumbnails.of("images/a380_1280x1024.jpg") 
        .scale(1.10f)
        .toFile("c:/a380_110%.jpg");

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

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

4、旋转

//rotate(角度),正数：顺时针 负数：逆时针
Thumbnails.of("images/a380_1280x1024.jpg") 
		.size(1280, 1024)
        .rotate(90) 
        .toFile("c:/a380_rotate+90.jpg"); 

Thumbnails.of("images/a380_1280x1024.jpg") 
		.size(1280, 1024)
        .rotate(-90) 
        .toFile("c:/a380_rotate-90.jpg"); 

5、水印

//watermark(位置，水印图，透明度)
Thumbnails.of("images/a380_1280x1024.jpg") 
		.size(1280, 1024)
        .watermark(Positions.BOTTOM_RIGHT, ImageIO.read(new File("images/watermark.png")), 0.5f) 
        .outputQuality(0.8f) 
        .toFile("c:/a380_watermark_bottom_right.jpg");

Thumbnails.of("images/a380_1280x1024.jpg") 
		.size(1280, 1024)
        .watermark(Positions.CENTER, ImageIO.read(new File("images/watermark.png")), 0.5f) 
        .outputQuality(0.8f) 
        .toFile("c:/a380_watermark_center.jpg");

6、裁剪

//sourceRegion()

//图片中心400*400的区域
Thumbnails.of("images/a380_1280x1024.jpg")
		.sourceRegion(Positions.CENTER, 400,400)
		.size(200, 200)
        .keepAspectRatio(false) 
        .toFile("c:/a380_region_center.jpg");

//图片右下400*400的区域
Thumbnails.of("images/a380_1280x1024.jpg")
		.sourceRegion(Positions.BOTTOM_RIGHT, 400,400)
		.size(200, 200)
        .keepAspectRatio(false) 
        .toFile("c:/a380_region_bootom_right.jpg");

//指定坐标
Thumbnails.of("images/a380_1280x1024.jpg")
		.sourceRegion(600, 500, 400, 400)
		.size(200, 200)
        .keepAspectRatio(false) 
        .toFile("c:/a380_region_coord.jpg");

7、转化图像格式

//outputFormat(图像格式)
Thumbnails.of("images/a380_1280x1024.jpg") 
		.size(1280, 1024)
        .outputFormat("png") 
        .toFile("c:/a380_1280x1024.png"); 

Thumbnails.of("images/a380_1280x1024.jpg") 
		.size(1280, 1024)
        .outputFormat("gif") 
        .toFile("c:/a380_1280x1024.gif"); 

8、输出到OutputStream

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

9、输出到BufferedImage

//asBufferedImage() 返回BufferedImage
BufferedImage thumbnail = Thumbnails.of("images/a380_1280x1024.jpg") 
		.size(1280, 1024)
		.asBufferedImage();
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转换了。

评论

31 楼 nshg 2012-06-04  

刚好用到这方面的东西，看看好用不

30 楼 java10000 2012-06-04  

建议增加补白的功能，这个对于处理不规则图片比较有用

29 楼 longware 2012-06-04  

看起来很爽的样子

28 楼 dick1305 2012-06-04  

试用下看看，先谢谢。

27 楼 ctfzh 2012-06-04  

不错，使用起来看起来蛮简单方便的。

26 楼 dotjar 2012-06-03  

之前给android客户端做数据，用过这个东西

25 楼 ilovelpz 2012-06-03  

改天看看JAI会不会失真

24 楼 ilovelpz 2012-06-03  

这个旋转之后失真有点严重啊 outputQuality 这个设置为1，还是看到明显的失真 还要设置啥东西不

23 楼 xici_magic 2012-06-02  

支持一下了，不错

22 楼 java10000 2012-06-02  

建议增加补白的功能，这个对于处理不规则图片比较有用

21 楼 ronggui 2012-06-02  

真的很方便，简单

20 楼 362217990 2012-06-02  

不错，以前自己写的可以抛弃了，以后网站采用的缩略图工具 http://www.yy606.com/

19 楼 wander312 2012-06-02  

nice, easy

18 楼 elkan1788 2012-06-01  

感觉挺方便的，不过不太喜欢在项目中引用太多的JAR包，下次看看源码取精锐，嘻嘻

17 楼 alanlhy 2012-06-01  

前一段时间也做了我们项目中关于图片的功能，也用到图片缩略，但是用到的Java的api完成的。。。看了这个，学习学习。。。

16 楼 dwangel 2012-06-01  

嗯，说点打击人的话.
相比JAI有啥优势？
除了比JAI容易找到下载位置。

15 楼 helloboy077 2012-06-01  

不错,很方便,以后也许会用到.收藏.

14 楼 rensanning 2012-06-01  

newvirus 写道

问个问题啊 为什么我eclipse中为什么总是提示不试用的参数呢？Thumbnails.of("images/a380_1280x1024.jpg")，提示of(String[])

把JDK选1.5以上。

13 楼 宋建勇 2012-06-01  

不错，正好用得到

12 楼 newvirus 2012-06-01  

问个问题啊 为什么我eclipse中为什么总是提示不试用的参数呢？Thumbnails.of("images/a380_1280x1024.jpg")，提示of(String[])