com.liferay.portal.kernel.image
Class ImageToolUtil

java.lang.Object
  com.liferay.portal.kernel.image.ImageToolUtil

public class ImageToolUtil
extends java.lang.Object

The Image utility class.

Author:

Brian Wing Shun Chan, Alexander Chow

Constructor Summary

ImageToolUtil()

Method Summary

static java.util.concurrent.Future<java.awt.image.RenderedImage>	convertCMYKtoRGB(byte[] bytes, java.lang.String type) Returns the CMYK image converted to RGB using ImageMagick.
static java.awt.image.BufferedImage	convertImageType(java.awt.image.BufferedImage sourceImage, int type) Returns the image converted to the type.
static void	encodeGIF(java.awt.image.RenderedImage renderedImage, java.io.OutputStream os) Encodes the image using the GIF format.
static void	encodeWBMP(java.awt.image.RenderedImage renderedImage, java.io.OutputStream os) Encodes the image using the WBMP format.
static java.awt.image.BufferedImage	getBufferedImage(java.awt.image.RenderedImage renderedImage) Returns the rendered image as a BufferedImage.
static byte[]	getBytes(java.awt.image.RenderedImage renderedImage, java.lang.String contentType) Returns the image as a byte[].
static Image	getDefaultCompanyLogo()
static Image	getDefaultOrganizationLogo()
static Image	getDefaultSpacer()
static Image	getDefaultUserFemalePortrait()
static Image	getDefaultUserMalePortrait()
static Image	getImage(byte[] bytes)
static Image	getImage(java.io.File file)
static Image	getImage(java.io.InputStream is)
static Image	getImage(java.io.InputStream is, boolean cleanUpStream)
static ImageTool	getImageTool()
static boolean	isNullOrDefaultSpacer(byte[] bytes)
static ImageBag	read(byte[] bytes) Detects the image format and creates an ImageBag containing the RenderedImage and image type.
static ImageBag	read(java.io.File file) Detects the image format and creates an ImageBag containing the RenderedImage and image type.
static ImageBag	read(java.io.InputStream inputStream)
static java.awt.image.RenderedImage	scale(java.awt.image.RenderedImage renderedImage, int width) Returns the scaled image based on the given width with the height calculated to preserve aspect ratio.
static java.awt.image.RenderedImage	scale(java.awt.image.RenderedImage renderedImage, int maxHeight, int maxWidth) Returns the scaled image based on the maximum height and width given while preserving the aspect ratio.
void	setImageTool(ImageTool imageTool)
static void	write(java.awt.image.RenderedImage renderedImage, java.lang.String contentType, java.io.OutputStream os) Encodes the image using the content or image type.

Methods inherited from class java.lang.Object

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

Constructor Detail

ImageToolUtil

public ImageToolUtil()

Method Detail

convertCMYKtoRGB

public static java.util.concurrent.Future<java.awt.image.RenderedImage> convertCMYKtoRGB(byte[] bytes,
                                                                                         java.lang.String type)

Returns the CMYK image converted to RGB using ImageMagick. This must be run against the original byte[] and not one extracted from a RenderedImage. The latter may potentially have been already been read incorrectly.

Parameters:

bytes - the image to convert

type - the image type (e.g., "gif", "jpg", etc.)

Returns:

the asynchronous process converting the image or null if ImageMagick was disabled or if the conversion could not be completed. The conversion may not complete if (1) the image was not in the CMYK colorspace to begin with or (2) there was an error in the conversion process.

convertImageType

public static java.awt.image.BufferedImage convertImageType(java.awt.image.BufferedImage sourceImage,
                                                            int type)

Returns the image converted to the type.

Parameters:

sourceImage - the image to convert

type - the image type to convert to (e.g., "gif", "jpg", etc.)

Returns:

the converted image

encodeGIF

public static void encodeGIF(java.awt.image.RenderedImage renderedImage,
                             java.io.OutputStream os)
                      throws java.io.IOException

Encodes the image using the GIF format.

Parameters:

renderedImage - the image to encode

os - the stream to write to

Throws:

java.io.IOException - if an IO exception occurred

encodeWBMP

public static void encodeWBMP(java.awt.image.RenderedImage renderedImage,
                              java.io.OutputStream os)
                       throws java.io.IOException

Encodes the image using the WBMP format.

Parameters:

renderedImage - the image to encode

os - the stream to write to

Throws:

java.io.IOException - if an IO exception occurred

getBufferedImage

public static java.awt.image.BufferedImage getBufferedImage(java.awt.image.RenderedImage renderedImage)

Returns the rendered image as a BufferedImage.

Parameters:

renderedImage - the original image

Returns:

the converted image

getBytes

public static byte[] getBytes(java.awt.image.RenderedImage renderedImage,
                              java.lang.String contentType)
                       throws java.io.IOException

Returns the image as a byte[].

Parameters:

renderedImage - the image to read

contentType - the content type (e.g., "image/jpeg") or image type (e.g., "jpg") to use during encoding

Returns:

the encoded image

Throws:

java.io.IOException - if an IO exception occurred

getDefaultCompanyLogo

public static Image getDefaultCompanyLogo()

getDefaultOrganizationLogo

public static Image getDefaultOrganizationLogo()

getDefaultSpacer

public static Image getDefaultSpacer()

getDefaultUserFemalePortrait

public static Image getDefaultUserFemalePortrait()

getDefaultUserMalePortrait

public static Image getDefaultUserMalePortrait()

getImage

public static Image getImage(byte[] bytes)
                      throws java.io.IOException

Throws:

java.io.IOException

getImage

public static Image getImage(java.io.File file)
                      throws java.io.IOException

Throws:

java.io.IOException

getImage

public static Image getImage(java.io.InputStream is)
                      throws java.io.IOException

Throws:

java.io.IOException

getImage

public static Image getImage(java.io.InputStream is,
                             boolean cleanUpStream)
                      throws java.io.IOException

Throws:

java.io.IOException

getImageTool

public static ImageTool getImageTool()

isNullOrDefaultSpacer

public static boolean isNullOrDefaultSpacer(byte[] bytes)

read

public static ImageBag read(byte[] bytes)
                     throws java.io.IOException

Detects the image format and creates an ImageBag containing the RenderedImage and image type.

Parameters:

bytes - the bytes to read

Returns:

the ImageBag

Throws:

java.io.IOException - if an IO exception occurred

read

public static ImageBag read(java.io.File file)
                     throws java.io.IOException

Detects the image format and creates an ImageBag containing the RenderedImage and image type.

Parameters:

file - the file to read

Returns:

the ImageBag

Throws:

java.io.IOException - if an IO exception occurred

read

public static ImageBag read(java.io.InputStream inputStream)
                     throws java.io.IOException

Throws:

java.io.IOException

scale

public static java.awt.image.RenderedImage scale(java.awt.image.RenderedImage renderedImage,
                                                 int width)

Returns the scaled image based on the given width with the height calculated to preserve aspect ratio.

Parameters:

renderedImage - the image to scale

width - the new width; also used to calculate the new height

Returns:

the scaled image

scale

public static java.awt.image.RenderedImage scale(java.awt.image.RenderedImage renderedImage,
                                                 int maxHeight,
                                                 int maxWidth)

Returns the scaled image based on the maximum height and width given while preserving the aspect ratio. If the image is already larger in both dimensions, the image will not be scaled.

Parameters:

renderedImage - the image to scale

maxHeight - the maximum height allowed for image

maxWidth - the maximum width allowed for image

Returns:

the scaled image

write

public static void write(java.awt.image.RenderedImage renderedImage,
                         java.lang.String contentType,
                         java.io.OutputStream os)
                  throws java.io.IOException

Encodes the image using the content or image type.

Parameters:

renderedImage - the image to encode

contentType - the content type (e.g., "image/jpeg") or image type (e.g., "jpg") to use during encoding

os - the stream to write to

Throws:

java.io.IOException - if an IO exception occurred

setImageTool

public void setImageTool(ImageTool imageTool)