org.nutz.img
类 Images

java.lang.Object
  org.nutz.img.Images

public class Images
extends java.lang.Object

对图像操作的简化 API

作者：

zozoh(zozohtnt@gmail.com)

构造方法摘要

Images()

方法摘要

static java.awt.image.BufferedImage	clipScale(java.awt.image.BufferedImage im, int w, int h) 自动缩放剪切一个图片，令其符合给定的尺寸 如果图片太大，则将其缩小，如果图片太小，则将其放大，多余的部分被裁减
static java.awt.image.BufferedImage	clipScale(java.lang.Object srcIm, java.io.File taIm, int w, int h) 自动缩放剪切一个图片，令其符合给定的尺寸，并将其保存成目标图像文件 图片格式支持 png | gif | jpg | bmp | wbmp
static java.awt.image.BufferedImage	clipScale(java.lang.String srcPath, java.lang.String taPath, int w, int h) 自动缩放剪切一个图片，令其符合给定的尺寸，并将其保存到目标图像路径 图片格式支持 png | gif | jpg | bmp | wbmp
static java.awt.image.BufferedImage	read(java.lang.Object img) 将一个图片文件读入内存
static java.awt.image.BufferedImage	rotate(java.awt.image.BufferedImage image, int degree) 对一个图像进行旋转
static java.awt.image.BufferedImage	rotate(java.lang.Object srcIm, java.io.File taIm, int degree) 对一个图像进行旋转
static java.awt.image.BufferedImage	rotate(java.lang.String srcPath, java.lang.String taPath, int degree) 对一个图像进行旋转
static void	write(java.awt.image.RenderedImage im, java.io.File targetFile) 将内存中一个图片写入目标文件
static void	writeJpeg(java.awt.image.RenderedImage im, java.io.File targetJpg, float quality) 写入一个 JPG 图像
static java.awt.image.BufferedImage	zoomScale(java.awt.image.BufferedImage im, int w, int h) 自动等比缩放一个图片
static java.awt.image.BufferedImage	zoomScale(java.awt.image.BufferedImage im, int w, int h, java.awt.Color bgColor) 自动等比缩放一个图片，多余的部分，用给定背景颜色补上 如果参数中的宽度或高度为-1的话，着按照指定的高度或宽度对原图等比例缩放图片，不添加背景颜色
static java.awt.image.BufferedImage	zoomScale(java.lang.Object srcIm, java.io.File taIm, int w, int h, java.awt.Color bgColor) 自动等比缩放一个图片，并将其保存成目标图像文件 多余的部分，用给定背景颜色补上 如果参数中的宽度或高度为-1的话，着按照指定的高度或宽度对原图等比例缩放图片，不添加背景颜色 图片格式支持 png | gif | jpg | bmp | wbmp
static java.awt.image.BufferedImage	zoomScale(java.lang.String srcPath, java.lang.String taPath, int w, int h, java.awt.Color bgColor) 自动等比缩放一个图片，并将其保存成目标图像文件 多余的部分，用给定背景颜色补上 如果参数中的宽度或高度为-1的话，着按照指定的高度或宽度对原图等比例缩放图片，不添加背景颜色 图片格式支持 png | gif | jpg | bmp | wbmp

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

Images

public Images()

方法详细信息

rotate

public static java.awt.image.BufferedImage rotate(java.lang.Object srcIm,
                                                  java.io.File taIm,
                                                  int degree)

对一个图像进行旋转

参数：

srcIm - 原图像文件

taIm - 转换后的图像文件

degree - 旋转角度, 90 为顺时针九十度， -90 为逆时针九十度

返回：

旋转后得图像对象

rotate

public static java.awt.image.BufferedImage rotate(java.lang.String srcPath,
                                                  java.lang.String taPath,
                                                  int degree)
                                           throws java.io.IOException

对一个图像进行旋转

参数：

srcPath - 原图像文件路径

taPath - 转换后的图像文件路径

degree - 旋转角度, 90 为顺时针九十度， -90 为逆时针九十度

返回：

旋转后得图像对象

抛出：

java.io.IOException

rotate

public static java.awt.image.BufferedImage rotate(java.awt.image.BufferedImage image,
                                                  int degree)

对一个图像进行旋转

参数：

image - 图像

degree - 旋转角度, 90 为顺时针九十度， -90 为逆时针九十度

返回：

旋转后得图像对象

zoomScale

public static java.awt.image.BufferedImage zoomScale(java.lang.Object srcIm,
                                                     java.io.File taIm,
                                                     int w,
                                                     int h,
                                                     java.awt.Color bgColor)
                                              throws java.io.IOException

自动等比缩放一个图片，并将其保存成目标图像文件
多余的部分，用给定背景颜色补上
如果参数中的宽度或高度为-1的话，着按照指定的高度或宽度对原图等比例缩放图片，不添加背景颜色

图片格式支持 png | gif | jpg | bmp | wbmp

参数：

srcIm - 源图像文件对象

taIm - 目标图像文件对象

w - 宽度

h - 高度

bgColor - 背景颜色

返回：

被转换前的图像对象

抛出：

java.io.IOException - 当读写文件失败时抛出

zoomScale

public static java.awt.image.BufferedImage zoomScale(java.lang.String srcPath,
                                                     java.lang.String taPath,
                                                     int w,
                                                     int h,
                                                     java.awt.Color bgColor)
                                              throws java.io.IOException

自动等比缩放一个图片，并将其保存成目标图像文件
多余的部分，用给定背景颜色补上
如果参数中的宽度或高度为-1的话，着按照指定的高度或宽度对原图等比例缩放图片，不添加背景颜色

图片格式支持 png | gif | jpg | bmp | wbmp

参数：

srcPath - 源图像路径

taPath - 目标图像路径，如果不存在，则创建

w - 宽度

h - 高度

bgColor - 背景颜色

返回：

被转换前的图像对象

抛出：

java.io.IOException - 当读写文件失败时抛出

zoomScale

public static java.awt.image.BufferedImage zoomScale(java.awt.image.BufferedImage im,
                                                     int w,
                                                     int h,
                                                     java.awt.Color bgColor)

自动等比缩放一个图片，多余的部分，用给定背景颜色补上
如果参数中的宽度或高度为-1的话，着按照指定的高度或宽度对原图等比例缩放图片，不添加背景颜色

参数：

im - 图像对象

w - 宽度

h - 高度

bgColor - 背景颜色

返回：

被转换后的图像

zoomScale

public static java.awt.image.BufferedImage zoomScale(java.awt.image.BufferedImage im,
                                                     int w,
                                                     int h)

自动等比缩放一个图片

参数：

im - 图像对象

w - 宽度

h - 高度

返回：

被转换后的图像

clipScale

public static java.awt.image.BufferedImage clipScale(java.lang.Object srcIm,
                                                     java.io.File taIm,
                                                     int w,
                                                     int h)
                                              throws java.io.IOException

自动缩放剪切一个图片，令其符合给定的尺寸，并将其保存成目标图像文件

图片格式支持 png | gif | jpg | bmp | wbmp

参数：

srcIm - 源图像文件对象

taIm - 目标图像文件对象

w - 宽度

h - 高度

返回：

被转换前的图像对象

抛出：

java.io.IOException - 当读写文件失败时抛出

clipScale

public static java.awt.image.BufferedImage clipScale(java.lang.String srcPath,
                                                     java.lang.String taPath,
                                                     int w,
                                                     int h)
                                              throws java.io.IOException

自动缩放剪切一个图片，令其符合给定的尺寸，并将其保存到目标图像路径

图片格式支持 png | gif | jpg | bmp | wbmp

参数：

srcPath - 源图像路径

taPath - 目标图像路径，如果不存在，则创建

w - 宽度

h - 高度

返回：

被转换前的图像对象

抛出：

java.io.IOException - 当读写文件失败时抛出

clipScale

public static java.awt.image.BufferedImage clipScale(java.awt.image.BufferedImage im,
                                                     int w,
                                                     int h)

自动缩放剪切一个图片，令其符合给定的尺寸

如果图片太大，则将其缩小，如果图片太小，则将其放大，多余的部分被裁减

参数：

im - 图像对象

w - 宽度

h - 高度

返回：

被转换后的图像

read

public static java.awt.image.BufferedImage read(java.lang.Object img)

将一个图片文件读入内存

参数：

img - 图片文件

返回：

图片对象

write

public static void write(java.awt.image.RenderedImage im,
                         java.io.File targetFile)

将内存中一个图片写入目标文件

参数：

im - 图片对象

targetFile - 目标文件，根据其后缀，来决定写入何种图片格式

writeJpeg

public static void writeJpeg(java.awt.image.RenderedImage im,
                             java.io.File targetJpg,
                             float quality)

写入一个 JPG 图像

参数：

im - 图像对象

targetJpg - 目标输出 JPG 图像文件

quality - 质量 0.1f ~ 1.0f