public class

ReplicateScaleFilter

extends ImageFilter

java.lang.Object
↳	java.awt.image.ImageFilter
	↳	java.awt.image.ReplicateScaleFilter

Known Direct Subclasses

AreaAveragingScaleFilter

Class Overview

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.

Summary

[Expand]

Inherited Constants

From interface java.awt.image.ImageConsumer

Fields
protected int	destHeight	The target height to scale the image.
protected int	destWidth	The target width to scale the image.
protected Object	outpixbuf	A `byte` array initialized with a size of `destWidth` and used to deliver a row of pixel data to the `ImageConsumer`.
protected int	srcHeight	The height of the source image.
protected int	srcWidth	The width of the source image.
protected int[]	srccols	An `int` array containing information about a column of pixels.
protected int[]	srcrows	An `int` array containing information about a row of pixels.

[Expand]

Inherited Fields

From class java.awt.image.ImageFilter

Public Constructors
	ReplicateScaleFilter(int width, int height) Constructs a ReplicateScaleFilter that scales the pixels from its source Image as specified by the width and height parameters.

Public Methods
void	setDimensions(int w, int h) Override the dimensions of the source image and pass the dimensions of the new scaled size to the ImageConsumer.
void	setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize) Choose which rows and columns of the delivered int pixels are needed for the destination scaled image and pass through just those rows and columns that are needed, replicated as necessary.
void	setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize) Choose which rows and columns of the delivered byte pixels are needed for the destination scaled image and pass through just those rows and columns that are needed, replicated as necessary.
void	setProperties(Hashtable<?, ?> props) Passes along the properties from the source object after adding a property indicating the scale applied.

[Expand]

Inherited Methods

From class java.awt.image.ImageFilter

Object	clone() Clones this object.
ImageFilter	getFilterInstance(ImageConsumer ic) Returns a unique instance of an ImageFilter object which will actually perform the filtering for the specified ImageConsumer.
void	imageComplete(int status) Filters the information provided in the imageComplete method of the ImageConsumer interface.
void	resendTopDownLeftRight(ImageProducer ip) Responds to a request for a TopDownLeftRight (TDLR) ordered resend of the pixel data from an `ImageConsumer`.
void	setColorModel(ColorModel model) Filter the information provided in the setColorModel method of the ImageConsumer interface.
void	setDimensions(int width, int height) Filters the information provided in the setDimensions method of the ImageConsumer interface.
void	setHints(int hints) Filters the information provided in the setHints method of the ImageConsumer interface.
void	setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize) Filters the information provided in the setPixels method of the ImageConsumer interface which takes an array of integers.
void	setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize) Filters the information provided in the setPixels method of the ImageConsumer interface which takes an array of bytes.
void	setProperties(Hashtable<?, ?> props) Passes the properties from the source object along after adding a property indicating the stream of filters it has been run through.

From class java.lang.Object

Object	clone() Creates and returns a copy of this object.
boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
void	finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
final Class<?>	getClass() Returns the runtime class of this `Object`.
int	hashCode() Returns a hash code value for the object.
final void	notify() Wakes up a single thread that is waiting on this object's monitor.
final void	notifyAll() Wakes up all threads that are waiting on this object's monitor.
String	toString() Returns a string representation of the object.
final void	wait() Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object.
final void	wait(long timeout, int nanos) Causes the current thread to wait until another thread invokes the `notify()` method or the `notifyAll()` method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed.
final void	wait(long timeout) Causes the current thread to wait until either another thread invokes the `notify()` method or the `notifyAll()` method for this object, or a specified amount of time has elapsed.

From interface java.awt.image.ImageConsumer

abstract void	imageComplete(int status) The imageComplete method is called when the ImageProducer is finished delivering all of the pixels that the source image contains, or when a single frame of a multi-frame animation has been completed, or when an error in loading or producing the image has occured.
abstract void	setColorModel(ColorModel model) Sets the ColorModel object used for the majority of the pixels reported using the setPixels method calls.
abstract void	setDimensions(int width, int height) The dimensions of the source image are reported using the setDimensions method call.
abstract void	setHints(int hintflags) Sets the hints that the ImageConsumer uses to process the pixels delivered by the ImageProducer.
abstract void	setPixels(int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize) The pixels of the image are delivered using one or more calls to the setPixels method.
abstract void	setPixels(int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize) Delivers the pixels of the image with one or more calls to this method.
abstract void	setProperties(Hashtable<?, ?> props) Sets the extensible list of properties associated with this image.

Fields

protected int destHeight

The target height to scale the image.

protected int destWidth

The target width to scale the image.

protected Object outpixbuf

A byte array initialized with a size of destWidth and used to deliver a row of pixel data to the ImageConsumer.

protected int srcHeight

The height of the source image.

protected int srcWidth

The width of the source image.

protected int[] srccols

An int array containing information about a column of pixels.

protected int[] srcrows

An int array containing information about a row of pixels.

Public Constructors

public ReplicateScaleFilter (int width, int height)

Constructs a ReplicateScaleFilter that scales the pixels from its source Image as specified by the width and height parameters.

Parameters

width	the target width to scale the image
height	the target height to scale the image

Throws

IllegalArgumentException	if `width` equals zero or `height` equals zero

Public Methods

public void setDimensions (int w, int h)

Override the dimensions of the source image and pass the dimensions of the new scaled size to the ImageConsumer.

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.

Parameters

w	the width of the source image
h	the height of the source image

public void setPixels (int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)

Choose which rows and columns of the delivered int pixels are needed for the destination scaled image and pass through just those rows and columns that are needed, replicated as necessary.

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.

Parameters

x	the X coordinate of the upper-left corner of the area of pixels to be set
y	the Y coordinate of the upper-left corner of the area of pixels to be set
w	the width of the area of pixels
h	the height of the area of pixels
model	the specified `ColorModel`
pixels	the array of pixels
off	the offset into the `pixels` array
scansize	the distance from one row of pixels to the next in the `pixels` array

public void setPixels (int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)

Choose which rows and columns of the delivered byte pixels are needed for the destination scaled image and pass through just those rows and columns that are needed, replicated as necessary.

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.

Parameters

x	the X coordinate of the upper-left corner of the area of pixels to be set
y	the Y coordinate of the upper-left corner of the area of pixels to be set
w	the width of the area of pixels
h	the height of the area of pixels
model	the specified `ColorModel`
pixels	the array of pixels
off	the offset into the `pixels` array
scansize	the distance from one row of pixels to the next in the `pixels` array

public void setProperties (Hashtable<?, ?> props)

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.

Parameters

props	the properties from the source object

Interfaces

Classes

Exceptions

ReplicateScaleFilter

Class Overview

See Also

Summary

Fields

protected int destHeight

protected int destWidth

protected Object outpixbuf

protected int srcHeight

protected int srcWidth

protected int[] srccols

protected int[] srcrows

Public Constructors

public ReplicateScaleFilter (int width, int height)

Parameters

Throws

Public Methods

public void setDimensions (int w, int h)

Parameters

See Also

public void setPixels (int x, int y, int w, int h, ColorModel model, int[] pixels, int off, int scansize)

Parameters

public void setPixels (int x, int y, int w, int h, ColorModel model, byte[] pixels, int off, int scansize)

Parameters

public void setProperties (Hashtable<?, ?> props)

Parameters