1. /*

  2.  * @(#)RenderedImageFactory.java	1.7 00/02/02

  3.  *

  4.  * Copyright 1998-2000 Sun Microsystems, Inc. All Rights Reserved.

  5.  * 

  6.  * This software is the proprietary information of Sun Microsystems, Inc.  

  7.  * Use is subject to license terms.

  8.  * 

  9.  */

  10. 

  11. /* ********************************************************************

  12.  **********************************************************************

  13.  **********************************************************************

  14.  *** COPYRIGHT (c) Eastman Kodak Company, 1997                      ***

  15.  *** As  an unpublished  work pursuant to Title 17 of the United    ***

  16.  *** States Code.  All rights reserved.                             ***

  17.  **********************************************************************

  18.  **********************************************************************

  19.  **********************************************************************/

  20. 

  21. package java.awt.image.renderable;

  22. import java.awt.image.RenderedImage;

  23. import java.awt.RenderingHints;

  24. 

  25. /**

  26.  * The RenderedImageFactory interface (often abbreviated RIF) is

  27.  * intended to be implemented by classes that wish to act as factories

  28.  * to produce different renderings, for example by executing a series

  29.  * of BufferedImageOps on a set of sources, depending on a specific

  30.  * set of parameters, properties, and rendering hints.

  31.  */

  32. public interface RenderedImageFactory {

  33. 

  34.   /**

  35.    * Creates a RenderedImage representing the results of an imaging

  36.    * operation (or chain of operations) for a given ParameterBlock and

  37.    * RenderingHints.  The RIF may also query any source images

  38.    * referenced by the ParameterBlock for their dimensions,

  39.    * SampleModels, properties, etc., as necessary.

  40.    *

  41.    * <p> The create() method can return null if the

  42.    * RenderedImageFactory is not capable of producing output for the

  43.    * given set of source images and parameters.  For example, if a

  44.    * RenderedImageFactory is only capable of performing a 3x3

  45.    * convolution on single-banded image data, and the source image has

  46.    * multiple bands or the convolution Kernel is 5x5, null should be

  47.    * returned.

  48.    *

  49.    * <p> Hints should be taken into account, but can be ignored.

  50.    * The created RenderedImage may have a property identified

  51.    * by the String HINTS_OBSERVED to indicate which RenderingHints

  52.    * were used to create the image.  In addition any RenderedImages

  53.    * that are obtained via the getSources() method on the created

  54.    * RenderedImage may have such a property.

  55.    *  

  56.    * @param paramBlock a ParameterBlock containing sources and parameters

  57.    *        for the RenderedImage to be created.

  58.    * @param hints a RenderingHints object containing hints.

  59.    * @return A RenderedImage containing the desired output.

  60.    */

  61.   RenderedImage create(ParameterBlock paramBlock, 

  62.                        RenderingHints hints);

  63. }