/* * Copyright (c) 1996, 2004, 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. */ package java.awt.image; import java.awt.image.ImageConsumer; import java.awt.image.ColorModel; import java.util.Hashtable; import java.awt.Rectangle; /** * An ImageFilter class for scaling images using the simplest algorithm. * This class extends the basic ImageFilter Class to scale an existing * image and provide a source for a new image containing the resampled * image. The pixels in the source image are sampled to produce pixels * for an image of the specified size by replicating rows and columns of * pixels to scale up or omitting rows and columns of pixels to scale * down. *
It is meant to be used in conjunction with a FilteredImageSource
* object to produce scaled versions of existing images. Due to
* implementation dependencies, there may be differences in pixel values
* of an image filtered on different platforms.
*
* @see FilteredImageSource
* @see ImageFilter
*
* @author Jim Graham
*/
public class ReplicateScaleFilter extends ImageFilter {
/**
* The width of the source image.
*/
protected int srcWidth;
/**
* The height of the source image.
*/
protected int srcHeight;
/**
* The target width to scale the image.
*/
protected int destWidth;
/**
* The target height to scale the image.
*/
protected int destHeight;
/**
* An int
array containing information about a
* row of pixels.
*/
protected int srcrows[];
/**
* An int
array containing information about a
* column of pixels.
*/
protected int srccols[];
/**
* A byte
array initialized with a size of
* {@link #destWidth} and used to deliver a row of pixel
* data to the {@link ImageConsumer}.
*/
protected Object outpixbuf;
/**
* Constructs a ReplicateScaleFilter that scales the pixels from
* its source Image as specified by the width and height parameters.
* @param width the target width to scale the image
* @param height the target height to scale the image
* @throws IllegalArgumentException if width
equals
* zero or height
equals zero
*/
public ReplicateScaleFilter(int width, int height) {
if (width == 0 || height == 0) {
throw new IllegalArgumentException("Width ("+width+
") and height ("+height+
") must be non-zero");
}
destWidth = width;
destHeight = height;
}
/**
* Passes along the properties from the source object after adding a
* property indicating the scale applied.
* This method invokes super.setProperties
,
* which might result in additional properties being added.
*
* Note: This method is intended to be called by the
* ImageProducer
of the Image
whose pixels
* are being filtered. Developers using
* this class to filter pixels from an image should avoid calling
* this method directly since that operation could interfere
* with the filtering operation.
*/
public void setProperties(Hashtable,?> props) {
@SuppressWarnings("unchecked")
Hashtable