Thumbnailator使用简介

图片处理是当今软件开发中非常重要的一环，然而处理图片的开源框架却并不多。现金网上流传的Java处理图片的代码，虽然可对图片进行简单处理，但效果并不理想。虽然也有些其他解决方案，但都摆脱不了繁琐，使用起来十分不方便。

为了解决这个问题，我也是在网上找了好久，看了很多资料，功夫不负有心人，最终找到了一个处理图片十分棒的开源框架。特此拿出来与大家分享。

Thumbnailator 是一个优秀的图片处理的Google开源Java类库。处理效果远比Java API的好。从API提供现有的图像文件和图像对象的类中简化了处理过程，两三行代码就能够从现有图片生成处理后的图片，且允许微调图片的生成方式，同时保持了需要写入的最低限度的代码量。还支持对一个目录的所有图片进行批量处理操作。

支持的处理操作：图片缩放，区域裁剪，水印，旋转，保持比例。

另外值得一提的是，Thumbnailator至今仍不断更新，怎么样，感觉很有保障吧！

Thumbnailator官网：http://code.google.com/p/thumbnailator/

下面我们介绍下如何使用Thumbnailator

原图：

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");

//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");

//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");

//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");

//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(newFile("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(newFile("images/watermark.png")),0.5f)
    .outputQuality(0.8f)
    .toFile("c:/a380_watermark_center.jpg");

//watermark(位置，水印图，透明度)
Thumbnails.of("images/a380_1280x1024.jpg")
	.size(1280,1024)
	.watermark(Positions.BOTTOM_RIGHT,ImageIO.read(newFile("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(newFile("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");

//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");

//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(流对象)
OutputStreamos=newFileOutputStream("c:/a380_1280x1024_OutputStream.png");
Thumbnails.of("images/a380_1280x1024.jpg")
    .size(1280,1024)
    .toOutputStream(os);

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

 

 9、输出到BufferedImage

[java] view plain copy print ?

//asBufferedImage()返回BufferedImage
BufferedImagethumbnail=Thumbnails.of("images/a380_1280x1024.jpg")
    .size(1280,1024)
    .asBufferedImage();
ImageIO.write(thumbnail,"jpg",newFile("c:/a380_1280x1024_BufferedImage.jpg"));

 

 

Thumbnailator是一个非常好的图片开源工具，使用起来很方便，不过文档不是非常全面，如果遇到问题的话，有时也是不好解决的，我之前研究过，所以分享下经验，以便大家使用时更顺手些。

之前文章中Java图片处理开源框架已说明的功能我这里不再重复了。

场景一：图片尺寸不变，修改图片文件类型

Thumbnails.of("F:\\image\\IMG_20131229_114806.png")
    .scale(1f)
    .outputFormat("jpg")
    .toFile("F:\\image\\output\\IMG_20131229_114806");

Thumbnails.of("F:\\image\\IMG_20131229_114806.png")
	.scale(1f)
	.outputFormat("jpg")
	.toFile("F:\\image\\output\\IMG_20131229_114806");

 

outputFormat：输出的图片格式。注意使用该方法后toFile()方法不要再含有文件类型的后缀了，否则会生成 IMG_20131229_114806.jpg.jpg 的图片。

场景二：图片尺寸不变，压缩图片文件大小

Thumbnails.of("F:\\image\\IMG_20131229_114806.png")
    .scale(1f)
    .outputQuality(0.25f)
    .outputFormat("jpg")
    .toFile("F:\\image\\output\\IMG_20131229_114806");

Thumbnails.of("F:\\image\\IMG_20131229_114806.png")
	.scale(1f)
	.outputQuality(0.25f)
	.outputFormat("jpg")
	.toFile("F:\\image\\output\\IMG_20131229_114806");

 

outputQuality：输出的图片质量，范围：0.0~1.0，1为最高质量。注意使用该方法时输出的图片格式必须为jpg（即outputFormat("jpg")。其他格式我没试过，感兴趣的自己可以试试）。否则若是输出png格式图片，则该方法作用无效【这其实应该算是bug】。

场景三：压缩至指定图片尺寸（例如：横400高300），不保持图片比例

Thumbnails.of("F:\\image\\IMG_20131229_114806.png")
    .forceSize(400, 300)
    .toFile("F:\\image\\output\\IMG_20131229_114806");

Thumbnails.of("F:\\image\\IMG_20131229_114806.png")
	.forceSize(400, 300)
	.toFile("F:\\image\\output\\IMG_20131229_114806");

 

场景四：压缩至指定图片尺寸（例如：横400高300），保持图片不变形，多余部分裁剪掉

String imagePath = "F:\\image\\IMG_20131229_114806.jpg";
BufferedImage image = ImageIO.read(new File(imagePath));
Builder<BufferedImage> builder = null;

int imageWidth = image.getWidth();
int imageHeitht = image.getHeight();
if ((float)300 / 400 != (float)imageWidth / imageHeitht) {
    if (imageWidth > imageHeitht) {
        image = Thumbnails.of(imagePath).height(300).asBufferedImage();
    } else {
        image = Thumbnails.of(imagePath).width(400).asBufferedImage();
    }
    builder = Thumbnails.of(image).sourceRegion(Positions.CENTER, 400, 300).size(400, 300);
} else {
    builder = Thumbnails.of(image).size(400, 300);
}
builder.outputFormat("jpg").toFile("F:\\image\\output\\IMG_20131229_114806");

String imagePath = "F:\\image\\IMG_20131229_114806.jpg";
BufferedImage image = ImageIO.read(new File(imagePath));
Builder<BufferedImage> builder = null;

int imageWidth = image.getWidth();
int imageHeitht = image.getHeight();
if ((float)300 / 400 != (float)imageWidth / imageHeitht) {
	if (imageWidth > imageHeitht) {
		image = Thumbnails.of(imagePath).height(300).asBufferedImage();
	} else {
		image = Thumbnails.of(imagePath).width(400).asBufferedImage();
	}
	builder = Thumbnails.of(image).sourceRegion(Positions.CENTER, 400, 300).size(400, 300);
} else {
	builder = Thumbnails.of(image).size(400, 300);
}
builder.outputFormat("jpg").toFile("F:\\image\\output\\IMG_20131229_114806");

 

这种情况复杂些，既不能用size()方法（因为横高比不一定是4/3，这样压缩后的图片横为400或高为300），也不能用forceSize()方法。首先判断横高比，确定是按照横400压缩还是高300压缩，压缩后按中心400*300的区域进行裁剪，这样得到的图片便是400*300的裁剪后缩略图。

使用size()或forceSize()方法时，如果图片比指定的尺寸要小（比如size(400, 300)，而图片为40*30），则会拉伸到指定尺寸。

 

另外提醒大家一点，若png、gif格式图片中含有透明背景，使用该工具压缩处理后背景会变成黑色，这是Thumbnailator的一个bug，预计后期版本会解决。