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

The Threshold operation takes one rendered image, and maps all the pixels of this image whose value falls within a specified range to a specified constant. The range is specified by a low value and a high value.

If the number of elements supplied via the "high", "low", and "constants" arrays are less than the number of bands of the source image, then the element from entry 0 is applied to all the bands. Otherwise, the element from a different entry is applied to its corresponding band.

The destination pixel values are defined by the pseudocode:

 lowVal = (low.length < dstNumBands) ?
 low[0] : low[b];
 highVal = (high.length < dstNumBands) ?
 high[0] : high[b];
 const = (constants.length < dstNumBands) ?
 constants[0] : constants[b];
 if (src[x][y][b] >= lowVal && src[x][y][b] <= highVal) {
 dst[x][y][b] = const;
 } else {
 dst[x][y][b] = src[x][y][b];
 }
 

Resource List

Name	Value
GlobalName	Threshold
LocalName	Threshold
Vendor	com.sun.media.jai
Description	Maps the pixels whose value falls between a low value and a high value to a constant.
DocURL	http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/operator/ThresholdDescriptor.html
Version	1.0
arg0Desc	The low value.
arg1Desc	The high value.
arg2Desc	The constant the pixels are mapped to.

Parameter List

Name	Class Type	Default Value
low	double[]	NO_PARAMETER_DEFAULT
high	double[]	NO_PARAMETER_DEFAULT
constants	double[]	NO_PARAMETER_DEFAULT

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:
  low - The low value.
Parameters:
  high - The high value.
Parameters:
  constants - The constant the pixels are mapped to.
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:
  low - The low value.
Parameters:
  high - The high value.
Parameters:
  constants - The constant the pixels are mapped to.
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:
  low - The low value.
Parameters:
  high - The high value.
Parameters:
  constants - The constant the pixels are mapped to.
Parameters:
  hints - The RenderingHints to use.May be null. The RenderedOp destination.
throws:
  IllegalArgumentException - if source0 is null.
throws:
  IllegalArgumentException - if low is null.
throws:
  IllegalArgumentException - if high is null.
throws:
  IllegalArgumentException - if constants 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:
  low - The low value.
Parameters:
  high - The high value.
Parameters:
  constants - The constant the pixels are mapped to.
Parameters:
  hints - The RenderingHints to use.May be null. The RenderableOp destination.
throws:
  IllegalArgumentException - if source0 is null.
throws:
  IllegalArgumentException - if low is null.
throws:
  IllegalArgumentException - if high is null.
throws:
  IllegalArgumentException - if constants is null.