org.jahia.services.image

Class Java2DProgressiveBilinearImageService

java.lang.Object

org.jahia.services.image.AbstractImageService

org.jahia.services.image.AbstractJava2DImageService

org.jahia.services.image.Java2DProgressiveBilinearImageService

All Implemented Interfaces:

JahiaImageService

Direct Known Subclasses:

ImageJAndJava2DImageService

public class Java2DProgressiveBilinearImageService
extends AbstractJava2DImageService

Progressive Bilinear implementation of the Java 2D image operation.

This algorithm comes from http://code.google.com/p/thumbnailator/, itself used from the example code from the resizing technique discussed in Chapter 4: Images of Filthy Rich Clients by Chet Haase and Romain Guy.

Nested Class Summary

Nested classes/interfaces inherited from class org.jahia.services.image.AbstractJava2DImageService

AbstractJava2DImageService.OperationType

Nested classes/interfaces inherited from class org.jahia.services.image.AbstractImageService

AbstractImageService.ResizeCoords

Nested classes/interfaces inherited from interface org.jahia.services.image.JahiaImageService

JahiaImageService.ResizeType

Constructor Summary

Constructors

Constructor and Description
Java2DProgressiveBilinearImageService()

Method Summary

Modifier and Type	Method and Description
protected Graphics2D	getGraphics2D(BufferedImage dest, AbstractJava2DImageService.OperationType operationType)
BufferedImage	resizeImage(BufferedImage image, int width, int height, JahiaImageService.ResizeType resizeType) Resize an image using different types of resize algorithms.
boolean	resizeImage(Image image, File outputFile, int newWidth, int newHeight, JahiaImageService.ResizeType resizeType) Resize an image using different types of resize algorithms.

Methods inherited from class org.jahia.services.image.AbstractJava2DImageService

canRead, cropImage, getDestImage, getHeight, getImage, getWidth, rotateImage, rotateImage, saveImageToFile

Methods inherited from class org.jahia.services.image.AbstractImageService

createThumb, getResizeCoords, resizeImage

Methods inherited from class java.lang.Object

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

Constructor Detail

Java2DProgressiveBilinearImageService

public Java2DProgressiveBilinearImageService()

Method Detail

resizeImage

public boolean resizeImage(Image image,
                           File outputFile,
                           int newWidth,
                           int newHeight,
                           JahiaImageService.ResizeType resizeType)
                    throws IOException

Description copied from interface: JahiaImageService

Resize an image using different types of resize algorithms. Here is a detailed explanation of the different types of resize available : - ResizeType.SCALE_TO_FILL : this is the simplest algorithm. It will simply ignore the original image ratio and scale the image both horizontally and vertically to match the specified width and height. This will usually result in a deformed image and is usually not recommended. - ResizeType.ADJUST_SIZE : in this algorithm the width and height are more considered as desired sizes, but they will be modified to fit the aspect ratio of the original image. Note that the width and height will never be exceeded, so the resulting image will always be smaller than the specified one. - ResizeType.ASPECT_FILL : in this case the resulting image will have the exact specified size, and the image will be resized and cropped (using the center gravity crop) to fill the desired dimension. This will result in some of the image to be removed, but is usually acceptable for profile or icons. - ResizeType.ASPECT_FIT : in this last algorithm the desired image will have the exact specified size and the original image ratio is conserved, but borders will be added to the image to make it match the desired size.

Specified by:

resizeImage in interface JahiaImageService

Overrides:

resizeImage in class AbstractJava2DImageService

Parameters:

image - the image to resize

outputFile - the file in which to output the resized image

newWidth - the width of the resized image

newHeight - the height of the resized image

resizeType - the type of resize algorithm to use. Uses a ResizeType enum also available in this interface

Returns:

true if the resize succeeded, false otherwise.

Throws:

IOException

resizeImage

public BufferedImage resizeImage(BufferedImage image,
                                 int width,
                                 int height,
                                 JahiaImageService.ResizeType resizeType)

Description copied from interface: JahiaImageService

Resize an image using different types of resize algorithms.

Specified by:

resizeImage in interface JahiaImageService

Overrides:

resizeImage in class AbstractJava2DImageService

Parameters:

image - the image to resize

width - the width of the resized image

height - the height of the resized image

resizeType - the type of resize algorithm to use. Uses a JahiaImageService.ResizeType enum also available in this interface

Returns:

the result image or null in case of a failure

See Also:

for details of the resizing

getGraphics2D

protected Graphics2D getGraphics2D(BufferedImage dest,
                                   AbstractJava2DImageService.OperationType operationType)

Specified by:

getGraphics2D in class AbstractJava2DImageService