|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
@UML(identifier="CV_GridCoverageExchange", specification=OGC_01004) public interface GridCoverageExchange
Support for creation of grid coverages from persistent formats as well as exporting
a grid coverage to a persistent formats. For example, it allows for creation of grid
coverages from the GeoTIFF Well-known binary format and exporting to the GeoTIFF file format.
Basic implementations only require creation of grid coverages from a file format or resource.
More sophesticated implementations may extract the grid coverages from a database. In such
case, a GridCoverageExchange
instance will hold a connection to a specific
database and the dispose()
method will need to be invoked in order to close this
connection.
WARNING: THIS CLASS WILL CHANGE. Current API is derived from OGC Grid Coverages Implementation specification 1.0. We plan to replace it by new interfaces derived from ISO 19123 (Schema for coverage geometry and functions). Current interfaces should be considered as legacy and are included in this distribution only because they were part of GeoAPI 1.0 release. We will try to preserve as much compatibility as possible, but no migration plan has been determined yet. |
GridCoverageReader
,
GridCoverageWriter
Method Summary | |
---|---|
void |
dispose()
Deprecated. Allows any resources held by this object to be released. |
Format[] |
getFormats()
Deprecated. Retrieve information on file formats or resources available with the GridCoverageExchange implementation. |
GridCoverageReader |
getReader(Object source)
Deprecated. Returns a grid coverage reader that can manage the specified source |
GridCoverageWriter |
getWriter(Object destination,
Format format)
Deprecated. Returns a GridCoverageWriter that can write the specified format. |
Method Detail |
---|
@UML(identifier="getFormat", obligation=MANDATORY, specification=OGC_01004) Format[] getFormats()
GridCoverageExchange
implementation.
GridCoverageExchange
implementation.GridCoverageReader getReader(Object source) throws IOException
source
- An object that specifies somehow the data source. Can be a
String
, an InputStream
, a
FileChannel
, whatever. It's up to the associated
grid coverage reader to make meaningful use of it.
IOException
- if the format is not recognized, or if an error occurs during reading.GridCoverageWriter getWriter(Object destination, Format format) throws IOException
Format
interface.
Sample file formats include:
"GeoTIFF" - GeoTIFF "PIX" - PCI Geomatics PIX "HDF-EOS" - NASA HDF-EOS "NITF" - National Image Transfer Format "STDS-DEM" - Standard Transfer Data Standard
destination
- An object that specifies somehow the data destination.
Can be a String
, an OutputStream
,
a FileChannel
, whatever. It's up to the
associated grid coverage writer to make meaningful use of it.format
- the output format.
IOException
- if an error occurs during reading.void dispose() throws IOException
GridCoverageExchange
,
especially if it was holding a connection to a database.
IOException
- if an error occured while disposing resources
(for example closing a database connection).
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |