01: /*
02: * $RCSfile: RenderableCollectionImageFactory.java,v $
03: *
04: * Copyright (c) 2005 Sun Microsystems, Inc. All rights reserved.
05: *
06: * Use is subject to license terms.
07: *
08: * $Revision: 1.1 $
09: * $Date: 2005/02/11 04:57:19 $
10: * $State: Exp $
11: */
12: package javax.media.jai;
13:
14: import java.awt.image.renderable.ParameterBlock;
15:
16: /**
17: * The <code>RenderableCollectionImageFactory</code> (RCIF) interface
18: * is intended to be implemented by classes that wish to act as factories
19: * to produce different collection image operators. In JAI, the
20: * <code>create()</code> method defined by this interface will be
21: * invoked in a chain of <code>CollectionOp</code>s when the operation is
22: * being executed in renderable mode. The images contained in the
23: * generated <code>CollectionImage</code> would be expected to be
24: * <code>RenderableImage</code>s.
25: *
26: * @since JAI 1.1
27: */
28: public interface RenderableCollectionImageFactory {
29:
30: /**
31: * Creates a <code>CollectionImage</code> that represents the
32: * result of an operation (or chain of operations) for a given
33: * <code>ParameterBlock</code>.
34: * If the operation is unable to handle the input arguments, this
35: * method should return <code>null</code>.
36: *
37: * <p> Generally this method is expected to be invoked by an operation
38: * being executed in renderable mode. Therefore the images contained
39: * in the generated <code>CollectionImage</code> would be expected to
40: * be <code>RenderableImage</code>s.
41: *
42: * @param args Input arguments to the operation, including
43: * sources and/or parameters.
44: *
45: * @return A <code>CollectionImage</code> containing the desired output.
46: */
47: CollectionImage create(ParameterBlock parameters);
48: }
|