org.nutz.img

类 Images

java.lang.Object

org.nutz.img.Images

public class Images
extends Object

对图像操作的简化 API

作者:

zozoh(zozohtnt@gmail.com)

构造器概要

构造器

构造器和说明
Images()

方法概要

限定符和类型	方法和说明
static BufferedImage	clipScale(BufferedImage im, int w, int h) 自动缩放剪切一个图片，令其符合给定的尺寸 如果图片太大，则将其缩小，如果图片太小，则将其放大，多余的部分被裁减
static BufferedImage	clipScale(Object srcIm, File taIm, int[] startPoint, int[] endPoint) 根据给定的起始坐标点与结束坐标点来剪切一个图片，令其符合给定的尺寸，并将其保存成目标图像文件 图片格式支持 png | gif | jpg | bmp | wbmp
static BufferedImage	clipScale(Object srcIm, File taIm, int w, int h) 自动缩放剪切一个图片，令其符合给定的尺寸，并将其保存成目标图像文件 图片格式支持 png | gif | jpg | bmp | wbmp
static BufferedImage	clipScale(Object srcIm, int[] startPoint, int[] endPoint)
static BufferedImage	clipScale(String srcPath, String taPath, int[] startPoint, int[] endPoint) 根据给定的起始坐标点与结束坐标点来剪切一个图片，令其符合给定的尺寸，并将其保存成目标图像文件 图片格式支持 png | gif | jpg | bmp | wbmp
static BufferedImage	clipScale(String srcPath, String taPath, int w, int h) 自动缩放剪切一个图片，令其符合给定的尺寸，并将其保存到目标图像路径 图片格式支持 png | gif | jpg | bmp | wbmp
static String	encodeBase64(File targetFile) 生成该图片对应的 Base64 编码的字符串
static String	encodeBase64(String targetFile) 生成该图片对应的 Base64 编码的字符串
static BufferedImage	read(Object img) 将一个图片文件读入内存
static BufferedImage	redraw(BufferedImage img, Color bg) 在一个RGB画布上重新绘制Image,解决CMYK图像偏色的问题
static BufferedImage	rotate(BufferedImage image, int degree) 对一个图像进行旋转
static BufferedImage	rotate(Object srcIm, File taIm, int degree) 对一个图像进行旋转
static BufferedImage	rotate(String srcPath, String taPath, int degree) 对一个图像进行旋转
static BufferedImage	scale(BufferedImage im, int w, int h) 自动等比缩放一个图片
static void	write(RenderedImage im, File targetFile) 将内存中一个图片写入目标文件
static void	write(RenderedImage im, String imFormat, OutputStream out) 将内存中的一个写入输出流
static void	writeAndClose(RenderedImage im, String imFormat, OutputStream out)
static void	writeJpeg(RenderedImage im, Object targetJpg, float quality) 写入一个 JPG 图像
static BufferedImage	zoomScale(BufferedImage im, int w, int h)
static BufferedImage	zoomScale(BufferedImage im, int w, int h, Color bgColor) 自动等比缩放一个图片，多余的部分，用给定背景颜色补上 如果参数中的宽度或高度为-1的话，着按照指定的高度或宽度对原图等比例缩放图片，不添加背景颜色
static BufferedImage	zoomScale(Object srcIm, File taIm, int w, int h, Color bgColor) 自动等比缩放一个图片，并将其保存成目标图像文件 多余的部分，用给定背景颜色补上 如果参数中的宽度或高度为-1的话，着按照指定的高度或宽度对原图等比例缩放图片，不添加背景颜色 图片格式支持 png | gif | jpg | bmp | wbmp
static BufferedImage	zoomScale(String srcPath, String taPath, int w, int h, 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 BufferedImage rotate(Object srcIm,
                                   File taIm,
                                   int degree)

对一个图像进行旋转

参数:

srcIm - 原图像文件

taIm - 转换后的图像文件

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

返回:

旋转后得图像对象

rotate

public static BufferedImage rotate(String srcPath,
                                   String taPath,
                                   int degree)
                            throws IOException

对一个图像进行旋转

参数:

srcPath - 原图像文件路径

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

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

返回:

旋转后得图像对象

抛出:

IOException

rotate

public static BufferedImage rotate(BufferedImage image,
                                   int degree)

对一个图像进行旋转

参数:

image - 图像

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

返回:

旋转后得图像对象

zoomScale

public static BufferedImage zoomScale(Object srcIm,
                                      File taIm,
                                      int w,
                                      int h,
                                      Color bgColor)
                               throws IOException

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

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

参数:

srcIm - 源图像文件对象

taIm - 目标图像文件对象

w - 宽度

h - 高度

bgColor - 背景颜色

返回:

被转换前的图像对象

抛出:

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

zoomScale

public static BufferedImage zoomScale(String srcPath,
                                      String taPath,
                                      int w,
                                      int h,
                                      Color bgColor)
                               throws IOException

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

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

参数:

srcPath - 源图像路径

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

w - 宽度

h - 高度

bgColor - 背景颜色

返回:

被转换前的图像对象

抛出:

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

zoomScale

public static BufferedImage zoomScale(BufferedImage im,
                                      int w,
                                      int h,
                                      Color bgColor)

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

参数:

im - 图像对象

w - 宽度

h - 高度

bgColor - 背景颜色

返回:

被转换后的图像

zoomScale

public static BufferedImage zoomScale(BufferedImage im,
                                      int w,
                                      int h)

另请参阅:

zoomScale(BufferedImage, int, int, Color)

scale

public static BufferedImage scale(BufferedImage im,
                                  int w,
                                  int h)

自动等比缩放一个图片

参数:

im - 图像对象

w - 宽度

h - 高度

返回:

被转换后的图像

clipScale

public static BufferedImage clipScale(Object srcIm,
                                      File taIm,
                                      int w,
                                      int h)
                               throws IOException

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

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

参数:

srcIm - 源图像文件对象

taIm - 目标图像文件对象

w - 宽度

h - 高度

返回:

被转换前的图像对象

抛出:

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

clipScale

public static BufferedImage clipScale(String srcPath,
                                      String taPath,
                                      int w,
                                      int h)
                               throws IOException

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

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

参数:

srcPath - 源图像路径

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

w - 宽度

h - 高度

返回:

被转换前的图像对象

抛出:

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

clipScale

public static BufferedImage clipScale(Object srcIm,
                                      int[] startPoint,
                                      int[] endPoint)

clipScale

public static BufferedImage clipScale(Object srcIm,
                                      File taIm,
                                      int[] startPoint,
                                      int[] endPoint)
                               throws IOException

根据给定的起始坐标点与结束坐标点来剪切一个图片，令其符合给定的尺寸，并将其保存成目标图像文件

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

参数:

srcIm - 源图像文件对象

taIm - 目标图像文件对象

startPoint - 起始坐标点，其值[x, y]为相对原图片左上角的坐标

endPoint - 结束坐标点，其值[x, y]为相对原图片左上角的坐标

返回:

被转换前的图像对象

抛出:

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

clipScale

public static BufferedImage clipScale(String srcPath,
                                      String taPath,
                                      int[] startPoint,
                                      int[] endPoint)
                               throws IOException

根据给定的起始坐标点与结束坐标点来剪切一个图片，令其符合给定的尺寸，并将其保存成目标图像文件

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

参数:

srcPath - 源图像文件对象

taPath - 目标图像文件对象

startPoint - 起始坐标点，其值[x, y]为相对原图片左上角的坐标

endPoint - 结束坐标点，其值[x, y]为相对原图片左上角的坐标

返回:

被转换前的图像对象

抛出:

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

clipScale

public static BufferedImage clipScale(BufferedImage im,
                                      int w,
                                      int h)

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

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

参数:

im - 图像对象

w - 宽度

h - 高度

返回:

被转换后的图像

read

public static BufferedImage read(Object img)

将一个图片文件读入内存

参数:

img - 图片文件

返回:

图片对象

write

public static void write(RenderedImage im,
                         File targetFile)

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

参数:

im - 图片对象

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

write

public static void write(RenderedImage im,
                         String imFormat,
                         OutputStream out)

将内存中的一个写入输出流

参数:

im - 图片对象

imFormat - 图片格式

out - 输出流

writeAndClose

public static void writeAndClose(RenderedImage im,
                                 String imFormat,
                                 OutputStream out)

另请参阅:

write(RenderedImage, String, OutputStream)

writeJpeg

public static void writeJpeg(RenderedImage im,
                             Object targetJpg,
                             float quality)

写入一个 JPG 图像

参数:

im - 图像对象

targetJpg - 目标输出 JPG 图像文件

quality - 质量 0.1f ~ 1.0f

encodeBase64

public static String encodeBase64(String targetFile)

生成该图片对应的 Base64 编码的字符串

参数:

targetFile - 图片文件

返回:

图片对应的 Base64 编码的字符串

encodeBase64

public static String encodeBase64(File targetFile)

生成该图片对应的 Base64 编码的字符串

参数:

targetFile - 图片文件

返回:

图片对应的 Base64 编码的字符串

redraw

public static BufferedImage redraw(BufferedImage img,
                                   Color bg)

在一个RGB画布上重新绘制Image,解决CMYK图像偏色的问题