|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
ObjectAbstractGridCoverage2DReader
ImagePyramidReader
public final class ImagePyramidReader
This reader is repsonsible for providing access to a pyramid of mosaics of georeferenced coverages that are read directly through imageio readers, like tiff, pngs, etc...
Specifically this plugin relies on the image mosaic plugin to handle each single level of resolutions avaible, hence all the magic is done inside the mosaic plugin.
For information on how to build a mosaic, please refere to the
ImageMosaicReader
documentation.
If you are looking for information on how to create a pyramid, here you go. The pyramid itself does no magic. All the magic is performed by the single mosaic readers that are polled depending on the requeste resolution levels. Therefore the first step is having a mosaic of images like geotiff, tiff, jpeg, or png which is going to be the base for te pyramid.
The second step is to build the next (lower resolution) levels for
the pyramid.
If you look inside the spike dire of the geotools project you will find a
(growing) set of tools that can be used for doing processing on coverages.
Specifically there is one tool called PyramidBuilder that can be used to
build the pyramid level by level.
Last step is providing a prj file with the projection of the pyramid (btw all the levels has to be in the same projection) as well as a properties file with this structure:
# #Mon Aug 21 22:23:27 CEST 2006 #name of the coverage Name=ikonos #different resolution levels available Levels=1.2218682749859724E-5,9.220132503102996E-6 2.4428817977683634E-5,1.844026500620314E-5 4.8840552865873626E-5,3.686350299024973E-5 9.781791400307775E-5,7.372700598049946E-5 1.956358280061555E-4,1.4786360643866836E-4 3.901787184256844E-4,2.9572721287731037E-4 #where all the levels reside LevelsDirs=0 2 4 8 16 32 #number of levels availaible LevelsNum=6 #envelope for this pyramid Envelope2D=13.398228477973406,43.591366397808976 13.537912459169803,43.67121274528585
Field Summary |
---|
Fields inherited from class AbstractGridCoverage2DReader |
---|
closeMe, coverageFactory, coverageName, crs, gzipped, highestRes, hints, inStream, inStreamSPI, numOverviews, originalEnvelope, originalGridRange, overViewResolutions, raster2Model, source |
Constructor Summary | |
---|---|
ImagePyramidReader(Object source)
Constructor for an ImagePyramidReader . |
|
ImagePyramidReader(Object source,
Hints uHints)
Constructor for an ImagePyramidReader . |
Method Summary | |
---|---|
void |
dispose()
Disposes this reader. |
Format |
getFormat()
Returns the format handled by this GridCoverageReader . |
int |
getGridCoverageCount()
Number of coverages for this reader is 1 |
ImageMosaicReader |
getImageMosaicReaderForLevel(Integer imageChoice)
Retrieve the ImageMosaicReader for the requested Level and load if necessary |
String[] |
getMetadataNames()
Returns the list of metadata keywords associated with the input source as a whole (not associated with any particular grid coverage). |
String |
getMetadataValue(String name)
Retrieve data value for requested metadata |
GridCoverage2D |
read(GeneralParameterValue[] params)
Read the current grid coverage from the stream. |
Methods inherited from class Object |
---|
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface GridCoverageReader |
---|
getCurrentSubname, getGridCoverageNames, getMetadataNames, getMetadataValue, getSource, hasMoreGridCoverages, listSubNames, read, skip |
Constructor Detail |
---|
public ImagePyramidReader(Object source, Hints uHints) throws IOException
ImagePyramidReader
.
source
- The source object.uHints
- Hints
to control the behaviour of this reader.
IOException
UnsupportedEncodingException
public ImagePyramidReader(Object source) throws IOException
ImagePyramidReader
.
source
- The source object.
IOException
UnsupportedEncodingException
Method Detail |
---|
public Format getFormat()
GridCoverageReader
GridCoverageReader
.
getFormat
in interface GridCoverageReader
public GridCoverage2D read(GeneralParameterValue[] params) throws IOException
AbstractGridCoverage2DReader
Example:
The method AbstractGridCoverage2DReader.hasMoreGridCoverages()
should be invoked first in order to verify that a coverage is available.
read
in interface GridCoverage2DReader
read
in interface GridCoverageReader
read
in class AbstractGridCoverage2DReader
params
- Optional parameters matching Format.getReadParameters()
.
IOException
- if a read operation failed for some other input/output reason, including FileNotFoundException
if no file with the
given name
can be found, or IIOException
if an error was thrown by the underlying image library.public void dispose()
AbstractGridCoverage2DReader
This method just tries to close the underlying ImageInputStream
.
dispose
in interface GridCoverageReader
dispose
in class AbstractGridCoverage2DReader
GridCoverageReader.dispose()
public int getGridCoverageCount()
getGridCoverageCount
in interface GridCoverageReader
getGridCoverageCount
in class AbstractGridCoverage2DReader
GridCoverageReader.getGridCoverageCount()
public String getMetadataValue(String name)
getMetadataValue
in interface GridCoverageReader
getMetadataValue
in class AbstractGridCoverage2DReader
name
- Metadata keyword for which to retrieve metadata.
GridCoverageReader.getMetadataNames()
.GridCoverageReader.getMetadataValue(java.lang.String)
public String[] getMetadataNames()
GridCoverageReader
getMetadataNames
in interface GridCoverageReader
getMetadataNames
in class AbstractGridCoverage2DReader
GridCoverageReader.getMetadataNames()
public ImageMosaicReader getImageMosaicReaderForLevel(Integer imageChoice) throws MalformedURLException, IOException
MalformedURLException
IOException
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |