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

The "Piecewise" operation performs a piecewise linear mapping of the pixel values of an image. The piecewise linear mapping is described by a set of breakpoints which are provided as an array of the form

float breakPoints[N][2][numBreakPoints]

The pixel values of the destination image are defined by the pseudocode:

 if (src[x][y][b] < breakPoints[b][0][0]) {
 dst[x][y][b] = breakPoints[b][1][0]);
 } else if (src[x][y][b] > breakPoints[b][0][numBreakPoints-1]) {
 dst[x][y][b] = breakPoints[b][1][numBreakPoints-1]);
 } else {
 int i = 0;
 while(breakPoints[b][0][i+1] < src[x][y][b]) {
 i++;
 }
 dst[x][y][b] = breakPoints[b][1][i] +
 (src[x][y][b] - breakPoints[b][0][i])*
 (breakPoints[b][1][i+1] - breakPoints[b][1][i])/
 (breakPoints[b][0][i+1] - breakPoints[b][0][i]);
 }
 

Resource List

Name	Value
GlobalName	Piecewise
LocalName	Piecewise
Vendor	com.sun.media.jai
Description	Applies a piecewise pixel value mapping.
DocURL	http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/operator/PiecewiseDescriptor.html
Version	1.0
arg0Desc	The breakpoint array.

Parameter List

Name	Class Type	Default Value
breakPoints	float[][][]	identity mapping on [0, 255]

Creates a ParameterBlockJAI from all supplied arguments except hints and invokes JAI.create(StringParameterBlockRenderingHints) .
See Also:   JAI
See Also:   ParameterBlockJAI
See Also:   RenderedOp
Parameters:
  source0 - RenderedImage source 0.
Parameters:
  breakPoints - The breakpoint array.May be null.
Parameters:
  hints - The RenderingHints to use.May be null.

Creates a ParameterBlockJAI from all supplied arguments except hints and invokes JAI.createRenderable(StringParameterBlockRenderingHints) .
See Also:   JAI
See Also:   ParameterBlockJAI
See Also:   RenderableOp
Parameters:
  source0 - RenderableImage source 0.
Parameters:
  breakPoints - The breakpoint array.May be null.
Parameters:
  hints - The RenderingHints to use.May be null.

Creates a ParameterBlockJAI from all supplied arguments except hints and invokes JAI.create(StringParameterBlockRenderingHints) .
See Also:   JAI
See Also:   ParameterBlockJAI
See Also:   RenderedOp
Parameters:
  source0 - RenderedImage source 0.
Parameters:
  breakPoints - The breakpoint array.May be null.
Parameters:
  hints - The RenderingHints to use.May be null. The RenderedOp destination.
throws:
  IllegalArgumentException - if source0 is null.

Creates a ParameterBlockJAI from all supplied arguments except hints and invokes JAI.createRenderable(StringParameterBlockRenderingHints) .
See Also:   JAI
See Also:   ParameterBlockJAI
See Also:   RenderableOp
Parameters:
  source0 - RenderableImage source 0.
Parameters:
  breakPoints - The breakpoint array.May be null.
Parameters:
  hints - The RenderingHints to use.May be null. The RenderableOp destination.
throws:
  IllegalArgumentException - if source0 is null.

In addition to the standard checks performed by the superclass method, this method checks that the number of bands in "breakPoints" is either 1 or the number of bands in the source image, the second breakpoint array dimension is 2, the third dimension is the same for abscissas and ordinates, and that the absicssas are monotonically increasing.