net.gdface.image

Class LazyImage

java.lang.Object

net.gdface.image.BaseLazyImage

net.gdface.image.LazyImage

All Implemented Interfaces:

ImageMatrix

public class LazyImage
extends BaseLazyImage
implements ImageMatrix

图像数据处理对象
open()可以在不将图像全部解码加载到内存而获取图像的基本信息
read(ImageReadParam)使用内存做cache读取(不使用临时文件做cache)
read(Rectangle, ImageTypeSpecifier)可以对图像指定区域解码

Author:

guyadong

Field Summary

Fields inherited from class net.gdface.image.BaseLazyImage

autoClose, height, imgBytes, localFile, matrixBGR, matrixGray, matrixRGB, matrixRGBA, md5, suffix, width

Constructor Summary

Constructors

Constructor and Description
LazyImage(java.awt.image.BufferedImage bufferedImage)
LazyImage(byte[] imgBytes)
LazyImage(java.io.File src, java.lang.String md5) 用本地图像文件创建对象
LazyImage(T src) 多源创建对象

Method Summary

Modifier and Type	Method and Description
void	close() 释放资源
static LazyImage	create(java.awt.image.BufferedImage bufferedImage) 创建对象
static LazyImage	create(byte[] imgBytes) 创建并打开对象
static LazyImage	create(java.io.File file, java.lang.String md5) 用本地图像文件创建对象
static <T> LazyImage	create(T src) 多源创建对象
void	finalize()
byte[]	getMatrixBGR() 对图像解码返回BGR格式矩阵数据
byte[]	getMatrixGray() 对图像数据指定的区域解码返回灰度图像数据
byte[]	getMatrixRGB() 对图像解码返回RGB格式矩阵数据
byte[]	getMatrixRGBA() 对图像解码返回RGBA格式矩阵数据
java.awt.Rectangle	getRectangle() 获取图像矩形对象
LazyImage	open() 通过ImageReader来读取图像基本信息，检查图像数据有效性
java.awt.image.BufferedImage	read()
protected java.awt.image.BufferedImage	read(javax.imageio.ImageReadParam param) 对图像数据解码生成 BufferedImage对象
java.awt.image.BufferedImage	read(java.awt.Rectangle rect, javax.imageio.ImageTypeSpecifier destinationType) 对图像数据指定的区域解码
byte[]	wirteJPEGBytes()
byte[]	wirtePNGBytes()

Methods inherited from class net.gdface.image.BaseLazyImage

getHeight, getImgBytes, getLazyImageFactory, getLocalFile, getMd5, getSuffix, getWidth, save, setAutoClose, wirteJPEG, wirtePNGB

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.gdface.image.ImageMatrix

getHeight, getWidth

Constructor Detail

LazyImage

public LazyImage(java.awt.image.BufferedImage bufferedImage)

Parameters:

bufferedImage - 已经解码的图像数据,为null或为空,则抛出 IllegalArgumentException

LazyImage

public LazyImage(byte[] imgBytes)

Parameters:

imgBytes - 图像数据,imgBytes为null或为空,则抛出 IllegalArgumentException

LazyImage

public LazyImage(java.io.File src,
                 java.lang.String md5)
          throws java.io.FileNotFoundException

用本地图像文件创建对象

Parameters:

src -

md5 -

Throws:

java.io.FileNotFoundException

LazyImage

public LazyImage(T src)
          throws java.io.IOException

多源创建对象

Parameters:

src -

Throws:

java.io.IOException

See Also:

FaceUtilits.getBytesNotEmpty(Object)

Method Detail

open

public LazyImage open()
               throws UnsupportedFormatException,
                      NotImageException

通过ImageReader来读取图像基本信息，检查图像数据有效性

Specified by:

open in class BaseLazyImage

Returns:

Throws:

UnsupportedFormatException

NotImageException

read

protected java.awt.image.BufferedImage read(javax.imageio.ImageReadParam param)
                                     throws UnsupportedFormatException

对图像数据解码生成 BufferedImage对象

Parameters:

param - 图像读取参数对象,为null使用默认参数
参见 ImageReader.getDefaultReadParam()

Returns:

Throws:

UnsupportedFormatException

See Also:

ImageReadParam

read

public java.awt.image.BufferedImage read()
                                  throws UnsupportedFormatException

Throws:

UnsupportedFormatException

read

public java.awt.image.BufferedImage read(java.awt.Rectangle rect,
                                         javax.imageio.ImageTypeSpecifier destinationType)
                                  throws UnsupportedFormatException

对图像数据指定的区域解码

Parameters:

rect - 解码区域对象, 默认(null)全图解码
参见 IIOParam.setSourceRegion(Rectangle)

destinationType - 目标图像的所需图像类型,默认为null,
例如用此参数可以在解码时指定输出的图像类型为RGB,
如下代码 生成 destinationType参数对象：
ImageTypeSpecifier destinationType=ImageTypeSpecifier.createFromBufferedImageType(BufferedImage.TYPE_3BYTE_BGR);
用上面的ImageTypeSpecifier对象来调用此方法返回的BufferedImage对象中的raster成员(通过BufferedImage.getData()获取) 的getDataElements()方法返回的就是包含RGB数据byte[]类型的数组
而直接用BufferedImage.getRGB()方式只能获取ARGB类型的int[]数组 参见 ImageReadParam.setDestinationType(ImageTypeSpecifier)

Returns:

Throws:

UnsupportedFormatException

See Also:

read(ImageReadParam)

getMatrixRGBA

public byte[] getMatrixRGBA()
                     throws UnsupportedFormatException

Description copied from interface: ImageMatrix

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

Specified by:

getMatrixRGBA in interface ImageMatrix

Returns:

Throws:

UnsupportedFormatException

getMatrixRGB

public byte[] getMatrixRGB()
                    throws UnsupportedFormatException

Description copied from interface: ImageMatrix

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

Specified by:

getMatrixRGB in interface ImageMatrix

Returns:

Throws:

UnsupportedFormatException

getMatrixBGR

public byte[] getMatrixBGR()
                    throws UnsupportedFormatException

Description copied from interface: ImageMatrix

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

Specified by:

getMatrixBGR in interface ImageMatrix

Returns:

Throws:

UnsupportedFormatException

getMatrixGray

public byte[] getMatrixGray()
                     throws UnsupportedFormatException

对图像数据指定的区域解码返回灰度图像数据

Specified by:

getMatrixGray in interface ImageMatrix

Returns:

灰度图像矩阵数据

Throws:

UnsupportedFormatException

wirtePNGBytes

public byte[] wirtePNGBytes()

Specified by:

wirtePNGBytes in class BaseLazyImage

wirteJPEGBytes

public byte[] wirteJPEGBytes()

Specified by:

wirteJPEGBytes in class BaseLazyImage

create

public static LazyImage create(byte[] imgBytes)
                        throws NotImageException,
                               UnsupportedFormatException

创建并打开对象

Parameters:

imgBytes -

Returns:

Throws:

NotImageException

UnsupportedFormatException

See Also:

LazyImage(byte[]), open()

create

public static LazyImage create(java.awt.image.BufferedImage bufferedImage)

创建对象

Parameters:

bufferedImage -

Returns:

See Also:

LazyImage(BufferedImage), open()

create

public static LazyImage create(java.io.File file,
                               java.lang.String md5)
                        throws NotImageException,
                               UnsupportedFormatException

用本地图像文件创建对象

Parameters:

file -

md5 - file的MD5较验码，可以为null

Returns:

Throws:

NotImageException

UnsupportedFormatException

create

public static <T> LazyImage create(T src)
                            throws NotImageException,
                                   UnsupportedFormatException

多源创建对象

Parameters:

src -

Returns:

Throws:

NotImageException

UnsupportedFormatException

See Also:

LazyImage(Object), FaceUtilits.getBytesNotEmpty(Object)

close

public void close()
           throws java.io.IOException

释放资源

Overrides:

close in class BaseLazyImage

Throws:

java.io.IOException

finalize

public void finalize()
              throws java.lang.Throwable

Overrides:

finalize in class BaseLazyImage

Throws:

java.lang.Throwable

getRectangle

public java.awt.Rectangle getRectangle()

获取图像矩形对象

Returns:

rectangle