javax.media.jai
Class BorderExtenderCopy

java.lang.Object
  extended byjavax.media.jai.BorderExtender
      extended byjavax.media.jai.BorderExtenderCopy
All Implemented Interfaces:
Serializable

public final class BorderExtenderCopy
extends BorderExtender

A subclass of BorderExtender that implements border extension by filling all pixels outside of the image bounds with copies of the edge pixels. For example, the image:

ABC
DEF
GHI

if extended by adding two extra rows to the top and bottom and two extra columns on the left and right sides, would become:

AAABCCC
AAABCCC
AAABCCC
DDDEFFF
GGGHIII
GGGHIII
GGGHIII

Although this type of extension is not particularly visually appealing, it is very useful as a way of padding source images prior to area or geometric operations, such as convolution, scaling, or rotation.

See Also:
BorderExtender, Serialized Form

Field Summary
 
Fields inherited from class javax.media.jai.BorderExtender
BORDER_COPY, BORDER_REFLECT, BORDER_WRAP, BORDER_ZERO
 
Method Summary
 void extend(WritableRaster raster, PlanarImage im)
          Fills in the portions of a given Raster that lie outside the bounds of a given PlanarImage with copies of the edge pixels of the image.
 
Methods inherited from class javax.media.jai.BorderExtender
createInstance
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

extend

public final void extend(WritableRaster raster,
                         PlanarImage im)
Fills in the portions of a given Raster that lie outside the bounds of a given PlanarImage with copies of the edge pixels of the image.

The portion of raster that lies within im.getBounds() is not altered.

Specified by:
extend in class BorderExtender
Parameters:
raster - The WritableRaster the border area of which is to be filled with copies of the edge pixels of the image.
im - The PlanarImage which will provide the edge data with which to fill the border area of the WritableRaster.
Throws:
IllegalArgumentException - if either parameter is null.