cn.hutool.core.img

类 Img

java.lang.Object

cn.hutool.core.img.Img

public class Img
extends java.lang.Object

图像编辑器

从以下版本开始:

4.1.5

作者:

looly

构造器概要

构造器

构造器和说明
Img(java.awt.image.BufferedImage srcImage) 构造

方法概要

方法

限定符和类型	方法和说明
Img	binary() 彩色转为黑白二值化图片
Img	cut(int x, int y) 图像切割为圆形(按指定起点坐标和半径切割)，填充满整个图片（直径取长宽最小值）
Img	cut(int x, int y, int radius) 图像切割为圆形(按指定起点坐标和半径切割)
Img	cut(java.awt.Rectangle rectangle) 图像切割(按指定起点坐标和宽高切割)
Img	flip() 水平翻转图像
static Img	from(java.io.File imageFile) 从文件读取图片并开始处理
static Img	from(java.awt.Image image) 从Image取图片并开始处理
static Img	from(javax.imageio.stream.ImageInputStream imageStream) 从ImageInputStream取图片并开始处理
static Img	from(java.io.InputStream in) 从流读取图片并开始处理
static Img	from(java.net.URL imageUrl) 从URL取图片并开始处理
java.awt.image.BufferedImage	getImg() 获取处理过的图片
Img	gray() 彩色转为黑白
Img	pressImage(java.awt.Image pressImg, int x, int y, float alpha) 给图片添加图片水印 此方法并不关闭流
Img	pressImage(java.awt.Image pressImg, java.awt.Rectangle rectangle, float alpha) 给图片添加图片水印 此方法并不关闭流
Img	pressText(java.lang.String pressText, java.awt.Color color, java.awt.Font font, int x, int y, float alpha) 给图片添加文字水印 此方法并不关闭流
Img	rotate(int degree) 旋转图片为指定角度 来自：http://blog.51cto.com/cping1982/130066
Img	scale(float scale) 缩放图像（按比例缩放）
Img	scale(int width, int height) 缩放图像（按长宽缩放） 注意：目标长宽与原图不成比例会变形
Img	scale(int width, int height, java.awt.Color fixedColor) 缩放图像（按高度和宽度缩放） 缩放后默认为jpeg格式
Img	setDestImageType(java.lang.String imgType) 设置目标图片文件格式，用于写出
Img	setPositionBaseCentre(boolean positionBaseCentre) 计算x,y坐标的时候是否从中心做为原始坐标开始计算
void	write(java.io.File targetFile) 写出图像为目标文件扩展名对应的格式
void	write(javax.imageio.stream.ImageOutputStream destImageStream) 写出图像为PNG格式
void	write(java.io.OutputStream out) 写出图像

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

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

构造器详细资料

Img

public Img(java.awt.image.BufferedImage srcImage)

构造

参数:

srcImage - 来源图片

方法详细资料

from

public static Img from(java.io.File imageFile)

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

参数:

imageFile - 图片文件

返回:

Img

from

public static Img from(java.io.InputStream in)

从流读取图片并开始处理

参数:

in - 图片流

返回:

Img

from

public static Img from(javax.imageio.stream.ImageInputStream imageStream)

从ImageInputStream取图片并开始处理

参数:

imageStream - 图片流

返回:

Img

from

public static Img from(java.net.URL imageUrl)

从URL取图片并开始处理

参数:

imageUrl - 图片URL

返回:

Img

from

public static Img from(java.awt.Image image)

从Image取图片并开始处理

参数:

image - 图片

返回:

Img

setDestImageType

public Img setDestImageType(java.lang.String imgType)

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

参数:

imgType - 图片格式

返回:

this

另请参阅:

ImageUtil.IMAGE_TYPE_JPG, ImageUtil.IMAGE_TYPE_PNG

setPositionBaseCentre

public Img setPositionBaseCentre(boolean positionBaseCentre)

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

参数:

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

从以下版本开始:

4.1.15

scale

public Img scale(float scale)

缩放图像（按比例缩放）

参数:

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

返回:

this

scale

public Img scale(int width,
        int height)

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

参数:

width - 目标宽度

height - 目标高度

返回:

this

scale

public Img scale(int width,
        int height,
        java.awt.Color fixedColor)

缩放图像（按高度和宽度缩放）
缩放后默认为jpeg格式

参数:

width - 缩放后的宽度

height - 缩放后的高度

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

返回:

this

cut

public Img cut(java.awt.Rectangle rectangle)

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

参数:

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

返回:

this

cut

public Img cut(int x,
      int y)

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

参数:

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

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

返回:

this

从以下版本开始:

4.1.15

cut

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

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

参数:

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

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

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

返回:

this

从以下版本开始:

4.1.15

gray

public Img gray()

彩色转为黑白

返回:

this

binary

public Img binary()

彩色转为黑白二值化图片

返回:

this

pressText

public Img pressText(java.lang.String pressText,
            java.awt.Color color,
            java.awt.Font font,
            int x,
            int y,
            float alpha)

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

参数:

pressText - 水印文字

color - 水印的字体颜色

font - Font 字体相关信息

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

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

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

返回:

处理后的图像

pressImage

public Img pressImage(java.awt.Image pressImg,
             int x,
             int y,
             float alpha)

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

参数:

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

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

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

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

返回:

this

pressImage

public Img pressImage(java.awt.Image pressImg,
             java.awt.Rectangle rectangle,
             float alpha)

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

参数:

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

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

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

返回:

this

从以下版本开始:

4.1.14

rotate

public Img rotate(int degree)

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

参数:

degree - 旋转角度

返回:

旋转后的图片

从以下版本开始:

3.2.2

flip

public Img flip()

水平翻转图像

返回:

this

getImg

public java.awt.image.BufferedImage getImg()

获取处理过的图片

返回:

处理过的图片

write

public void write(java.io.OutputStream out)
           throws IORuntimeException

写出图像

参数:

out - 写出到的目标流

抛出:

IORuntimeException - IO异常

write

public void write(javax.imageio.stream.ImageOutputStream destImageStream)
           throws IORuntimeException

写出图像为PNG格式

参数:

destImageStream - 写出到的目标流

抛出:

IORuntimeException - IO异常

write

public void write(java.io.File targetFile)
           throws IORuntimeException

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

参数:

targetFile - 目标文件

抛出:

IORuntimeException - IO异常