Java Doc for WarpOpImage.java in  » 6.0-JDK-Modules » Java-Advanced-Imaging » javax » media » jai » Java Source Code / Java DocumentationJava Source Code and Java Documentation

The image warp is specified by a Warp object and an Interpolation object.

Subclasses of WarpOpImage may choose whether they wish to implement the cobbled or non-cobbled variant of computeRect by means of the cobbleSources constructor parameter. The class comments for OpImage provide more information about how to override computeRect. It should be noted that the superclass GeometricOpImage automatically adds a value of Boolean.TRUE for the JAI.KEY_REPLACE_INDEX_COLOR_MODEL to the given configuration and passes it up to its superclass constructor so that geometric operations are performed on the pixel values instead of being performed on the indices into the color map for those operations whose source(s) have an IndexColorModel. This addition will take place only if a value for the JAI.KEY_REPLACE_INDEX_COLOR_MODEL has not already been provided by the user. Note that the configuration Map is cloned before the new hint is added to it. Regarding the value for the JAI.KEY_REPLACE_INDEX_COLOR_MODEL RenderingHints, the operator itself can be smart based on the parameters, i.e. while the default value for the JAI.KEY_REPLACE_INDEX_COLOR_MODEL is Boolean.TRUE for operations that extend this class, in some cases the operator could set the default.
See Also:   GeometricOpImage
See Also:   OpImage
See Also:   Warp
See Also:   Interpolation

The image's layout is encapsulated in the layout argument.

The image's layout is encapsulated in the layout argument.

The implementation in this class returns the value returned by warp.mapDestPoint(destPt).

The implementation in this class returns the value returned by warp.mapSourcePoint(sourcePt).

The image's layout is encapsulated in the layout argument. The user-supplied layout values supersedes the default settings. Any layout setting not specified by the user will take the corresponding value of the source image's layout.
Parameters:
  layout - The layout of this image.
Parameters:
  source - The source image; can not be null.
Parameters:
  configuration - Configurable attributes of the image includingconfiguration variables indexed byRenderingHints.Keys and image properties indexedby Strings or CaselessStringKeys.This is simply forwarded to the superclass constructor.
Parameters:
  cobbleSources - A boolean indicating whethercomputeRect() expects contiguous sources.To use the default implementation of warping contained inthis class, set cobbleSources to false.
Parameters:
  extender - A BorderExtender, or null.
Parameters:
  interp - The Interpolation object describing theinterpolation method.
Parameters:
  warp - The Warp object describing the warp.
throws:
  IllegalArgumentException - if sourceis null.
throws:
  IllegalArgumentException - if combining thesource bounds with the layout parameter results in negativeoutput width or height.
throws:
  IllegalArgumentException - If warp isnull.
since:
   JAI 1.1

The image's layout is encapsulated in the layout argument. The user-supplied layout values supersedes the default settings. Any layout setting not specified by the user will take the corresponding value of the source image's layout.
Parameters:
  layout - The layout of this image.
Parameters:
  source - The source image; can not be null.
Parameters:
  configuration - Configurable attributes of the image includingconfiguration variables indexed byRenderingHints.Keys and image properties indexedby Strings or CaselessStringKeys.This is simply forwarded to the superclass constructor.
Parameters:
  cobbleSources - A boolean indicating whethercomputeRect() expects contiguous sources.To use the default implementation of warping contained inthis class, set cobbleSources to false.
Parameters:
  extender - A BorderExtender, or null.
Parameters:
  interp - The Interpolation object describing theinterpolation method.
Parameters:
  warp - The Warp object describing the warp.
Parameters:
  backgroundValues - The user-specified background values. If theprovided array length is smaller than the number of bands, allthe bands will be filled with the first element of the array.If the provided array is null, it will be set tonew double[]{0.0} in the superclass.
throws:
  IllegalArgumentException - if sourceis null.
throws:
  IllegalArgumentException - if combining thesource bounds with the layout parameter results in negativeoutput width or height.
throws:
  IllegalArgumentException - If warp isnull.
since:
   JAI 1.1.2

Whether or not this method performs source cobbling is determined by the cobbleSources variable set at construction time. If cobbleSources is true, cobbling is performed on the source for areas that intersect multiple tiles, and computeRect(Raster[], WritableRaster, Rectangle) is called to perform the actual computation. Otherwise, computeRect(PlanarImage[], WritableRaster, Rectangle) is called to perform the actual computation.
Parameters:
  tileX - The X index of the tile.
Parameters:
  tileY - The Y index of the tile. The tile as a Raster.

The implementation in this class returns the value returned by warp.mapDestPoint(destPt). Subclasses requiring different behavior should override this method.

The implementation in this class returns the value returned by warp.mapSourcePoint(sourcePt). Subclasses requiring different behavior should override this method.