|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public static interface CoverageStack.Element
An element in a coverage stack. Each element is expected to
extents over a range of z values (the new dimensions appended by the
CoverageStack
container). Implementations should be capable to returns coverage's
range of z-values without loading the coverage's data. If an
expensive loading is required, it should be delayed until the getCoverage(org.geotools.image.io.IIOListeners)
method
is invoked. If getCoverage
is invoked more than once, caching (if desirable) is
implementor's responsability.
All methods declares IOException
in their throws cause in case I/O operations are
required. Subclasses of IOException
include IIOException
for
image I/O operations, or RemoteException
for remote method invocations
(which may be useful for large images database backed by a distant server).
Method Summary | |
---|---|
org.opengis.coverage.Coverage |
getCoverage(IIOListeners listeners)
Returns the coverage, loading the data if needed. |
org.opengis.geometry.Envelope |
getEnvelope()
Returns the coverage envelope, or null if this information is too expensive to
compute. |
org.opengis.coverage.grid.GridGeometry |
getGridGeometry()
The coverage grid geometry, or null if this information do not applies or is too
expensive to compute. |
java.lang.String |
getName()
Returns a name for the coverage. |
org.opengis.coverage.SampleDimension[] |
getSampleDimensions()
The sample dimension for the coverage, or null if this information is too
expensive to compute. |
NumberRange |
getZRange()
Returns the minimum and maximum z values for the coverage. |
Method Detail |
---|
java.lang.String getName() throws java.io.IOException
getCoverage(org.geotools.image.io.IIOListeners)
in order to log a "Loading data..." message.
java.io.IOException
- if an I/O operation was required but failed.NumberRange getZRange() throws java.io.IOException
java.io.IOException
- if an I/O operation was required but failed.org.opengis.geometry.Envelope getEnvelope() throws java.io.IOException
null
if this information is too expensive to
compute. The envelope may or may not contains an extra dimension for the
range of z values, since the CoverageStack
class is
tolerant in this regard. This method should not load a large amount of data, since it
may be invoked soon.
java.io.IOException
- if an I/O operation was required but failed.org.opengis.coverage.grid.GridGeometry getGridGeometry() throws java.io.IOException
null
if this information do not applies or is too
expensive to compute. This method should not load a large amount of data, since it may be
invoked soon.
java.io.IOException
- if an I/O operation was required but failed.org.opengis.coverage.SampleDimension[] getSampleDimensions() throws java.io.IOException
null
if this information is too
expensive to compute. This method should not load a large amount of data, since it
may be invoked soon.
java.io.IOException
- if an I/O operation was required but failed.org.opengis.coverage.Coverage getCoverage(IIOListeners listeners) throws java.io.IOException
IIOListeners.addListenersTo(ImageReader)
method if they use an image reader
for loading data. Caching (if desired) is implementor's responsability. The default
CoverageStack
implementation caches only the last coverages used.
listeners
- Listeners to register to the image I/O reader,
if such a reader is going to be used.
java.io.IOException
- if a data loading was required but failed.
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |