Package org.geotools.parameter
Class ImagingParameters
Object
Formattable
AbstractParameter
ImagingParameters
- All Implemented Interfaces:
Serializable
,Cloneable
,GeneralParameterValue
,ParameterValueGroup
,Cloneable
Wraps a JAI's
ParameterList
. Any change to a parameter value in this group is
reflected into the underlying parameter list, and conversely. This adaptor is provided for
interoperability with Java Advanced Imaging. A typical
usage is to wrap a JAI operation descriptor into an
imaging parameter descriptor and create instances of
ImagingParameters
through the createValue
method.- Since:
- 2.2
- Author:
- Martin Desruisseaux (IRD)
- See Also:
-
Field Summary
FieldsFields inherited from class Formattable
SINGLE_LINE
-
Constructor Summary
ConstructorsConstructorDescriptionImagingParameters
(Map<String, ?> properties, ParameterList parameters) Constructs a parameter group wrapping the specified JAI parameters.ImagingParameters
(ImagingParameterDescriptors descriptor) Constructs a parameter group for the specified descriptor. -
Method Summary
Modifier and TypeMethodDescriptionAlways throws an exception, since JAI's parameter list don't have subgroups.clone()
Returns a deep copy of this group of parameter values.boolean
Compares the specified object with this parameter group for equality.Returns the abstract definition of this parameter.Always throws an exception, since JAI's parameter list don't have subgroups.int
hashCode()
Returns a hash value for this parameter group.Returns the value in this group for the specified identifier code.values()
Returns all values in this group as an unmodifiable list.Methods inherited from class AbstractParameter
formatWKT, toString, write
Methods inherited from class Formattable
cleanupThreadLocals, toWKT, toWKT, toWKT, toWKT
-
Field Details
-
parameters
public final ParameterList parametersThe JAI's parameter list. This is also the backing store for this parameter value group: all "ordinary" parameters (i.e. not including sources) are actually stored in this list.If the JAI descriptor is an instance of
OperationDescriptor
, then this parameter list is also an instance ofParameterBlockJAI
. The sources must be handled separatly, because the source type for a JAI operator (typicallyRenderedImage
) is not the same than the source type for a coverage operation (typicallyorg.geotools.api.coverage.GridCoverage
).
-
-
Constructor Details
-
ImagingParameters
Constructs a parameter group for the specified descriptor.- Parameters:
descriptor
- The descriptor for this group of parameters.
-
ImagingParameters
Constructs a parameter group wrapping the specified JAI parameters. A defaultImagingParameterDescriptors
is created.- Parameters:
properties
- Set of properties. Should contains at least"name"
.parameters
- The JAI's parameters.
-
-
Method Details
-
getDescriptor
Returns the abstract definition of this parameter.- Specified by:
getDescriptor
in interfaceGeneralParameterValue
- Specified by:
getDescriptor
in interfaceParameterValueGroup
- Overrides:
getDescriptor
in classAbstractParameter
- Returns:
- The abstract definition of this parameter or group of parameters.
-
values
Returns all values in this group as an unmodifiable list. The returned list contains all parameters found in the underlying parameter list. In addition, it may contains sources found in the JAI's operation descriptor.- Specified by:
values
in interfaceParameterValueGroup
- Returns:
- The values in this group.
-
parameter
Returns the value in this group for the specified identifier code. Getter and setter methods will use directly the JAI's parameter list as the underlying backing store, when applicable.- Specified by:
parameter
in interfaceParameterValueGroup
- Parameters:
name
- The case insensitive identifier code of the parameter to search for.- Returns:
- The parameter value for the given identifier code.
- Throws:
ParameterNotFoundException
- if there is no parameter value for the given identifier code.
-
groups
Always throws an exception, since JAI's parameter list don't have subgroups.- Specified by:
groups
in interfaceParameterValueGroup
- Parameters:
name
- The case insensitive identifier code of the parameter group to search for.- Returns:
- The set of all parameter group for the given identifier code.
- Throws:
ParameterNotFoundException
- if no descriptor was found for the given name.
-
addGroup
Always throws an exception, since JAI's parameter list don't have subgroups.- Specified by:
addGroup
in interfaceParameterValueGroup
- Parameters:
name
- The case insensitive identifier code of the parameter group to create.- Returns:
- A newly created parameter group for the given identifier code.
- Throws:
ParameterNotFoundException
- if no descriptor was found for the given name.
-
equals
Compares the specified object with this parameter group for equality.- Overrides:
equals
in classAbstractParameter
- Parameters:
object
- The object to compare tothis
.- Returns:
true
if both objects are equal.
-
hashCode
public int hashCode()Returns a hash value for this parameter group. This value doesn't need to be the same in past or future versions of this class.- Overrides:
hashCode
in classAbstractParameter
-
clone
Returns a deep copy of this group of parameter values.- Specified by:
clone
in interfaceCloneable
- Specified by:
clone
in interfaceGeneralParameterValue
- Specified by:
clone
in interfaceParameterValueGroup
- Overrides:
clone
in classAbstractParameter
- Returns:
- A copy of this parameter value or group.
- See Also:
-