OperateImage (0opslab-utils 1.0.0 API)

java.lang.Object
- com.opslab.image.OperateImage

public class OperateImage
extends Object

图片相关的操作

作者:: adam.胡升阳

字段概要

字段
限定符和类型	字段和说明
`static String`	`IMAGE_TYPE_BMP`
`static String`	`IMAGE_TYPE_GIF`
`static String`	`IMAGE_TYPE_JPEG`
`static String`	`IMAGE_TYPE_JPG`
`static String`	`IMAGE_TYPE_PNG`
`static String`	`IMAGE_TYPE_PSD`

构造器概要

构造器
构造器和说明

OperateImage()

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

方法概要

方法
限定符和类型	方法和说明
`static void`	`alphaImage2Image(String srcImagePath, String appendImagePath, float alpha, int x, int y, int width, int height, String imageFormat, String toPath)` 在源图像上设置图片水印 ---- 当alpha==1时文字不透明（和在图片上直接输入文字效果一样）
`static void`	`alphaWords2Image(String srcImagePath, float alpha, String font, int fontStyle, int fontSize, Color color, String inputWords, int x, int y, String imageFormat, String toPath)` 在源图片上设置水印文字
`static void`	`cropImage(String srcPath, String toPath, int x, int y, int width, int height, String readImageFormat, String writeImageFormat)` 对图片裁剪，并把裁剪新图片保存
`static void`	`drawAndAlphaPolygon(String srcImagePath, int[] xPoints, int[] yPoints, int nPoints, Color polygonColor, float alpha, String imageFormat, String toPath)` 绘制并填充多边形
`static void`	`drawLine(String srcImagePath, int x1, int y1, int x2, int y2, Color lineColor, String toPath, String imageFormat)` 画线段
`static void`	`drawPoint(String srcImagePath, int x, int y, int width, int height, Color ovalColor, String imageFormat, String toPath)` 画单点 ---- 实际上是画一个填充颜色的圆 ---- 以指定点坐标为中心画一个小半径的圆形，并填充其颜色来充当点
`static void`	`drawPoints(String srcImagePath, List pointList, int width, int height, Color ovalColor, String imageFormat, String toPath)` 画一组（多个）点---- 实际上是画一组（多个）填充颜色的圆 ---- 以指定点坐标为中心画一个小半径的圆形，并填充其颜色来充当点
`static void`	`drawPolygon(String srcImagePath, int[] xPoints, int[] yPoints, int nPoints, Color polygonColor, String imageFormat, String toPath)` 绘制一个由 x 和 y 坐标数组定义的闭合多边形
`static void`	`drawPolyline(String srcImagePath, int[] xPoints, int[] yPoints, int nPoints, Color lineColor, String toPath, String imageFormat)` 画折线 / 线段 ---- 2个点即画线段，多个点画折线
`static void`	`drawPolylineShowPoints(String srcImagePath, int[] xPoints, int[] yPoints, int nPoints, Color lineColor, int width, int height, Color ovalColor, String toPath, String imageFormat)` 绘制折线，并突出显示转折点
`static void`	`enlargementImageByRatio(String srcImagePath, String toImagePath, int widthRatio, int heightRatio)` 按倍率放大图片
`static void`	`enlargementImageEqualProportion(String srcImagePath, String toImagePath, int ratio)` 长高等比例放大图片
`static void`	`grayImage(String srcImage, String toPath, String imageFormat)` 图片灰化操作
`static boolean`	`joinImageListHorizontal(String[] pics, String type, String dst_pic)` 横向拼接一组（多张）图像
`static boolean`	`joinImageListVertical(String[] pics, String type, String dst_pic)` 纵向拼接一组（多张）图像
`static void`	`joinImagesHorizontal(String firstSrcImagePath, String secondSrcImagePath, String imageFormat, String toPath)` 横向拼接图片（两张）
`static void`	`joinImagesVertical(String firstSrcImagePath, String secondSrcImagePath, String imageFormat, String toPath)` 纵向拼接图片（两张）
`static void`	`mergeBothImage(String negativeImagePath, String additionImagePath, String iamgeFromat, int x, int y, String toPath)` 合并图片(按指定初始x、y坐标将附加图片贴到底图之上)
`static void`	`mergeImageList(String negativeImagePath, List additionImageList, String imageFormat, String toPath)` 将一组图片一次性附加合并到底图上
`static void`	`reduceImageByRatio(String srcImagePath, String toImagePath, int widthRatio, int heightRatio)` 按倍率缩小图片
`static void`	`reduceImageEqualProportion(String srcImagePath, String toImagePath, int ratio)` 长高等比例缩小图片
`static void`	`resizeImage(String srcImagePath, String toImagePath, int width, int height)` 重置图形的边长大小

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

字段详细资料

IMAGE_TYPE_GIF
```
public static String IMAGE_TYPE_GIF
```

IMAGE_TYPE_JPG
```
public static String IMAGE_TYPE_JPG
```

IMAGE_TYPE_JPEG
```
public static String IMAGE_TYPE_JPEG
```

IMAGE_TYPE_BMP
```
public static String IMAGE_TYPE_BMP
```

IMAGE_TYPE_PNG
```
public static String IMAGE_TYPE_PNG
```

IMAGE_TYPE_PSD
```
public static String IMAGE_TYPE_PSD
```

构造器详细资料
- OperateImage
```
public OperateImage()
```

方法详细资料

cropImage

public static void cropImage(String srcPath,
             String toPath,
             int x,
             int y,
             int width,
             int height,
             String readImageFormat,
             String writeImageFormat)
                      throws IOException

对图片裁剪，并把裁剪新图片保存

参数:: srcPath - 读取源图片路径; toPath - 写入图片路径; x - 剪切起始点x坐标; y - 剪切起始点y坐标; width - 剪切宽度; height - 剪切高度; readImageFormat - 读取图片格式; writeImageFormat - 写入图片格式
抛出:: IOException

reduceImageByRatio

public static void reduceImageByRatio(String srcImagePath,
                      String toImagePath,
                      int widthRatio,
                      int heightRatio)
                               throws IOException

按倍率缩小图片

参数:: srcImagePath - 读取图片路径; toImagePath - 写入图片路径; widthRatio - 宽度缩小比例; heightRatio - 高度缩小比例
抛出:: IOException

reduceImageEqualProportion

public static void reduceImageEqualProportion(String srcImagePath,
                              String toImagePath,
                              int ratio)
                                       throws IOException

长高等比例缩小图片

参数:: srcImagePath - 读取图片路径; toImagePath - 写入图片路径; ratio - 缩小比例
抛出:: IOException

enlargementImageByRatio

public static void enlargementImageByRatio(String srcImagePath,
                           String toImagePath,
                           int widthRatio,
                           int heightRatio)
                                    throws IOException

按倍率放大图片

参数:: srcImagePath - 读取图形路径; toImagePath - 写入入行路径; widthRatio - 宽度放大比例; heightRatio - 高度放大比例
抛出:: IOException

enlargementImageEqualProportion

public static void enlargementImageEqualProportion(String srcImagePath,
                                   String toImagePath,
                                   int ratio)
                                            throws IOException

长高等比例放大图片

参数:: srcImagePath - 读取图形路径; toImagePath - 写入入行路径; ratio - 放大比例
抛出:: IOException

resizeImage

public static void resizeImage(String srcImagePath,
               String toImagePath,
               int width,
               int height)
                        throws IOException

重置图形的边长大小

参数:: srcImagePath - 原图像; toImagePath - 新生产的图像; width - 图像宽度; height - 图像高度
抛出:: IOException

joinImagesHorizontal

public static void joinImagesHorizontal(String firstSrcImagePath,
                        String secondSrcImagePath,
                        String imageFormat,
                        String toPath)

横向拼接图片（两张）

参数:: firstSrcImagePath - 第一张图片的路径; secondSrcImagePath - 第二张图片的路径; imageFormat - 拼接生成图片的格式; toPath - 拼接生成图片的路径要拼接的俩张图片尺寸要一致

joinImageListHorizontal

public static boolean joinImageListHorizontal(String[] pics,
                              String type,
                              String dst_pic)

横向拼接一组（多张）图像

参数:: pics - 将要拼接的图像; type - 图像写入格式; dst_pic - 图像写入路径
返回:

joinImagesVertical

public static void joinImagesVertical(String firstSrcImagePath,
                      String secondSrcImagePath,
                      String imageFormat,
                      String toPath)

纵向拼接图片（两张）

参数:: firstSrcImagePath - 读取的第一张图片; secondSrcImagePath - 读取的第二张图片; imageFormat - 图片写入格式; toPath - 图片写入路径

joinImageListVertical

public static boolean joinImageListVertical(String[] pics,
                            String type,
                            String dst_pic)

纵向拼接一组（多张）图像

参数:: pics - 将要拼接的图像数组; type - 写入图像类型; dst_pic - 写入图像路径
返回:

mergeBothImage

public static void mergeBothImage(String negativeImagePath,
                  String additionImagePath,
                  String iamgeFromat,
                  int x,
                  int y,
                  String toPath)
                           throws IOException

合并图片(按指定初始x、y坐标将附加图片贴到底图之上)

参数:: negativeImagePath - 背景图片路径; additionImagePath - 附加图片路径; x - 附加图片的起始点x坐标; y - 附加图片的起始点y坐标; toPath - 图片写入路径
抛出:: IOException

mergeImageList

public static void mergeImageList(String negativeImagePath,
                  List additionImageList,
                  String imageFormat,
                  String toPath)
                           throws IOException

将一组图片一次性附加合并到底图上

参数:: negativeImagePath - 源图像（底图）路径; additionImageList - 附加图像信息列表; imageFormat - 图像写入格式; toPath - 图像写入路径
抛出:: IOException

grayImage

public static void grayImage(String srcImage,
             String toPath,
             String imageFormat)

图片灰化操作

参数:: srcImage - 读取图片路径; toPath - 写入灰化后的图片路径; imageFormat - 图片写入格式

alphaWords2Image

public static void alphaWords2Image(String srcImagePath,
                    float alpha,
                    String font,
                    int fontStyle,
                    int fontSize,
                    Color color,
                    String inputWords,
                    int x,
                    int y,
                    String imageFormat,
                    String toPath)
                             throws IOException

在源图片上设置水印文字

参数:: srcImagePath - 源图片路径; alpha - 透明度（0; font - 字体（例如：宋体）; fontStyle - 字体格式(例如：普通样式--Font.PLAIN、粗体--Font.BOLD ); fontSize - 字体大小; color - 字体颜色(例如：黑色--Color.BLACK); inputWords - 输入显示在图片上的文字; x - 文字显示起始的x坐标; y - 文字显示起始的y坐标; imageFormat - 写入图片格式（png/jpg等）; toPath - 写入图片路径
抛出:: IOException

alphaImage2Image

public static void alphaImage2Image(String srcImagePath,
                    String appendImagePath,
                    float alpha,
                    int x,
                    int y,
                    int width,
                    int height,
                    String imageFormat,
                    String toPath)
                             throws IOException

在源图像上设置图片水印 ---- 当alpha==1时文字不透明（和在图片上直接输入文字效果一样）

参数:: srcImagePath - 源图片路径; appendImagePath - 水印图片路径; alpha - 透明度; x - 水印图片的起始x坐标; y - 水印图片的起始y坐标; width - 水印图片的宽度; height - 水印图片的高度; imageFormat - 图像写入图片格式; toPath - 图像写入路径
抛出:: IOException

drawPoint
```
public static void drawPoint(String srcImagePath,
             int x,
             int y,
             int width,
             int height,
             Color ovalColor,
             String imageFormat,
             String toPath)
                      throws IOException
```
画单点 ---- 实际上是画一个填充颜色的圆 ---- 以指定点坐标为中心画一个小半径的圆形，并填充其颜色来充当点

参数:
srcImagePath - 源图片颜色
x - 点的x坐标
y - 点的y坐标
width - 填充的宽度
height - 填充的高度
ovalColor - 填充颜色
imageFormat - 写入图片格式
toPath - 写入路径

抛出:

IOException

drawPoints
```
public static void drawPoints(String srcImagePath,
              List pointList,
              int width,
              int height,
              Color ovalColor,
              String imageFormat,
              String toPath)
                       throws IOException
```
画一组（多个）点---- 实际上是画一组（多个）填充颜色的圆 ---- 以指定点坐标为中心画一个小半径的圆形，并填充其颜色来充当点

参数:
srcImagePath - 原图片路径
pointList - 点列表
width - 宽度
height - 高度
ovalColor - 填充颜色
imageFormat - 写入图片颜色
toPath - 写入路径

抛出:

IOException

drawLine

public static void drawLine(String srcImagePath,
            int x1,
            int y1,
            int x2,
            int y2,
            Color lineColor,
            String toPath,
            String imageFormat)
                     throws IOException

画线段

参数:: srcImagePath - 源图片路径; x1 - 第一个点x坐标; y1 - 第一个点y坐标; x2 - 第二个点x坐标; y2 - 第二个点y坐标; lineColor - 线条颜色; toPath - 图像写入路径; imageFormat - 图像写入格式
抛出:: IOException

drawPolyline

public static void drawPolyline(String srcImagePath,
                int[] xPoints,
                int[] yPoints,
                int nPoints,
                Color lineColor,
                String toPath,
                String imageFormat)
                         throws IOException

画折线 / 线段 ---- 2个点即画线段，多个点画折线

参数:: srcImagePath - 源图片路径; xPoints - x坐标数组; yPoints - y坐标数组; nPoints - 点的数量; lineColor - 线条颜色; toPath - 图像写入路径; imageFormat - 图片写入格式
抛出:: IOException

drawPolylineShowPoints

public static void drawPolylineShowPoints(String srcImagePath,
                          int[] xPoints,
                          int[] yPoints,
                          int nPoints,
                          Color lineColor,
                          int width,
                          int height,
                          Color ovalColor,
                          String toPath,
                          String imageFormat)
                                   throws IOException

绘制折线，并突出显示转折点

参数:: srcImagePath - 源图片路径; xPoints - x坐标数组; yPoints - y坐标数组; nPoints - 点的数量; lineColor - 连线颜色; width - 点的宽度; height - 点的高度; ovalColor - 点的填充颜色; toPath - 图像写入路径; imageFormat - 图像写入格式
抛出:: IOException

drawPolygon

public static void drawPolygon(String srcImagePath,
               int[] xPoints,
               int[] yPoints,
               int nPoints,
               Color polygonColor,
               String imageFormat,
               String toPath)
                        throws IOException

绘制一个由 x 和 y 坐标数组定义的闭合多边形

参数:: srcImagePath - 源图片路径; xPoints - x坐标数组; yPoints - y坐标数组; nPoints - 坐标点的个数; polygonColor - 线条颜色; imageFormat - 图像写入格式; toPath - 图像写入路径
抛出:: IOException

drawAndAlphaPolygon

public static void drawAndAlphaPolygon(String srcImagePath,
                       int[] xPoints,
                       int[] yPoints,
                       int nPoints,
                       Color polygonColor,
                       float alpha,
                       String imageFormat,
                       String toPath)
                                throws IOException

绘制并填充多边形

参数:: srcImagePath - 源图像路径; xPoints - x坐标数组; yPoints - y坐标数组; nPoints - 坐标点个数; polygonColor - 多边形填充颜色; alpha - 多边形部分透明度; imageFormat - 写入图形格式; toPath - 写入图形路径
抛出:: IOException

类 OperateImage

字段概要

构造器概要

方法概要

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

字段详细资料

IMAGE_TYPE_GIF

IMAGE_TYPE_JPG

IMAGE_TYPE_JPEG

IMAGE_TYPE_BMP

IMAGE_TYPE_PNG

IMAGE_TYPE_PSD

构造器详细资料

OperateImage