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[][]	NO_PARAMETER_DEFAULT

See Also:

DataBuffer, ImageLayout, OperationDescriptor, Serialized Form

Fields inherited from class javax.media.jai.OperationDescriptorImpl

resources, sourceNames, supportedModes

Constructor Summary

MatchCDFDescriptor()
Constructor.

Method Summary

boolean

validateArguments(String modeName, ParameterBlock args, StringBuffer msg) Validates the input sources and parameter.

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

Constructor Detail

MatchCDFDescriptor

public MatchCDFDescriptor()

Constructor.

Method Detail

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

Tags copied from class: OperationDescriptorImpl

Parameters:

modeName - the operation mode name

args - 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)