CollectionImage
which is also a RenderedImage
. The underlying Collection
in this case is required to be a List
containing only RenderedImage
s. Instances of this class may be returned from either a RenderedImageFactory
or from a CollectionImageFactory
. This class would be particularly useful for implementing operations the result of which includes a single primary image and one or more secondary or dependant images the data of which are less likely to be requested.
Invocations of RenderedImage
methods on an instance of this class will be forwarded to the first RenderedImage
in the underlying List
, i.e., the image at index zero. This should be the index assigned to the primary image in the case alluded to above. If there are no images in the List
when a RenderedImage
method is invoked an IllegalStateException
will be thrown.
One example of the use of this class is in generating a classmap image using a classification algorithm. A by-product image of such an operation is often an error image wherein the value of each pixel is some measure of the classification error at that pixel. In this case the classmap image would be stored at index zero in the internal list and the error image at the unity index. The error image would be an OpImage
that has the classmap image as its source. The result is that a reference to the error image is always available with the classmap image but the computation of the error image pixel values may be deferred until such time as the data are needed, if ever.
Methods defined in the RenderedImage
and List
interfaces are not all commented in detail. The List
methods merely forward the call in most cases directly to the underlying List
; as previously stated, RenderedImage
method invocations are forwarded to the RenderedImage
at position zero in the List
.
@since JAI 1.1
@see CollectionImage
@see java.awt.image.RenderedImage
@see java.util.List
|
|
|
|
|
|