org.nutz.img

Class Images

java.lang.Object

org.nutz.img.Images

public class Images
extends Object

对图像操作的简化 API

Author:

zozoh(zozohtnt@gmail.com)

Field Summary

Fields

Modifier and Type	Field and Description
static int	CHANNEL_BLUE
static int	CHANNEL_GREEN
static int	CHANNEL_RED
static int	WATERMARK_BOTTOM_CENTER
static int	WATERMARK_BOTTOM_LEFT
static int	WATERMARK_BOTTOM_RIGHT
static int	WATERMARK_CENTER
static int	WATERMARK_CENTER_LEFT
static int	WATERMARK_CENTER_RIGHT
static int	WATERMARK_TOP_CENTER
static int	WATERMARK_TOP_LEFT
static int	WATERMARK_TOP_RIGHT

Constructor Summary

Constructors

Constructor and Description
Images()

Method Summary

Modifier and Type	Method and Description
static BufferedImage	addWatermark(Object srcIm, Object markIm, float opacity, int pos, int margin) 为图片添加水印，可以设定透明度与水印的位置
static BufferedImage	channelImage(Object srcIm, int channel) 获取三原色通道图片
static BufferedImage	clipScale(BufferedImage im, int w, int h) 自动缩放剪切一个图片，令其符合给定的尺寸
static BufferedImage	clipScale(Object srcIm, File taIm, int[] startPoint, int[] endPoint) 根据给定的起始坐标点与结束坐标点来剪切一个图片，令其符合给定的尺寸，并将其保存成目标图像文件
static BufferedImage	clipScale(Object srcIm, File taIm, int w, int h) 自动缩放剪切一个图片，令其符合给定的尺寸，并将其保存成目标图像文件
static BufferedImage	clipScale(Object srcIm, int[] startPoint, int[] endPoint)
static BufferedImage	clipScale(String srcPath, String taPath, int[] startPoint, int[] endPoint) 根据给定的起始坐标点与结束坐标点来剪切一个图片，令其符合给定的尺寸，并将其保存成目标图像文件
static BufferedImage	clipScale(String srcPath, String taPath, int w, int h) 自动缩放剪切一个图片，令其符合给定的尺寸，并将其保存到目标图像路径
static BufferedImage	createAvatar(String name) 根据名字生成头像，英文采用第一个字母，中文2个字使用2个字，超过2个字采用第一个字
static BufferedImage	createAvatar(String name, int size, String fontColor, String bgColor, String fontName, int fontSize, int fontStyle) 根据名字生成头像，英文采用第一个字母，中文2个字使用2个字，超过2个字采用第一个字
static BufferedImage	createCaptcha(String content) 根据指定文字内容，生成验证码，字体颜色随机变化。
static BufferedImage	createCaptcha(String content, int width, int height, String fontColor, String bgColor, String fontName) 根据指定文字内容，生成验证码
static BufferedImage	createText(String content) 文字生成图片，黑底白字。
static BufferedImage	createText(String content, int width, int height, String fontColor, String bgColor, String fontName, int fontSize, int fontStyle) 文字生成图片
static BufferedImage	cutoutByChannel(Object srcIm, int channel) 根据指定通道的亮度值（灰度值）来自动计算哪些像素需要扣掉。
static BufferedImage	cutoutByLuminance(Object srcIm) 根据亮度值（灰度值）来自动计算哪些像素需要扣掉。 适合前后亮度差别特别明显的图片，比如背景全黑。
static BufferedImage	cutoutByPixel(Object srcIm, int x, int y, int range) 指定的像素点为背景色参考，在指定范围内的颜色将设置为透明。 ！！！ 该方法适合背景与前景相差特别大的图片，最好是背景颜色基本一致，前景背景有明显分隔界限。
static String	encodeBase64(File targetFile) 生成该图片对应的 Base64 编码的字符串
static String	encodeBase64(String targetFile) 生成该图片对应的 Base64 编码的字符串
static BufferedImage	flipHorizontal(Object srcIm) 水平翻转一张图片
static BufferedImage	flipHorizontal(Object srcIm, File tarIm) 水平翻转一张图片
static BufferedImage	flipVertical(Object srcIm) 垂直翻转一张图片
static BufferedImage	flipVertical(Object srcIm, File tarIm) 垂直翻转一张图片
static BufferedImage	grayImage(Object srcIm) 获取灰度图像
static BufferedImage	multiply(Object bgIm, Object itemIm, int x, int y) 实现两张图片的正片叠底效果
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 BufferedImage	twist(Object srcIm, double twistRank, String bgColor) 扭曲图片
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的话，着按照指定的高度或宽度对原图等比例缩放图片，不添加背景颜色
static BufferedImage	zoomScale(String srcPath, String taPath, int w, int h, Color bgColor) 自动等比缩放一个图片，并将其保存成目标图像文件 多余的部分，用给定背景颜色补上 如果参数中的宽度或高度为-1的话，着按照指定的高度或宽度对原图等比例缩放图片，不添加背景颜色

Methods inherited from class java.lang.Object

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

Field Detail

WATERMARK_TOP_LEFT

public static final int WATERMARK_TOP_LEFT

See Also:

Constant Field Values

WATERMARK_TOP_CENTER

public static final int WATERMARK_TOP_CENTER

See Also:

Constant Field Values

WATERMARK_TOP_RIGHT

public static final int WATERMARK_TOP_RIGHT

See Also:

Constant Field Values

WATERMARK_CENTER_LEFT

public static final int WATERMARK_CENTER_LEFT

See Also:

Constant Field Values

WATERMARK_CENTER

public static final int WATERMARK_CENTER

See Also:

Constant Field Values

WATERMARK_CENTER_RIGHT

public static final int WATERMARK_CENTER_RIGHT

See Also:

Constant Field Values

WATERMARK_BOTTOM_LEFT

public static final int WATERMARK_BOTTOM_LEFT

See Also:

Constant Field Values

WATERMARK_BOTTOM_CENTER

public static final int WATERMARK_BOTTOM_CENTER

See Also:

Constant Field Values

WATERMARK_BOTTOM_RIGHT

public static final int WATERMARK_BOTTOM_RIGHT

See Also:

Constant Field Values

CHANNEL_RED

public static final int CHANNEL_RED

See Also:

Constant Field Values

CHANNEL_GREEN

public static final int CHANNEL_GREEN

See Also:

Constant Field Values

CHANNEL_BLUE

public static final int CHANNEL_BLUE

See Also:

Constant Field Values

Constructor Detail

Images

public Images()

Method Detail

rotate

public static BufferedImage rotate(Object srcIm,
                                   File taIm,
                                   int degree)

对一个图像进行旋转

Parameters:

srcIm - 原图像文件

taIm - 转换后的图像文件

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

Returns:

旋转后得图像对象

rotate

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

对一个图像进行旋转

Parameters:

srcPath - 原图像文件路径

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

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

Returns:

旋转后得图像对象

Throws:

IOException

rotate

public static BufferedImage rotate(BufferedImage image,
                                   int degree)

对一个图像进行旋转

Parameters:

image - 图像

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

Returns:

旋转后得图像对象

zoomScale

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

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

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

Parameters:

srcIm - 源图像文件对象

taIm - 目标图像文件对象

w - 宽度

h - 高度

bgColor - 背景颜色

Returns:

被转换前的图像对象

Throws:

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

zoomScale

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

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

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

Parameters:

srcPath - 源图像路径

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

w - 宽度

h - 高度

bgColor - 背景颜色

Returns:

被转换前的图像对象

Throws:

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

zoomScale

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

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

Parameters:

im - 图像对象

w - 宽度

h - 高度

bgColor - 背景颜色

Returns:

被转换后的图像

zoomScale

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

See Also:

zoomScale(BufferedImage, int, int, Color)

scale

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

自动等比缩放一个图片

Parameters:

im - 图像对象

w - 宽度

h - 高度

Returns:

被转换后的图像

clipScale

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

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

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

Parameters:

srcIm - 源图像文件对象

taIm - 目标图像文件对象

w - 宽度

h - 高度

Returns:

被转换前的图像对象

Throws:

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

clipScale

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

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

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

Parameters:

srcPath - 源图像路径

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

w - 宽度

h - 高度

Returns:

被转换前的图像对象

Throws:

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

Parameters:

srcIm - 源图像文件对象

taIm - 目标图像文件对象

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

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

Returns:

被转换前的图像对象

Throws:

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

clipScale

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

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

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

Parameters:

srcPath - 源图像文件对象

taPath - 目标图像文件对象

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

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

Returns:

被转换前的图像对象

Throws:

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

clipScale

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

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

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

Parameters:

im - 图像对象

w - 宽度

h - 高度

Returns:

被转换后的图像

flipHorizontal

public static BufferedImage flipHorizontal(Object srcIm)

水平翻转一张图片

Parameters:

srcIm - 源图片

Returns:

被转换后的图像

flipHorizontal

public static BufferedImage flipHorizontal(Object srcIm,
                                           File tarIm)

水平翻转一张图片

Parameters:

srcIm - 源图片

tarIm - 目标图片

Returns:

被转换后的图像

flipVertical

public static BufferedImage flipVertical(Object srcIm)

垂直翻转一张图片

Parameters:

srcIm - 源图片

Returns:

被转换后的图像

flipVertical

public static BufferedImage flipVertical(Object srcIm,
                                         File tarIm)

垂直翻转一张图片

Parameters:

srcIm - 源图片

tarIm - 目标图片

Returns:

被转换后的图像

twist

public static BufferedImage twist(Object srcIm,
                                  double twistRank,
                                  String bgColor)

扭曲图片

Parameters:

srcIm - 源图片

twistRank - 扭曲程度，默认为1，数值越大扭曲程度越高

bgColor - 扭曲后露出的底图填充色，一般选择要源图片的背景色

Returns:

被扭曲后的图片

addWatermark

public static BufferedImage addWatermark(Object srcIm,
                                         Object markIm,
                                         float opacity,
                                         int pos,
                                         int margin)

为图片添加水印，可以设定透明度与水印的位置

水印位置默认支持9种，分别是： TOP_LEFT | TOP_CENTER | TOP_RIGHT CENTER_LEFT | CENTER | CENTER_RIGHT BOTTOM_LEFT | BOTTOM_CENTER | BOTTOM_RIGHT

Parameters:

srcIm - 源图片

markIm - 水印图片

opacity - 透明度, 要求大于0小于1, 默认为0.5f

pos - 共9个位置，请使用 Images.WATERMARK_{XXX} 进行设置，默认为 Images.WATERMARK_CENTER

margin - 水印距离四周的边距 默认为0

Returns:

grayImage

public static BufferedImage grayImage(Object srcIm)

获取灰度图像

Parameters:

srcIm - 源图片

Returns:

灰度图片

multiply

public static BufferedImage multiply(Object bgIm,
                                     Object itemIm,
                                     int x,
                                     int y)

实现两张图片的正片叠底效果

Parameters:

bgIm - 背景图

itemIm - 上层图

x - 上层图横坐标

y - 上层图横坐标

Returns:

正片叠底后的图片

cutoutByLuminance

public static BufferedImage cutoutByLuminance(Object srcIm)

根据亮度值（灰度值）来自动计算哪些像素需要扣掉。
适合前后亮度差别特别明显的图片，比如背景全黑。

Parameters:

srcIm - 源图片

Returns:

抠图后图片对象

cutoutByChannel

public static BufferedImage cutoutByChannel(Object srcIm,
                                            int channel)

根据指定通道的亮度值（灰度值）来自动计算哪些像素需要扣掉。

Parameters:

srcIm - 源图片

channel - 通道编号，0:red 1:green 2:blue 其他:亮度

Returns:

抠图后图片对象

cutoutByPixel

public static BufferedImage cutoutByPixel(Object srcIm,
                                          int x,
                                          int y,
                                          int range)

指定的像素点为背景色参考，在指定范围内的颜色将设置为透明。
！！！ 该方法适合背景与前景相差特别大的图片，最好是背景颜色基本一致，前景背景有明显分隔界限。

Parameters:

srcIm - 源图片

x - 采样像素点横坐标

y - 采样像素点纵坐标

range - 采样像素可允许色差范围，数值越大去掉的颜色范围越多

Returns:

抠图后图片对象

channelImage

public static BufferedImage channelImage(Object srcIm,
                                         int channel)

获取三原色通道图片

Parameters:

srcIm - 源图片

channel - 通道编号，0:red 1:green 2:blue

Returns:

单一通道图片

read

public static BufferedImage read(Object img)

将一个图片文件读入内存

Parameters:

img - 图片文件

Returns:

图片对象

write

public static void write(RenderedImage im,
                         File targetFile)

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

Parameters:

im - 图片对象

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

write

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

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

Parameters:

im - 图片对象

imFormat - 图片格式

out - 输出流

writeAndClose

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

See Also:

write(RenderedImage, String, OutputStream)

writeJpeg

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

写入一个 JPG 图像

Parameters:

im - 图像对象

targetJpg - 目标输出 JPG 图像文件

quality - 质量 0.1f ~ 1.0f

encodeBase64

public static String encodeBase64(String targetFile)

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

Parameters:

targetFile - 图片文件

Returns:

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

encodeBase64

public static String encodeBase64(File targetFile)

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

Parameters:

targetFile - 图片文件

Returns:

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

redraw

public static BufferedImage redraw(BufferedImage img,
                                   Color bg)

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

createText

public static BufferedImage createText(String content)

文字生成图片，黑底白字。

Parameters:

content - 文字内容

Returns:

图像

createText

public static BufferedImage createText(String content,
                                       int width,
                                       int height,
                                       String fontColor,
                                       String bgColor,
                                       String fontName,
                                       int fontSize,
                                       int fontStyle)

文字生成图片

Parameters:

content - 文字内容

width - 图片宽度，默认256

height - 图片高度，默认256

fontColor - 文字颜色 默认白色

bgColor - 背景颜色 默认黑色

fontName - 字体名称 需运行环境中已有该字体名称

fontSize - 字体大小

fontStyle - 字体样式 Font.PLAIN || Font.BOLD || Font.ITALIC

Returns:

图像

createAvatar

public static BufferedImage createAvatar(String name)

根据名字生成头像，英文采用第一个字母，中文2个字使用2个字，超过2个字采用第一个字

Parameters:

name - 名字

Returns:

头像

createAvatar

public static BufferedImage createAvatar(String name,
                                         int size,
                                         String fontColor,
                                         String bgColor,
                                         String fontName,
                                         int fontSize,
                                         int fontStyle)

根据名字生成头像，英文采用第一个字母，中文2个字使用2个字，超过2个字采用第一个字

Parameters:

name - 名字

size - 图片大小，默认256

fontColor - 文字颜色 默认白色

bgColor - 背景颜色 默认黑色

fontName - 字体名称 需运行环境中已有该字体名称

fontSize - 字体大小

fontStyle - 字体样式 Font.PLAIN || Font.BOLD || Font.ITALIC

Returns:

头像

createCaptcha

public static BufferedImage createCaptcha(String content)

根据指定文字内容，生成验证码，字体颜色随机变化。

Parameters:

content - 文字内容

Returns:

图像

createCaptcha

public static BufferedImage createCaptcha(String content,
                                          int width,
                                          int height,
                                          String fontColor,
                                          String bgColor,
                                          String fontName)

根据指定文字内容，生成验证码

Parameters:

content - 文字内容

width - 图片宽度

height - 图片高度

fontColor - 文字颜色 默认黑色

bgColor - 背景颜色 默认白色

Returns:

图像