javax.media.jai.operator
Class MatchCDFDescriptor
java.lang.Object
|
+--javax.media.jai.OperationDescriptorImpl
|
+--javax.media.jai.operator.MatchCDFDescriptor
- All Implemented Interfaces:
- OperationDescriptor, RegistryElementDescriptor, Serializable
- public class MatchCDFDescriptor
- extends OperationDescriptorImpl
An OperationDescriptor
describing the "MatchCDF" operation.
The "MatchCDF" operation performs a piecewise linear mapping of the
pixel values of an image such that the Cumulative Distribution Function
(CDF) of the destination image matches as closely as possible a specified
Cumulative Distribution Function. The desired CDF is described by an
array of the form
float CDF[numBands][numBins[b]]
where
numBins[b]
denotes the number of bins in the histogram of the
source image for band b. Each element in the array
CDF[b]
must be non-negative, the array must represent a non-
decreasing sequence, and the last element of the array must be 1.0F.
The source image must have a Histogram
object available via
its getProperty()
method.
Resource List
Name | Value |
GlobalName | MatchCDF |
LocalName | MatchCDF |
Vendor | com.sun.media.jai |
Description | Matches pixel values to a supplied CDF. |
DocURL | http://java.sun.com/products/java-media/jai/forDevelopers/jai-apidocs/javax/media/jai/operator/MatchCDFDescriptor.html |
Version | 1.0 |
arg0Desc | The desired Cumulative Distribution Function. |
Parameter List
Name | Class Type |
Default Value |
CDF | float[][] |
CDF for histogram equalization |
- See Also:
DataBuffer
,
ImageLayout
,
OperationDescriptor
, Serialized Form
Methods inherited from class javax.media.jai.OperationDescriptorImpl |
arePropertiesSupported, getDefaultSourceClass, getDestClass, getDestClass, getInvalidRegion, getName, getNumParameters, getNumSources, getParamClasses, getParamDefaults, getParamDefaultValue, getParameterListDescriptor, getParamMaxValue, getParamMinValue, getParamNames, getPropertyGenerators, getPropertyGenerators, getRenderableDestClass, getRenderableSourceClasses, getResourceBundle, getResources, getSourceClasses, getSourceClasses, getSourceNames, getSupportedModes, isImmediate, isModeSupported, isRenderableSupported, isRenderedSupported, makeDefaultSourceClassList, validateArguments, validateParameters, validateParameters, validateRenderableArguments, validateRenderableSources, validateSources, validateSources |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
MatchCDFDescriptor
public MatchCDFDescriptor()
- Constructor.
validateArguments
public boolean validateArguments(String modeName,
ParameterBlock args,
StringBuffer msg)
- Validates the input sources and parameter.
In addition to the standard checks performed by the
superclass method, this method checks that the source image
contains a "histogram" property and that the "CDF" array
is appropriate for it.
- Overrides:
validateArguments
in class OperationDescriptorImpl
- Following copied from class:
javax.media.jai.OperationDescriptorImpl
- Parameters:
modeName
- the operation mode nameargs
- Input arguments, including source(s) and/or parameter(s).msg
- A string that may contain error messages.- Throws:
IllegalArgumentException
- if modeName
is null
- See Also:
OperationDescriptorImpl.validateSources(java.lang.String, java.awt.image.renderable.ParameterBlock, java.lang.StringBuffer)
,
OperationDescriptorImpl.validateParameters(java.lang.String, java.awt.image.renderable.ParameterBlock, java.lang.StringBuffer)
create
public static RenderedOp create(RenderedImage source0,
float[][] CDF,
RenderingHints hints)
- Matches pixel values to a supplied CDF.
Creates a ParameterBlockJAI
from all
supplied arguments except hints
and invokes
JAI.create(String,ParameterBlock,RenderingHints)
.
- Parameters:
source0
- RenderedImage
source 0.CDF
- The desired Cumulative Distribution Function.
May be null
.hints
- The RenderingHints
to use.
May be null
.- Returns:
- The
RenderedOp
destination. - Throws:
IllegalArgumentException
- if source0
is null
.- See Also:
JAI
,
ParameterBlockJAI
,
RenderedOp
createRenderable
public static RenderableOp createRenderable(RenderableImage source0,
float[][] CDF,
RenderingHints hints)
- Matches pixel values to a supplied CDF.
Creates a ParameterBlockJAI
from all
supplied arguments except hints
and invokes
JAI.createRenderable(String,ParameterBlock,RenderingHints)
.
- Parameters:
source0
- RenderableImage
source 0.CDF
- The desired Cumulative Distribution Function.
May be null
.hints
- The RenderingHints
to use.
May be null
.- Returns:
- The
RenderableOp
destination. - Throws:
IllegalArgumentException
- if source0
is null
.- See Also:
JAI
,
ParameterBlockJAI
,
RenderableOp