public class NullDescriptor
extends javax.media.jai.OperationDescriptorImpl
OperationDescriptor
describing the "Null" operation.
The "Null" operation performs no processing. It merely propagates its first source along the operation chain unmodified. There may be an arbitrary number of sources but only the first one is passed along so it must have the appropriate class type for the operation mode.
This operation may be useful as a placeholder in operation chains and in creating nodes to which PropertyGenerator
s may be attached.
This would enable non-image data nodes to be present in chains without requiring that specific OperationDescriptor
s be implemented for
these operations. The PropertyGenerator
s required would in this case be added locally to the nodes using the
addPropertyGenerator()
method of the node.
Name | Value |
---|---|
GlobalName | Null |
LocalName | Null |
Vendor | it.geosolutions.jaiext |
Description | Operation used for wrapping other images with no processing. |
DocURL | Not Defined |
Version | 1.0 |
No parameters are needed for this operation.
OperationDescriptor
,
Serialized FormConstructor and Description |
---|
NullDescriptor()
Constructor.
|
Modifier and Type | Method and Description |
---|---|
static javax.media.jai.RenderedOp |
create(RenderedImage source0,
RenderingHints hints)
An operation which does no processing.
|
static javax.media.jai.RenderableOp |
createRenderable(RenderableImage source0,
RenderingHints hints)
An operation which does no processing.
|
Object |
getInvalidRegion(String modeName,
ParameterBlock oldParamBlock,
RenderingHints oldHints,
ParameterBlock newParamBlock,
RenderingHints newHints,
javax.media.jai.OperationNode node)
Calculates the region over which two distinct renderings of the "Null" operation may be expected to differ.
|
protected boolean |
validateSources(String modeName,
ParameterBlock args,
StringBuffer msg)
Returns
true if there is at least one source and the first source is a RenderedImage or RenderableImage . |
arePropertiesSupported, getDefaultSourceClass, getDestClass, getDestClass, 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, validateArguments, validateParameters, validateParameters, validateRenderableArguments, validateRenderableSources, validateSources
protected boolean validateSources(String modeName, ParameterBlock args, StringBuffer msg)
true
if there is at least one source and the first source is a RenderedImage
or RenderableImage
.validateSources
in class javax.media.jai.OperationDescriptorImpl
IllegalArgumentException
- if args
is null
.IllegalArgumentException
- if msg
is null
and the validation fails.public Object getInvalidRegion(String modeName, ParameterBlock oldParamBlock, RenderingHints oldHints, ParameterBlock newParamBlock, RenderingHints newHints, javax.media.jai.OperationNode node)
The operation returns an empty Shape
if the first source in each of the two ParameterBlock
s are equal according to
the equals()
method of the old source or null
for all other cases.
getInvalidRegion
in interface javax.media.jai.OperationDescriptor
getInvalidRegion
in class javax.media.jai.OperationDescriptorImpl
modeName
- The name of the mode.oldParamBlock
- The previous sources and parameters.oldHints
- The previous hints.newParamBlock
- The current sources and parameters.newHints
- The current hints.node
- The affected node in the processing chain (ignored).null
if there is no
common region of validity. A non-null
empty region indicates that the operation would produce identical data over the
bounds of the old rendering although perhaps not over the area occupied by the tiles of the old rendering.IllegalArgumentException
- if modeName
is null
or if either oldParamBlock
or
newParamBlock
is null
.IllegalArgumentException
- if oldParamBlock
or newParamBlock
does not contain at least one source.public static javax.media.jai.RenderedOp create(RenderedImage source0, RenderingHints hints)
Creates a ParameterBlockJAI
from all supplied arguments except hints
and invokes
JAI.create(String,ParameterBlock,RenderingHints)
.
source0
- RenderedImage
source 0.hints
- The RenderingHints
to use. May be null
.RenderedOp
destination.IllegalArgumentException
- if source0
is null
.JAI
,
ParameterBlockJAI
,
RenderedOp
public static javax.media.jai.RenderableOp createRenderable(RenderableImage source0, RenderingHints hints)
Creates a ParameterBlockJAI
from all supplied arguments except hints
and invokes
JAI.createRenderable(String,ParameterBlock,RenderingHints)
.
source0
- RenderableImage
source 0.hints
- The RenderingHints
to use. May be null
.RenderableOp
destination.IllegalArgumentException
- if source0
is null
.JAI
,
ParameterBlockJAI
,
RenderableOp
Copyright © 2006–2018 GeoSolutions. All rights reserved.