Image (bus-all 5.8.2 API)

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:

5.8.2

Author:

Kimi Liu

See Also:

Serialized Form

Constructor Summary

Constructors
Constructor and Description

Image(BufferedImage srcImage)
构造

Constructors
Constructor and Description
`Image(BufferedImage srcImage)` 构造

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
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.TYPE_JPG, FileType.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:
    
    5.8.2
  - 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异常

Class Image

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

Image

Method Detail

from

from

from

from

from

from

from

setTargetImageType

setPositionBaseCentre

setQuality

setQuality

scale

scale

scale

cut

cut

cut

round

gray

binary

pressText

pressImage

pressImage

rotate

flip

getImg

write

write

write