CollectionImage which is also a RenderedImage. The underlying Collection in this case is required to be a List containing only RenderedImages. 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
| |
| |
| |