org.geotools.coverageio.jp2k

Class JP2KReader

Object

AbstractGridCoverage2DReader

JP2KReader

All Implemented Interfaces:

GridCoverage2DReader, GridCoverageReader

public final class JP2KReader
extends AbstractGridCoverage2DReader
implements GridCoverage2DReader

This class can read a JP2K data source and create a GridCoverage2D from the data.

Author:

Daniele Romagnoli, GeoSolutions., Simone Giannecchini (simboss), GeoSolutions

Field Summary

Fields inherited from class AbstractGridCoverage2DReader

closeMe, coverageFactory, coverageName, crs, dtLayout, EPS, gzipped, highestRes, hints, inStream, inStreamSPI, numOverviews, originalEnvelope, originalGridRange, overViewResolutions, raster2Model, source

Fields inherited from interface GridCoverage2DReader

ELEVATION_DOMAIN, ELEVATION_DOMAIN_MAXIMUM, ELEVATION_DOMAIN_MINIMUM, ELEVATION_DOMAIN_RESOLUTION, FILE_SOURCE_PROPERTY, HAS_ELEVATION_DOMAIN, HAS_TIME_DOMAIN, MULTICRS_READER, REPROJECTING_READER, SOURCE_URL_PROPERTY, TIME_DOMAIN, TIME_DOMAIN_MAXIMUM, TIME_DOMAIN_MINIMUM, TIME_DOMAIN_RESOLUTION

Constructor Summary

Constructors

Constructor and Description
JP2KReader(Object input) Creates a new instance of a JP2KReader.
JP2KReader(Object source, Hints uHints) Constructor.

Method Summary

Modifier and Type	Method and Description
void	dispose() Releases resources held by this reader.
protected GeneralEnvelope	getCoverageEnvelope()
protected GridEnvelope2D	getCoverageGridRange()
Format	getFormat() Returns the format handled by this GridCoverageReader.
int	getGridCoverageCount() Number of coverages for this reader is 1
protected void	parsePRJFile() Gets the coordinate reference system that will be associated to the GridCoverage by looking for a related PRJ.
protected void	parseWorldFile() Checks whether a world file is associated with the data source.
GridCoverage2D	read(GeneralParameterValue[] params) Read the current grid coverage from the stream.
protected void	setCoverageEnvelope(GeneralEnvelope coverageEnvelope)
protected void	setCoverageGridRange(GridEnvelope2D coverageGridRange)
protected void	setCoverageProperties(ImageReader reader) Setting Envelope, GridRange and CRS from the given ImageReader

Methods inherited from class AbstractGridCoverage2DReader

addAllSiblings, addSiblings, checkName, createImageCoverage, createImageCoverage, createImageCoverage, createImageCoverage, decimationOnReadingControl, decimationOnReadingControl, finalize, getCoordinateReferenceSystem, getCoordinateReferenceSystem, getCrs, getCurrentSubname, getDatasetLayout, getDatasetLayout, getDynamicParameters, getDynamicParameters, getFiles, getGridCoverageNames, getGroundControlPoints, getGroundControlPoints, getHighestRes, getImageLayout, getImageLayout, getInfo, getInfo, getMetadataNames, getMetadataNames, getMetadataValue, getMetadataValue, getMultiLevelROIProvider, getNumOverviews, getNumOverviews, getOriginalEnvelope, getOriginalEnvelope, getOriginalGridRange, getOriginalGridRange, getOriginalGridToWorld, getOriginalGridToWorld, getOverviewGridEnvelope, getOverviewGridEnvelope, getReadingResolutions, getReadingResolutions, getRescaledRasterToModel, getResolution, getResolutionLevels, getResolutionLevels, getSibling, getSource, getSourceAsFile, hasMoreGridCoverages, listSubNames, read, setlayout, setLayout, setReadParams, setReadParams, skip

Methods inherited from class Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface GridCoverage2DReader

getCoordinateReferenceSystem, getCoordinateReferenceSystem, getDatasetLayout, getDatasetLayout, getDynamicParameters, getDynamicParameters, getImageLayout, getImageLayout, getInfo, getInfo, getNumOverviews, getNumOverviews, getOriginalEnvelope, getOriginalEnvelope, getOriginalGridRange, getOriginalGridRange, getOriginalGridToWorld, getOriginalGridToWorld, getReadingResolutions, getReadingResolutions, getResolutionLevels, getResolutionLevels, read

Methods inherited from interface GridCoverageReader

getCurrentSubname, getGridCoverageNames, getMetadataNames, getMetadataNames, getMetadataValue, getMetadataValue, getSource, hasMoreGridCoverages, listSubNames, skip

Constructor Detail

JP2KReader

public JP2KReader(Object input)
           throws IOException

Creates a new instance of a JP2KReader. I assume nothing about file extension.

Parameters:

input - Source object for which we want to build an JP2KReader.

Throws:

DataSourceException

IOException

JP2KReader

public JP2KReader(Object source,
                  Hints uHints)
           throws IOException

Constructor.

Parameters:

source - The source object.

Throws:

IOException

UnsupportedEncodingException

Method Detail

setCoverageProperties

protected void setCoverageProperties(ImageReader reader)
                              throws IOException

Setting Envelope, GridRange and CRS from the given ImageReader

Parameters:

reader - the ImageReader from which to retrieve metadata (if available) for setting properties

Throws:

IOException

setCoverageEnvelope

protected void setCoverageEnvelope(GeneralEnvelope coverageEnvelope)

Parameters:

nativeEnvelope - the nativeEnvelope to set

getCoverageEnvelope

protected GeneralEnvelope getCoverageEnvelope()

Returns:

the nativeEnvelope

setCoverageGridRange

protected void setCoverageGridRange(GridEnvelope2D coverageGridRange)

Parameters:

nativeGridRange - the nativeGridRange to set

getCoverageGridRange

protected GridEnvelope2D getCoverageGridRange()

Returns:

the nativeGridRange

getGridCoverageCount

public int getGridCoverageCount()

Number of coverages for this reader is 1

Specified by:

getGridCoverageCount in interface GridCoverageReader

Overrides:

getGridCoverageCount in class AbstractGridCoverage2DReader

Returns:

the number of coverages for this reader.

See Also:

GridCoverageReader.getGridCoverageCount()

dispose

public void dispose()

Releases resources held by this reader.

Specified by:

dispose in interface GridCoverageReader

Overrides:

dispose in class AbstractGridCoverage2DReader

getFormat

public Format getFormat()

Description copied from interface: GridCoverageReader

Returns the format handled by this GridCoverageReader.

Specified by:

getFormat in interface GridCoverageReader

See Also:

GridCoverageReader.getFormat()

read

public GridCoverage2D read(GeneralParameterValue[] params)
                    throws IOException

Description copied from class: AbstractGridCoverage2DReader

Read the current grid coverage from the stream.

Example:

The method AbstractGridCoverage2DReader.hasMoreGridCoverages() should be invoked first in order to verify that a coverage is available.

Specified by:

read in interface GridCoverage2DReader

Specified by:

read in interface GridCoverageReader

Specified by:

read in class AbstractGridCoverage2DReader

Parameters:

params - Optional parameters matching Format.getReadParameters().

Returns:

a grid coverage from the input source.

Throws:

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.

See Also:

GridCoverageReader.read(org.opengis.parameter.GeneralParameterValue[])

parsePRJFile

protected void parsePRJFile()
                     throws UnsupportedEncodingException

Gets the coordinate reference system that will be associated to the GridCoverage by looking for a related PRJ.

Throws:

UnsupportedEncodingException

parseWorldFile

protected void parseWorldFile()
                       throws IOException

Checks whether a world file is associated with the data source. If found, set a proper envelope.

Throws:

IllegalStateException

IOException