com.day.crx.packaging.gfx

Class ImageResource

java.lang.Object

com.day.crx.packaging.gfx.DownloadResource

com.day.crx.packaging.gfx.ImageResource

public class ImageResource
extends DownloadResource

Provides convenience methods for displaying images.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	PN_ALT name of the alt name property
static java.lang.String	PN_HEIGHT name of the height property
static java.lang.String	PN_HTML_HEIGHT name of the html height property
static java.lang.String	PN_HTML_WIDTH name of the html width property
static java.lang.String	PN_IMAGE_CROP name of the image crop property
static java.lang.String	PN_IMAGE_ROTATE name of the image rotation property
static java.lang.String	PN_LINK_URL name of the link URL property
static java.lang.String	PN_MAX_HEIGHT name of the maximal height property.
static java.lang.String	PN_MAX_WIDTH name of the maximal width property.
static java.lang.String	PN_MIN_HEIGHT name of the minimal height property.
static java.lang.String	PN_MIN_WIDTH name of the minimal width property.
static java.lang.String	PN_WIDTH name of the width property

Fields inherited from class com.day.crx.packaging.gfx.DownloadResource

NN_FILE, PN_DESCRIPTION, PN_FILE_NAME, PN_REFERENCE, PN_TITLE

Constructor Summary

Constructors

Constructor and Description
ImageResource(Node node) Creates a new image based on the given resource.
ImageResource(Node resource, java.lang.String imageName) Creates a new image based on the given resource.

Method Summary

Modifier and Type	Method and Description
Layer	crop(Layer layer) Crops the layer using the internal crop rectangle.
void	draw(java.io.Writer w) Writes this image as tag to the given writer by invoking doDraw(PrintWriter) if canDraw() returns true.
java.lang.String	getAlt() Returns the image alt name as defined by the "alt" or overridden by setAlt(String).
java.awt.Rectangle	getCropRect() Returns the cropping rectangle as defined by the "imageCrop".
java.lang.String	getExtension() Tries to calculate the extension from the mime-type of the underlying image.
Layer	getLayer(boolean cropped, boolean resized, boolean rotated) Returns the layer addressed by this image.
int	getRotation() Returns the rotation angle as defined by the "imageRotate".
java.lang.String	getSrc() Returns the source attribute of this image.
Layer	resize(Layer layer) Resizes the given layer according to the dimensions defined in this image.
Layer	rotate(Layer layer) Rotates the layer using the internal rotation angle.
void	setAlt(java.lang.String alt) Sets the alt name.
void	setExtension(java.lang.String extension) Sets the extension.
void	setSrc(java.lang.String src) Sets the source attribute

Methods inherited from class com.day.crx.packaging.gfx.DownloadResource

addAttribute, addCssClass, get, get, getAttributes, getData, getDescription, getDescription, getFileName, getFileNodePath, getFileReference, getHref, getIconPath, getIconType, getInnerHtml, getItemName, getLastModified, getMimeType, getPath, getSelector, getString, getSuffix, getTitle, getTitle, hasContent, init, set, setDescription, setFileName, setFileNodePath, setFileReference, setHref, setInnerHtml, setItemName, setSelector, setSuffix, setTitle

Methods inherited from class java.lang.Object

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

Field Detail

PN_HTML_WIDTH

public static final java.lang.String PN_HTML_WIDTH

name of the html width property

See Also:

Constant Field Values

PN_HTML_HEIGHT

public static final java.lang.String PN_HTML_HEIGHT

name of the html height property

See Also:

Constant Field Values

PN_WIDTH

public static final java.lang.String PN_WIDTH

name of the width property

See Also:

Constant Field Values

PN_HEIGHT

public static final java.lang.String PN_HEIGHT

name of the height property

See Also:

Constant Field Values

PN_MIN_WIDTH

public static final java.lang.String PN_MIN_WIDTH

name of the minimal width property. used for resizing.

See Also:

Constant Field Values

PN_MIN_HEIGHT

public static final java.lang.String PN_MIN_HEIGHT

name of the minimal height property. used for resizing.

See Also:

Constant Field Values

PN_MAX_WIDTH

public static final java.lang.String PN_MAX_WIDTH

name of the maximal width property. used for resizing.

See Also:

Constant Field Values

PN_MAX_HEIGHT

public static final java.lang.String PN_MAX_HEIGHT

name of the maximal height property. used for resizing.

See Also:

Constant Field Values

PN_ALT

public static final java.lang.String PN_ALT

name of the alt name property

See Also:

Constant Field Values

PN_IMAGE_CROP

public static final java.lang.String PN_IMAGE_CROP

name of the image crop property

See Also:

Constant Field Values

PN_IMAGE_ROTATE

public static final java.lang.String PN_IMAGE_ROTATE

name of the image rotation property

See Also:

Constant Field Values

PN_LINK_URL

public static final java.lang.String PN_LINK_URL

name of the link URL property

See Also:

Constant Field Values

Constructor Detail

ImageResource

public ImageResource(Node node)

Creates a new image based on the given resource. the image properties are considered to 'on' the given resource.

Parameters:

node - resource of the image

Throws:

java.lang.IllegalArgumentException - if the given resource is not adaptable to node.

ImageResource

public ImageResource(Node resource,
                     java.lang.String imageName)

Creates a new image based on the given resource. the image properties are considered to 'on' the given resource unless imageName is specified. then the respective child resource holds the image properties.

Parameters:

resource - current resource

imageName - name of the image resource

Throws:

java.lang.IllegalArgumentException - if the given resource is not adaptable to node.

Method Detail

getAlt

public java.lang.String getAlt()

Returns the image alt name as defined by the "alt" or overridden by setAlt(String).

Returns:

the alt name

See Also:

PN_ALT

setAlt

public void setAlt(java.lang.String alt)

Sets the alt name.

Parameters:

alt - the alt name.

getSrc

public java.lang.String getSrc()

Returns the source attribute of this image. the source is computed as follows:

• if a selector is defined the path of the current resource concatenated with the selector, extension, and suffix is used.
• if a file node path is defined it is concatenated with the extension and suffix.
• if a file reference is defined it is concatenated with the extension and suffix.

Returns:

the source attribute

getExtension

public java.lang.String getExtension()

Tries to calculate the extension from the mime-type of the underlying image.

Overrides:

getExtension in class DownloadResource

Returns:

the mime-type dependant extension or ".png" if not determinable

setExtension

public void setExtension(java.lang.String extension)

Description copied from class: DownloadResource

Sets the extension.

Overrides:

setExtension in class DownloadResource

Parameters:

extension - the extension.

setSrc

public void setSrc(java.lang.String src)

Sets the source attribute

Parameters:

src - the source attribute

draw

public void draw(java.io.Writer w)
          throws java.io.IOException

Writes this image as tag to the given writer by invoking doDraw(PrintWriter) if canDraw() returns true.

Overrides:

draw in class DownloadResource

Parameters:

w - the writer

Throws:

java.io.IOException - if an I/O error occurs

getCropRect

public java.awt.Rectangle getCropRect()

Returns the cropping rectangle as defined by the "imageCrop".

Returns:

the cropping rectangle or null

getRotation

public int getRotation()

Returns the rotation angle as defined by the "imageRotate".

Returns:

the rotation angle (in degrees)

resize

public Layer resize(Layer layer)

Resizes the given layer according to the dimensions defined in this image. See ImageHelper.resize(Layer, Dimension, Dimension, Dimension) for more details about the resizing algorithm.

Parameters:

layer - the layer to resize

Returns:

the layer or null if the layer is untouched

crop

public Layer crop(Layer layer)

Crops the layer using the internal crop rectangle. if the crop rectangle is empty no cropping is performed and null is returned.

Parameters:

layer - the layer

Returns:

cropped layer or null

rotate

public Layer rotate(Layer layer)

Rotates the layer using the internal rotation angle. If no rotation other than 0 is defined, no rotation is performed and null is returned.

Parameters:

layer - the layer

Returns:

cropped layer or null

getLayer

public Layer getLayer(boolean cropped,
                      boolean resized,
                      boolean rotated)
               throws java.io.IOException,
                      RepositoryException

Returns the layer addressed by this image.

Parameters:

cropped - apply cropping if true

resized - apply resizing if true

rotated - apply rotation if true

Returns:

the layer

Throws:

java.io.IOException - if an I/O error occurs.

RepositoryException - if a repository error occurs.