ImageUtil (xnx3-util 1.0.0 API)

java.lang.Object
- com.xnx3.media.ImageUtil

```
public class ImageUtil
extends Object
```
图片相关工具类

作者:

管雷鸣

构造器概要

构造器
构造器和说明

ImageUtil()

构造器
构造器和说明
`ImageUtil()`

方法概要

所有方法静态方法具体方法
限定符和类型	方法和说明
`static BufferedImage`	`bigImage(BufferedImage originalImage, Integer times)` 对图片进行放大
`static byte[]`	`bufferedImageToByte(BufferedImage bufferedImage, String imageSuffix)` 将 `BufferedImage` 转换为 `Byte`[]
`static InputStream`	`bufferedImageToInputStream(BufferedImage bufferedImage, String imageFileSuffix)` 将 `BufferedImage` 转换为 `InputStream`
`static BufferedImage`	`formatConversion(BufferedImage bufferedImage)` 后缀格式转换，读入 png、jpg、gif格式图片的 `BufferedImage` ，返回新生成的内存图像，可另行保存为png、jpg、gif等格式
`static BufferedImage`	`getBufferedImageByUrl(String imageUrl)` 通过一个图片所在的URL超链接，读取图片的 BufferedImage
`static String`	`getImageType(byte[] imageBytes)` 获取图片的类型。
`static BufferedImage`	`inputStreamToBufferedImage(InputStream is)` 将 `InputStream` 转化为 `BufferedImage`
`static byte[]`	`inputStreamToByte(InputStream is)` 将 `InputStream` 转换为 `Byte`[]
`static BufferedImage`	`loadLocalhostImage(String path)` 加载本地图像，变为 `BufferedImage`
`static BufferedImage`	`proportionZoom(BufferedImage bufferedImage, int maxWidth)` 等比例缩放判断图像的宽度，若是宽度大于传入的值，则进行等比例压缩到指定宽高。
`static InputStream`	`proportionZoom(InputStream inputStream, int maxWidth, String suffix)` 等比例缩放判断图像的宽度，若是宽度大于传入的值，则进行等比例压缩到指定宽高。
`static BufferedImage`	`replaceColor(BufferedImage bufferedImage, String oldHex, String newHex)` 替换 `BufferedImage`中，制定颜色进行替换，比如将图片中所有红色的像素点替换为黑色
`static void`	`saveToLocalhost(BufferedImage bufferedImage, String formatName, String path)` 将 `BufferedImage` 保存到本地
`static BufferedImage`	`watermark(BufferedImage originalImage, BufferedImage shuiyinImage, int startX, int startY, int width, int height)` 图片水印

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 构造器详细资料
  - ImageUtil
```
public ImageUtil()
```
- 方法详细资料
  - replaceColor
```
public static BufferedImage replaceColor(BufferedImage bufferedImage,
                                         String oldHex,
                                         String newHex)
```
    替换 BufferedImage中，制定颜色进行替换，比如将图片中所有红色的像素点替换为黑色
    
    参数:
    
    bufferedImage - 要替换的图像
    
    oldHex - 要替换的像素点十六进制颜色，如FFFFFF
    
    newHex - 替换成的新颜色，像素点十六进制颜色，如FFFFFF
    
    返回:
    
    新的图像BufferedImage
  - bigImage
```
public static BufferedImage bigImage(BufferedImage originalImage,
                                     Integer times)
```
    对图片进行放大
    
    参数:
    
    originalImage - 原始图片
    
    times - 放大倍数
    
    返回:
    
    放大后的图片
  - proportionZoom
```
public static InputStream proportionZoom(InputStream inputStream,
                                         int maxWidth,
                                         String suffix)
```
    等比例缩放
    判断图像的宽度，若是宽度大于传入的值，则进行等比例压缩到指定宽高。若是图片小于指定的值，则不处理
    
    参数:
    
    inputStream - 原图
    
    maxWidth - 缩放后的宽度。若大于这个宽度才会进行等比例缩放。否则不进行处理。传入0则不处理，忽略
    
    suffix - 图片的后缀名，如png、jpg
    
    返回:
    
    处理好的
  - proportionZoom
```
public static BufferedImage proportionZoom(BufferedImage bufferedImage,
                                           int maxWidth)
```
    等比例缩放
    判断图像的宽度，若是宽度大于传入的值，则进行等比例压缩到指定宽高。若是图片小于指定的值，则不处理
    
    参数:
    
    bufferedImage - 原图
    
    maxWidth - 缩放后的宽度。若大于这个宽度才会进行等比例缩放。否则不进行处理
    
    返回:
    
    处理好的
  - getBufferedImageByUrl
```
public static BufferedImage getBufferedImageByUrl(String imageUrl)
```
    通过一个图片所在的URL超链接，读取图片的 BufferedImage
    
    参数:
    
    imageUrl - 图片的URL超链接地址，如 http://www.leimingyun.com/a.jpg
    
    返回:
    
    将imageUrl的图片转化为 BufferedImage
  - inputStreamToBufferedImage
```
public static BufferedImage inputStreamToBufferedImage(InputStream is)
```
    将 InputStream 转化为 BufferedImage
    
    参数:
    
    is - 目标图片的InputStream
    
    返回:
    
    转换为的BufferedImage
  - inputStreamToByte
```
public static byte[] inputStreamToByte(InputStream is)
```
    将 InputStream 转换为 Byte[]
    
    参数:
    
    is - 目标图片的InputStream
    
    返回:
    
    转换好的Byte[]
  - getImageType
```
public static String getImageType(byte[] imageBytes)
```
    获取图片的类型。如果是 gif、jpg、png、bmp 以外的类型则返回null。
    
    参数:
    
    imageBytes - 图片字节数组。
    
    返回:
    
    图片类型。
  - bufferedImageToInputStream
```
public static InputStream bufferedImageToInputStream(BufferedImage bufferedImage,
                                                     String imageFileSuffix)
```
    将 BufferedImage 转换为 InputStream
    
    参数:
    
    bufferedImage - 要转换的 BufferedImage
    
    imageFileSuffix - 图片的后缀名，如 gif 、png 、 jpg 、 bmp
    
    返回:
    
    转换为的。如果本身输入为null，则这里返回的也是null
  - bufferedImageToByte
```
public static byte[] bufferedImageToByte(BufferedImage bufferedImage,
                                         String imageSuffix)
```
    将 BufferedImage 转换为 Byte[]
    
    参数:
    
    bufferedImage - 要转换的 BufferedImage
    
    imageSuffix - 图片的后缀名，如 gif 、png 、 jpg 、 bmp
    
    返回:
    
    Byte[] ，若是出错或没有，返回null
  - loadLocalhostImage
```
public static BufferedImage loadLocalhostImage(String path)
```
    加载本地图像，变为 BufferedImage
    
    参数:
    
    path - 图像所在路径，如： /images/ceshi.png
    
    返回:
    
    BufferedImage 若为空或图像不存在，返回null
  - saveToLocalhost
```
public static void saveToLocalhost(BufferedImage bufferedImage,
                                   String formatName,
                                   String path)
```
    将 BufferedImage 保存到本地
    
    参数:
    
    bufferedImage - 要保存的内存图像
    
    formatName - 如 jpg、 png、gif
    
    path - 本地路径，如 /images/xnx3/ceshiaaaa.png
  - formatConversion
```
public static BufferedImage formatConversion(BufferedImage bufferedImage)
```
    后缀格式转换，读入 png、jpg、gif格式图片的 BufferedImage ，返回新生成的内存图像，可另行保存为png、jpg、gif等格式
    
    参数:
    
    bufferedImage - 要输入的图片的 BufferedImage
    
    返回:
    
    新创建的 BufferedImage
  - watermark
```
public static BufferedImage watermark(BufferedImage originalImage,
                                      BufferedImage shuiyinImage,
                                      int startX,
                                      int startY,
                                      int width,
                                      int height)
```
    图片水印
    
    参数:
    
    originalImage - 原图，大图。比如，可用 getBufferedImageByUrl(String) 获取
    
    shuiyinImage - 水印图，小图，要水印到大图的水印图。
    
    startX - 水印开始地点，原图的左上角，X坐标
    
    startY - 水印开始地点，原图的左上角，Y坐标
    
    width - 宽度的像素点，会将整个图片压缩或放大整个图水印上。
    
    height - 高度的像素点
    
    返回:
    
    已经水印好的图片的 BufferedImage 对象

类 ImageUtil

构造器概要

方法概要

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

构造器详细资料

ImageUtil

方法详细资料

replaceColor

bigImage

proportionZoom

proportionZoom

getBufferedImageByUrl

inputStreamToBufferedImage

inputStreamToByte

getImageType

bufferedImageToInputStream

bufferedImageToByte

loadLocalhostImage

saveToLocalhost

formatConversion

watermark