|
Provides methods for dealing with thumbnails. Provision is provided to retrieve thumbnails using the on-disk cache (provided by ROMIO) or on the fly.
NOTE: The calling order for the service is as follows:
This method manages the state of the service; it must be invoked before using any other methods. As the ThumbnailStore relies on the RenderingEngine, a valid rendering definition must be available for it to work.
true
if a
model::RenderingDef exists for the
model::Pixels set, otherwise
false
pixelsId
.This returns the last available in progress state for a thumbnail. Its return value is only expected to be valid after the call to any of the individual thumbnail retrieval methods.
true
if the image is in the process of
being imported or a pyramid is being generated for
it.
This method manages the state of the service; it should be
invoked directly after {@code setPixelsId}. If it is not
invoked with a valid rendering definition ID before using
the thumbnail accessor methods execution continues as if
renderingDefId
were set to null
.
null
specifies the user's currently
active rendering settings to be used.renderingDefId
.Return the id of the model::RenderingDef loaded in this instance.
Retrieves a thumbnail for a pixels set using a given set of rendering settings (RenderingDef). If the thumbnail exists in the on-disk cache it will be returned directly, otherwise it will be created as in {@code getThumbnailDirect}, placed in the on-disk cache and returned. If the thumbnail is missing, a clock will be returned to signify that the thumbnail is yet to be generated. {@code setPixelsId} has not yet been called
null
specifies the default size
of 48.null
specifies the default size
of 48.a JPEG thumbnail byte buffer.
sizeX
is greater than pixels.sizeXsizeX
is negativesizeY
is greater than pixels.sizeYsizeY
is negativeRetrieves a thumbnail for a pixels set using a given set of rendering settings (RenderingDef). If the thumbnail exists in the on-disk cache it will be returned directly, otherwise it will be created as in {@code getThumbnailDirect}, placed in the on-disk cache and returned. If the thumbnail is still to be generated, an empty array will be returned. {@code setPixelsId} has not yet been called
null
specifies the default size
of 48.null
specifies the default size
of 48.a JPEG thumbnail byte buffer
sizeX
is greater than pixels.sizeXsizeX
is negativesizeY
is greater than pixels.sizeYsizeY
is negativeRetrieves a number of thumbnails for pixels sets using given sets of rendering settings (RenderingDef). If the thumbnails exist in the on-disk cache they will be returned directly, otherwise they will be created as in {@code getThumbnailDirect}, placed in the on-disk cache and returned. Unlike the other thumbnail retrieval methods, this method may be called without first calling {@code setPixelsId}.
null
specifies the default size
of 48.null
specifies the default size
of 48.a map whose keys are pixels ids and values are JPEG
thumbnail byte buffers or null
if an
exception was thrown while attempting to retrieve
the thumbnail for that particular Pixels set.
Retrieves a number of thumbnails for pixels sets using given sets of rendering settings (RenderingDef). If the Thumbnails exist in the on-disk cache they will be returned directly, otherwise they will be created as in {@code getThumbnailByLongestSideDirect}. The longest side of the image will be used to calculate the size for the smaller side in order to keep the aspect ratio of the original image. Unlike the other thumbnail retrieval methods, this method may be called without first calling {@code setPixelsId}.
null
specifies the
default size of 48.a map whose keys are pixels ids and values are JPEG
thumbnail byte buffers or null
if an
exception was thrown while attempting to retrieve
the thumbnail for that particular Pixels set.
Retrieves a thumbnail for a pixels set using a given set of rendering settings (RenderingDef). If the thumbnail exists in the on-disk cache it will be returned directly, otherwise it will be created as in {@code getThumbnailDirect}, placed in the on-disk cache and returned. The longest side of the image will be used to calculate the size for the smaller side in order to keep the aspect ratio of the original image. {@code setPixelsId} has not yet been called
null
specifies the
default size of 48.a JPEG thumbnail byte buffer.
size
is greater than pixels.sizeX and pixels.sizeYRetrieves a thumbnail for a pixels set using a given set of rendering settings (RenderingDef). The Thumbnail will always be created directly, ignoring the on-disk cache. The longest side of the image will be used to calculate the size for the smaller side in order to keep the aspect ratio of the original image. {@code setPixelsId} has not yet been called
null
specifies the
default size of 48.a JPEG thumbnail byte buffer.
size
is greater than pixels.sizeX and pixels.sizeYRetrieves a thumbnail for a pixels set using a given set of rendering settings (RenderingDef). The Thumbnail will always be created directly, ignoring the on-disk cache. {@code setPixelsId} has not yet been called
null
specifies the default size
of 48.null
specifies the default size
of 48.a JPEG thumbnail byte buffer.
sizeX
is greater than pixels.sizeXsizeX
is negativesizeY
is greater than pixels.sizeYsizeY
is negativeRetrieves a thumbnail for a pixels set using a given set of rendering settings (RenderingDef) for a particular section. The Thumbnail will always be created directly, ignoring the on-disk cache. {@code setPixelsId} has not yet been called
null
specifies the default size
of 48.null
specifies the default size
of 48.a JPEG thumbnail byte buffer.
sizeX
is greater than pixels.sizeXsizeX
is negativesizeY
is greater than pixels.sizeYsizeY
is negativetheZ
is out of rangetheT
is out of rangeRetrieves a thumbnail for a pixels set using a given set of rendering settings (RenderingDef) for a particular section. The Thumbnail will always be created directly, ignoring the on-disk cache. The longest side of the image will be used to calculate the size for the smaller side in order to keep the aspect ratio of the original image. {@code setPixelsId} has not yet been called
null
specifies the
default size of 48.a JPEG thumbnail byte buffer.
size
is greater than pixels.sizeX and pixels.sizeYCreates thumbnails for a pixels set using a given set of rendering settings (RenderingDef) in the on-disk cache for every sizeX/sizeY combination already cached.
Creates a thumbnail for a pixels set using a given set of rendering settings (RenderingDef) in the on-disk cache. {@code setPixelsId} has not yet been called
null
specifies the default size
of 48.null
specifies the default size
of 48.sizeX
is greater than pixels.sizeXsizeX
is negativesizeY
is greater than pixels.sizeYsizeY
is negativeCreates thumbnails for a number of pixels sets using a given set of rendering settings (RenderingDef) in the on-disk cache. Unlike the other thumbnail creation methods, this method may be called without first calling {@code setPixelsId}. This method will not reset or modify rendering settings in any way. If rendering settings for a pixels set are not present, thumbnail creation for that pixels set will not be performed.
null
specifies the
default size of 48.size
is greater than pixels.sizeX and pixels.sizeYsize
is negativeChecks if a thumbnail of a particular size exists for a pixels set.
null
specifies the default size
of 48.null
specifies the default size
of 48.sizeX
is negativesizeY
is negativeResets the rendering definition for the active pixels set to its default settings.
|