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