Java tutorial
/* * Copyright (c) 1998, 2008, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this * particular file as subject to the "Classpath" exception as provided * by Oracle in the LICENSE file that accompanied this code. * * This code is distributed in the hope that it will be useful, but WITHOUT * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License * version 2 for more details (a copy is included in the LICENSE file that * accompanied this code). * * You should have received a copy of the GNU General Public License version * 2 along with this work; if not, write to the Free Software Foundation, * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. * * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA * or visit www.oracle.com if you need additional information or have any * questions. */ /* ******************************************************************** ********************************************************************** ********************************************************************** *** COPYRIGHT (c) Eastman Kodak Company, 1997 *** *** As an unpublished work pursuant to Title 17 of the United *** *** States Code. All rights reserved. *** ********************************************************************** ********************************************************************** **********************************************************************/ package java.awt.image.renderable; import java.awt.image.RenderedImage; import java.awt.RenderingHints; /** * The RenderedImageFactory interface (often abbreviated RIF) is * intended to be implemented by classes that wish to act as factories * to produce different renderings, for example by executing a series * of BufferedImageOps on a set of sources, depending on a specific * set of parameters, properties, and rendering hints. */ public interface RenderedImageFactory { /** * Creates a RenderedImage representing the results of an imaging * operation (or chain of operations) for a given ParameterBlock and * RenderingHints. The RIF may also query any source images * referenced by the ParameterBlock for their dimensions, * SampleModels, properties, etc., as necessary. * * <p> The create() method can return null if the * RenderedImageFactory is not capable of producing output for the * given set of source images and parameters. For example, if a * RenderedImageFactory is only capable of performing a 3x3 * convolution on single-banded image data, and the source image has * multiple bands or the convolution Kernel is 5x5, null should be * returned. * * <p> Hints should be taken into account, but can be ignored. * The created RenderedImage may have a property identified * by the String HINTS_OBSERVED to indicate which RenderingHints * were used to create the image. In addition any RenderedImages * that are obtained via the getSources() method on the created * RenderedImage may have such a property. * * @param paramBlock a ParameterBlock containing sources and parameters * for the RenderedImage to be created. * @param hints a RenderingHints object containing hints. * @return A RenderedImage containing the desired output. */ RenderedImage create(ParameterBlock paramBlock, RenderingHints hints); }