net.gdface.image

Class ImageUtil

java.lang.Object

net.gdface.image.ImageUtil

public class ImageUtil
extends java.lang.Object

图像工具类

Author:

guyadong

Constructor Summary

Constructors

Constructor and Description
ImageUtil()

Method Summary

Modifier and Type	Method and Description
static java.awt.image.BufferedImage	copy(java.awt.image.BufferedImage src) 创建BufferedImage.TYPE_3BYTE_BGR类型的拷贝
static java.awt.image.BufferedImage	copy(java.awt.Image src, int imageType) 从源BufferedImage对象创建一份拷贝
static byte[]	createJPEGThumbnail(byte[] imageBytes, int thumbnailWidth, int thumbnailHeight, double ratioThreshold) 对原图创建JPEG格式的缩略图
static java.awt.image.BufferedImage	createRGBAImage(byte[] matrixRGBA, int width, int height) 从RGBA格式图像矩阵数据创建一个BufferedImage 该方法删除了alpha通道
static java.awt.image.BufferedImage	createRGBImage(byte[] matrixRGB, int width, int height) 从RGB格式图像矩阵数据创建一个BufferedImage
static java.awt.image.BufferedImage	createThumbnail(java.awt.image.BufferedImage source, int thumbnailWidth, int thumbnailHeight, double ratioThreshold) 对原图创建缩略图对象 如果原图尺寸小于指定的缩略图尺寸则直接返回原图对象的副本
static byte[]	cutMatrix(byte[] matrix, java.awt.Rectangle matrixRect, java.awt.Rectangle rect) 从matrix矩阵中截取rect指定区域的子矩阵
static byte[]	getMatrixBGR(java.awt.image.BufferedImage image) 对图像解码返回BGR格式矩阵数据
static byte[]	getMatrixGRAY(java.awt.image.BufferedImage image) 对图像解码返回BGR格式矩阵数据
static byte[]	getMatrixRGB(java.awt.image.BufferedImage image) 对图像解码返回RGB格式矩阵数据
static byte[]	getMatrixRGBA(java.awt.image.BufferedImage image) 对图像解码返回RGB格式矩阵数据
static java.awt.image.BufferedImage	growCanvas(java.awt.Image src, int left, int top, int right, int bottom)
static java.awt.image.BufferedImage	growCanvas(java.awt.Image src, int imageType, int left, int top, int right, int bottom) 将Image图像上下左右扩充指定的尺寸
static java.awt.image.BufferedImage	growSquareCanvas(java.awt.Image src) 将Image图像(向右下)扩充为正文形(尺寸长宽最大边)
static boolean	isBGR3Byte(java.awt.image.BufferedImage image)
static boolean	isBGRA(java.awt.image.BufferedImage image)
static boolean	isGray(java.awt.image.BufferedImage image)
static boolean	isRGB3Byte(java.awt.image.BufferedImage image)
static java.awt.image.BufferedImage	resize(java.awt.image.BufferedImage source, int targetWidth, int targetHeight, boolean constrain) 对图像进行缩放
static java.awt.image.BufferedImage	scale(java.awt.image.BufferedImage src, double scale) 对原图缩放，返回缩放后的新对象
static void	wirte(java.awt.image.BufferedImage source, java.lang.String formatName, java.lang.Float compressionQuality, java.io.OutputStream output) 将BufferedImage生成formatName指定格式的图像数据
static byte[]	wirteBMPBytes(java.awt.image.BufferedImage source)
static byte[]	wirteBytes(java.awt.image.BufferedImage source, java.lang.String formatName)
static byte[]	wirteBytes(java.awt.image.BufferedImage source, java.lang.String formatName, java.lang.Float compressionQuality) 将BufferedImage生成formatName指定格式的图像数据
static byte[]	wirteGIFBytes(java.awt.image.BufferedImage source)
static byte[]	wirteJPEGBytes(java.awt.image.BufferedImage source)
static byte[]	wirteJPEGBytes(java.awt.image.BufferedImage source, java.lang.Float compressionQuality) 将原图压缩生成jpeg格式的数据
static byte[]	wirtePNGBytes(java.awt.image.BufferedImage source)
static boolean	write(java.awt.image.RenderedImage source, java.lang.String formatName, java.io.OutputStream output, java.lang.Float compressionQuality) 将原图压缩生成formatName指定格式的数据 除了可以指定生成的图像质量之外， 其他行为与ImageIO.write(RenderedImage, String, OutputStream)相同

Methods inherited from class java.lang.Object

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

Constructor Detail

ImageUtil

public ImageUtil()

Method Detail

resize

public static java.awt.image.BufferedImage resize(java.awt.image.BufferedImage source,
                                                  int targetWidth,
                                                  int targetHeight,
                                                  boolean constrain)

对图像进行缩放

Parameters:

source - 原图

targetWidth - 缩放后图像宽度

targetHeight - 缩放后图像高度

constrain - 为true时等比例缩放，targetWidth,targetHeight为缩放图像的限制尺寸

Returns:

wirteJPEGBytes

public static byte[] wirteJPEGBytes(java.awt.image.BufferedImage source)

wirteBMPBytes

public static byte[] wirteBMPBytes(java.awt.image.BufferedImage source)

wirtePNGBytes

public static byte[] wirtePNGBytes(java.awt.image.BufferedImage source)

wirteGIFBytes

public static byte[] wirteGIFBytes(java.awt.image.BufferedImage source)

wirteJPEGBytes

public static byte[] wirteJPEGBytes(java.awt.image.BufferedImage source,
                                    java.lang.Float compressionQuality)

将原图压缩生成jpeg格式的数据

Parameters:

source -

Returns:

See Also:

wirteBytes(BufferedImage, String)

wirteBytes

public static byte[] wirteBytes(java.awt.image.BufferedImage source,
                                java.lang.String formatName)

wirteBytes

public static byte[] wirteBytes(java.awt.image.BufferedImage source,
                                java.lang.String formatName,
                                java.lang.Float compressionQuality)

将BufferedImage生成formatName指定格式的图像数据

Parameters:

source -

formatName - 图像格式名，图像格式名错误则抛出异常,可用的值 'BMP','PNG','GIF','JPEG'

compressionQuality - 压缩质量(0.0~1.0),超过此范围抛出异常,为null使用默认值

Returns:

wirte

public static void wirte(java.awt.image.BufferedImage source,
                         java.lang.String formatName,
                         java.lang.Float compressionQuality,
                         java.io.OutputStream output)
                  throws java.io.IOException

将BufferedImage生成formatName指定格式的图像数据

Parameters:

source -

formatName - 图像格式名，图像格式名错误则抛出异常,可用的值 'BMP','PNG','GIF','JPEG'

compressionQuality - 压缩质量(0.0~1.0),超过此范围抛出异常,为null使用默认值

output - 输出流

Throws:

java.io.IOException

createThumbnail

public static java.awt.image.BufferedImage createThumbnail(java.awt.image.BufferedImage source,
                                                           int thumbnailWidth,
                                                           int thumbnailHeight,
                                                           double ratioThreshold)

对原图创建缩略图对象
如果原图尺寸小于指定的缩略图尺寸则直接返回原图对象的副本

Parameters:

source - 原图对象

thumbnailWidth - 缩略图宽度

thumbnailHeight - 缩略图高度

ratioThreshold - 最大宽高比阀值(宽高中较大的值/较小的值)，<此值时对原图等比例缩放，>=此值时从原图切出中间部分图像再等比例缩放

Returns:

createJPEGThumbnail

public static byte[] createJPEGThumbnail(byte[] imageBytes,
                                         int thumbnailWidth,
                                         int thumbnailHeight,
                                         double ratioThreshold)

对原图创建JPEG格式的缩略图

Parameters:

imageBytes - 图像数据字节数组

thumbnailWidth -

thumbnailHeight -

ratioThreshold -

Returns:

返回jpeg格式的图像数据字节数组

See Also:

createThumbnail(BufferedImage, int, int, double), wirteJPEGBytes(BufferedImage)

isBGRA

public static boolean isBGRA(java.awt.image.BufferedImage image)

isGray

public static boolean isGray(java.awt.image.BufferedImage image)

isBGR3Byte

public static boolean isBGR3Byte(java.awt.image.BufferedImage image)

isRGB3Byte

public static boolean isRGB3Byte(java.awt.image.BufferedImage image)

getMatrixRGB

public static byte[] getMatrixRGB(java.awt.image.BufferedImage image)

对图像解码返回RGB格式矩阵数据

Parameters:

image -

Returns:

getMatrixRGBA

public static byte[] getMatrixRGBA(java.awt.image.BufferedImage image)

对图像解码返回RGB格式矩阵数据

Parameters:

image -

Returns:

getMatrixBGR

public static byte[] getMatrixBGR(java.awt.image.BufferedImage image)

对图像解码返回BGR格式矩阵数据

Parameters:

image -

Returns:

getMatrixGRAY

public static byte[] getMatrixGRAY(java.awt.image.BufferedImage image)

对图像解码返回BGR格式矩阵数据

Parameters:

image -

Returns:

copy

public static java.awt.image.BufferedImage copy(java.awt.Image src,
                                                int imageType)

从源BufferedImage对象创建一份拷贝

Parameters:

src -

imageType - 创建的BufferedImage目标对象类型

Returns:

返回拷贝的对象

See Also:

BufferedImage.BufferedImage(int, int, int)

copy

public static java.awt.image.BufferedImage copy(java.awt.image.BufferedImage src)

创建BufferedImage.TYPE_3BYTE_BGR类型的拷贝

Parameters:

src -

Returns:

返回拷贝的对象

See Also:

copy(Image, int)

scale

public static java.awt.image.BufferedImage scale(java.awt.image.BufferedImage src,
                                                 double scale)

对原图缩放，返回缩放后的新对象

Parameters:

src -

scale -

Returns:

返回缩放后的新对象

growCanvas

public static java.awt.image.BufferedImage growCanvas(java.awt.Image src,
                                                      int imageType,
                                                      int left,
                                                      int top,
                                                      int right,
                                                      int bottom)

将Image图像上下左右扩充指定的尺寸

Parameters:

src -

imageType -

left -

top -

right -

bottom -

Returns:

返回扩展尺寸后的新对象

growCanvas

public static java.awt.image.BufferedImage growCanvas(java.awt.Image src,
                                                      int left,
                                                      int top,
                                                      int right,
                                                      int bottom)

Parameters:

src -

left -

top -

right -

bottom -

Returns:

See Also:

growCanvas(Image, int, int, int, int, int)

growSquareCanvas

public static java.awt.image.BufferedImage growSquareCanvas(java.awt.Image src)

将Image图像(向右下)扩充为正文形(尺寸长宽最大边)

Parameters:

src -

Returns:

write

public static boolean write(java.awt.image.RenderedImage source,
                            java.lang.String formatName,
                            java.io.OutputStream output,
                            java.lang.Float compressionQuality)
                     throws java.io.IOException

将原图压缩生成formatName指定格式的数据
除了可以指定生成的图像质量之外， 其他行为与ImageIO.write(RenderedImage, String, OutputStream)相同

Parameters:

source -

formatName -

output -

compressionQuality - 指定图像质量,为null调用ImageIO.write(RenderedImage, String, OutputStream)

Returns:

Throws:

java.io.IOException

createRGBImage

public static java.awt.image.BufferedImage createRGBImage(byte[] matrixRGB,
                                                          int width,
                                                          int height)

从RGB格式图像矩阵数据创建一个BufferedImage

Parameters:

matrixRGB - RGB格式图像矩阵数据,为null则创建一个指定尺寸的空图像

width -

height -

Returns:

createRGBAImage

public static java.awt.image.BufferedImage createRGBAImage(byte[] matrixRGBA,
                                                           int width,
                                                           int height)

从RGBA格式图像矩阵数据创建一个BufferedImage
该方法删除了alpha通道

Parameters:

matrixRGBA - RGBA格式图像矩阵数据,为null则创建一个指定尺寸的空图像

width -

height -

Returns:

cutMatrix

public static byte[] cutMatrix(byte[] matrix,
                               java.awt.Rectangle matrixRect,
                               java.awt.Rectangle rect)

从matrix矩阵中截取rect指定区域的子矩阵

Parameters:

matrix - 3byte(RGB/BGR) 图像矩阵

matrixRect - 矩阵尺寸

rect - 截取区域

Returns: