org.aoju.bus.core.image

Class Image

java.lang.Object

org.aoju.bus.core.image.Image

All Implemented Interfaces:

Serializable

public class Image
extends Object
implements Serializable

图像编辑器

Since:

JDK 1.8

Version:

3.6.5

Author:

Kimi Liu

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Image(BufferedImage srcImage) 构造

Method Summary

Modifier and Type	Method and Description
Image	binary() 彩色转为黑白二值化图片
Image	cut(int x, int y) 图像切割为圆形(按指定起点坐标和半径切割)，填充满整个图片（直径取长宽最小值）
Image	cut(int x, int y, int radius) 图像切割为圆形(按指定起点坐标和半径切割)
Image	cut(Rectangle rectangle) 图像切割(按指定起点坐标和宽高切割)
Image	flip() 水平翻转图像
static Image	from(File imageFile) 从文件读取图片并开始处理
static Image	from(Image image) 从Image取图片并开始处理
static Image	from(ImageInputStream imageStream) 从ImageInputStream取图片并开始处理
static Image	from(InputStream in) 从流读取图片并开始处理
static Image	from(Path imagePath) 从Path读取图片并开始处理
static Image	from(Resource resource) 从资源对象中读取图片并开始处理
static Image	from(URL imageUrl) 从URL取图片并开始处理
Image	getImg() 获取处理过的图片
Image	gray() 彩色转为黑白
Image	pressImage(Image pressImage, int x, int y, float alpha) 给图片添加图片水印
Image	pressImage(Image pressImage, Rectangle rectangle, float alpha) 给图片添加图片水印
Image	pressText(String pressText, Color color, Font font, int x, int y, float alpha) 给图片添加文字水印 此方法并不关闭流
Image	rotate(int degree) 旋转图片为指定角度 来自：http://blog.51cto.com/cping1982/130066
Image	round(double arc) 图片圆角处理
Image	scale(float scale) 缩放图像（按比例缩放）
Image	scale(int width, int height) 缩放图像（按长宽缩放） 注意：目标长宽与原图不成比例会变形
Image	scale(int width, int height, Color fixedColor) 等比缩放图像，此方法按照按照给定的长宽等比缩放图片，按照长宽缩放比最多的一边等比缩放，空白部分填充背景色 缩放后默认为jpeg格式
Image	setPositionBaseCentre(boolean positionBaseCentre) 计算x,y坐标的时候是否从中心做为原始坐标开始计算
Image	setQuality(double quality) 设置图片输出质量，数字为0~1（不包括0和1）表示质量压缩比，除此数字外设置表示不压缩
Image	setQuality(float quality) 设置图片输出质量，数字为0~1（不包括0和1）表示质量压缩比，除此数字外设置表示不压缩
Image	setTargetImageType(String imgType) 设置目标图片文件格式，用于写出
boolean	write(File targetFile) 写出图像为目标文件扩展名对应的格式
boolean	write(ImageOutputStream targetImageStream) 写出图像为PNG格式
boolean	write(OutputStream out) 写出图像

Methods inherited from class java.lang.Object

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

Constructor Detail

Image

public Image(BufferedImage srcImage)

构造

Parameters:

srcImage - 来源图片

Method Detail

from

public static Image from(Path imagePath)

从Path读取图片并开始处理

Parameters:

imagePath - 图片文件路径

Returns:

Image

from

public static Image from(File imageFile)

从文件读取图片并开始处理

Parameters:

imageFile - 图片文件

Returns:

Image

from

public static Image from(Resource resource)

从资源对象中读取图片并开始处理

Parameters:

resource - 图片资源对象

Returns:

Image

from

public static Image from(InputStream in)

从流读取图片并开始处理

Parameters:

in - 图片流

Returns:

Image

from

public static Image from(ImageInputStream imageStream)

从ImageInputStream取图片并开始处理

Parameters:

imageStream - 图片流

Returns:

Image

from

public static Image from(URL imageUrl)

从URL取图片并开始处理

Parameters:

imageUrl - 图片URL

Returns:

Image

from

public static Image from(Image image)

从Image取图片并开始处理

Parameters:

image - 图片

Returns:

Image

setTargetImageType

public Image setTargetImageType(String imgType)

设置目标图片文件格式，用于写出

Parameters:

imgType - 图片格式

Returns:

this

See Also:

FileType.IMAGE_TYPE_JPG, FileType.IMAGE_TYPE_PNG

setPositionBaseCentre

public Image setPositionBaseCentre(boolean positionBaseCentre)

计算x,y坐标的时候是否从中心做为原始坐标开始计算

Parameters:

positionBaseCentre - 是否从中心做为原始坐标开始计算

Returns:

the image

setQuality

public Image setQuality(double quality)

设置图片输出质量，数字为0~1（不包括0和1）表示质量压缩比，除此数字外设置表示不压缩

Parameters:

quality - 质量，数字为0~1（不包括0和1）表示质量压缩比，除此数字外设置表示不压缩

Returns:

the image

setQuality

public Image setQuality(float quality)

设置图片输出质量，数字为0~1（不包括0和1）表示质量压缩比，除此数字外设置表示不压缩

Parameters:

quality - 质量，数字为0~1（不包括0和1）表示质量压缩比，除此数字外设置表示不压缩

Returns:

image

scale

public Image scale(float scale)

缩放图像（按比例缩放）

Parameters:

scale - 缩放比例。比例大于1时为放大，小于1大于0为缩小

Returns:

this

scale

public Image scale(int width,
                   int height)

缩放图像（按长宽缩放） 注意：目标长宽与原图不成比例会变形

Parameters:

width - 目标宽度

height - 目标高度

Returns:

this

scale

public Image scale(int width,
                   int height,
                   Color fixedColor)

等比缩放图像，此方法按照按照给定的长宽等比缩放图片，按照长宽缩放比最多的一边等比缩放，空白部分填充背景色 缩放后默认为jpeg格式

Parameters:

width - 缩放后的宽度

height - 缩放后的高度

fixedColor - 比例不对时补充的颜色，不补充为null

Returns:

this

cut

public Image cut(Rectangle rectangle)

图像切割(按指定起点坐标和宽高切割)

Parameters:

rectangle - 矩形对象，表示矩形区域的x，y，width，height

Returns:

this

cut

public Image cut(int x,
                 int y)

图像切割为圆形(按指定起点坐标和半径切割)，填充满整个图片（直径取长宽最小值）

Parameters:

x - 原图的x坐标起始位置

y - 原图的y坐标起始位置

Returns:

this

cut

public Image cut(int x,
                 int y,
                 int radius)

图像切割为圆形(按指定起点坐标和半径切割)

Parameters:

x - 原图的x坐标起始位置

y - 原图的y坐标起始位置

radius - 半径，小于0表示填充满整个图片（直径取长宽最小值）

Returns:

this

round

public Image round(double arc)

图片圆角处理

Parameters:

arc - 圆角弧度，0~1，为长宽占比

Returns:

this

gray

public Image gray()

彩色转为黑白

Returns:

this

binary

public Image binary()

彩色转为黑白二值化图片

Returns:

this

pressText

public Image pressText(String pressText,
                       Color color,
                       Font font,
                       int x,
                       int y,
                       float alpha)

给图片添加文字水印 此方法并不关闭流

Parameters:

pressText - 水印文字

color - 水印的字体颜色

font - Font 字体相关信息

x - 修正值。 默认在中间，偏移量相对于中间偏移

y - 修正值。 默认在中间，偏移量相对于中间偏移

alpha - 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字

Returns:

处理后的图像

pressImage

public Image pressImage(Image pressImage,
                        int x,
                        int y,
                        float alpha)

给图片添加图片水印

Parameters:

pressImage - 水印图片，可以使用ImageIO.read(File)方法读取文件

x - 修正值。 默认在中间，偏移量相对于中间偏移

y - 修正值。 默认在中间，偏移量相对于中间偏移

alpha - 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字

Returns:

this

pressImage

public Image pressImage(Image pressImage,
                        Rectangle rectangle,
                        float alpha)

给图片添加图片水印

Parameters:

pressImage - 水印图片，可以使用ImageIO.read(File)方法读取文件

rectangle - 矩形对象，表示矩形区域的x，y，width，height，x,y从背景图片中心计算

alpha - 透明度：alpha 必须是范围 [0.0, 1.0] 之内（包含边界值）的一个浮点数字

Returns:

this

rotate

public Image rotate(int degree)

旋转图片为指定角度 来自：http://blog.51cto.com/cping1982/130066

Parameters:

degree - 旋转角度

Returns:

旋转后的图片

Since:

3.6.5

flip

public Image flip()

水平翻转图像

Returns:

this

getImg

public Image getImg()

获取处理过的图片

Returns:

处理过的图片

write

public boolean write(OutputStream out)
              throws InstrumentException

写出图像

Parameters:

out - 写出到的目标流

Returns:

是否成功写出，如果返回false表示未找到合适的Writer

Throws:

InstrumentException - IO异常

write

public boolean write(ImageOutputStream targetImageStream)
              throws InstrumentException

写出图像为PNG格式

Parameters:

targetImageStream - 写出到的目标流

Returns:

是否成功写出，如果返回false表示未找到合适的Writer

Throws:

InstrumentException - IO异常

write

public boolean write(File targetFile)
              throws InstrumentException

写出图像为目标文件扩展名对应的格式

Parameters:

targetFile - 目标文件

Returns:

是否成功写出，如果返回false表示未找到合适的Writer

Throws:

InstrumentException - IO异常