com.atlassian.confluence.pages.thumbnail

Class ThumbnailInfo

java.lang.Object

com.atlassian.confluence.pages.thumbnail.ThumbnailInfo

public class ThumbnailInfo
extends Object

Responsible for setting the height and width of thumbnails appropriately and generating the HTML for rendering them in a page.

Field Summary

Fields

Modifier and Type	Field and Description
static int	THUMBNAIL_DEFAULT_WIDTH

Constructor Summary

Constructors

Constructor and Description
ThumbnailInfo(Attachment attachment, InputStream attachmentData, String attachmentsPath) Deprecated. since 3.1 use ThumbnailInfo(ImageDetails, Dimensions, String), or ThumbnailManager.getThumbnailInfo(com.atlassian.confluence.pages.Attachment, String)
ThumbnailInfo(ImageDetails imageDetails, Dimensions maxDimensions, String attachmentsPath) Creates a thumbnail info for the given image details and maximum dimensions.

Method Summary

Modifier and Type	Method and Description
static String	createThumbnailUrlPathFromAttachmentUrl(String attachmentUrl)
Attachment	getAttachment()
String	getImageMimeType() Returns the MIME type of the thumbnail if it is an intelligible image, or null otherwise.
int	getOriginalHeight() Get the height of the attachment before thumbnailing
int	getOriginalWidth() Get the width of the attachment before thumbnailing
String	getPopupLink(String imageParameters) Get some HTML that will cause a thumbnail to be rendered inline, with a popup-link to the full-sized image.
String	getPopupLinkPrefix() This method generates an a tag with the 'confluence-thumbnail-link' class.
String	getPopupLinkSuffix()
int	getThumbnailHeight() Get the height of the thumbnail image.
String	getThumbnailImageHtml(String imageParameters)
String	getThumbnailUrlPath() Get the URL path for downloading the thumbnail, relative to the application's context-root
int	getThumbnailWidth() Get the width of the thumbnail image.
static boolean	systemSupportsThumbnailing()

Methods inherited from class java.lang.Object

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

Field Detail

THUMBNAIL_DEFAULT_WIDTH

public static final int THUMBNAIL_DEFAULT_WIDTH

See Also:

Constant Field Values

Constructor Detail

ThumbnailInfo

@Deprecated
public ThumbnailInfo(Attachment attachment,
                                 InputStream attachmentData,
                                 String attachmentsPath)

Deprecated. since 3.1 use ThumbnailInfo(ImageDetails, Dimensions, String), or ThumbnailManager.getThumbnailInfo(com.atlassian.confluence.pages.Attachment, String)

Creates a thumbnail for an attachment.

Parameters:

attachmentData - is no longer used or required, so can be null

ThumbnailInfo

public ThumbnailInfo(ImageDetails imageDetails,
                     Dimensions maxDimensions,
                     String attachmentsPath)

Creates a thumbnail info for the given image details and maximum dimensions. The attachmentPath is used to generate a thumbnail URL.

Throws:

IllegalArgumentException - if imageDetails or its attachment is null

Since:

3.1

Method Detail

systemSupportsThumbnailing

public static boolean systemSupportsThumbnailing()

getOriginalWidth

public int getOriginalWidth()

Get the width of the attachment before thumbnailing

Returns:

the width in pixels of the attachment before thumbnailing, or -1 if the attachment is not an image which is thumbnailable

getOriginalHeight

public int getOriginalHeight()

Get the height of the attachment before thumbnailing

Returns:

the width in pixels of the attachment before thumbnailing, or -1 if the attachment is not an image which is thumbnailable

getThumbnailWidth

public int getThumbnailWidth()

Get the width of the thumbnail image. This should never be greater than the configured maximum thumbnail width.

Returns:

the width of the thumbnail image in pixels

getThumbnailHeight

public int getThumbnailHeight()

Get the height of the thumbnail image. This should never be greater than the configured maximum thumbnail height.

Returns:

the height of the thumbnail image in pixels

getThumbnailUrlPath

public String getThumbnailUrlPath()

Get the URL path for downloading the thumbnail, relative to the application's context-root

Returns:

the path for downloading the thumbnail, relative to the application's context-root;

createThumbnailUrlPathFromAttachmentUrl

public static String createThumbnailUrlPathFromAttachmentUrl(String attachmentUrl)

getPopupLink

public String getPopupLink(String imageParameters)

Get some HTML that will cause a thumbnail to be rendered inline, with a popup-link to the full-sized image. You can optionally supply some additional parameters to include in the img tag.

This method generates an a tag with the 'confluence-thumbnail-link' class. The 'image-effects.js' file will attach an onclick function during the page initialisation.

Parameters:

imageParameters - a string of parameters suitable for inserting into an HTML img tag. Ignored if null.

Returns:

the appropriate popup image HTML

getPopupLinkPrefix

public String getPopupLinkPrefix()

This method generates an a tag with the 'confluence-thumbnail-link' class. The 'image-effects.js' file will attach an onclick function during the page initialisation.

Returns:

the popup prefix html

See Also:

getPopupLinkSuffix()

getPopupLinkSuffix

public String getPopupLinkSuffix()

getThumbnailImageHtml

public String getThumbnailImageHtml(String imageParameters)

getAttachment

public Attachment getAttachment()

getImageMimeType

public String getImageMimeType()

Returns the MIME type of the thumbnail if it is an intelligible image, or null otherwise.