ilog.views.maps.format.geotiff

Class IlvGeotiffReader

java.lang.Object

ilog.views.maps.format.geotiff.IlvGeotiffReader

All Implemented Interfaces:

IlvMapFeatureIterator

public class IlvGeotiffReader
extends Object
implements IlvMapFeatureIterator

A TIFF reader that implements the IlvMapFeatureIterator interface. This reader uses org.apache.batik based libraries included in JViews jars , and needs these libraries in order to compile and run. The georeferencing of the produced image is only available if the file contains a coordinate system tag. This reader is also able to retrieve a given tile assuming that the file is a tiled TIFF file.

Since:

JViews 7.5

Constructor Summary

Constructors

Constructor and Description
IlvGeotiffReader(String fileName) Constructs a new TIFF reader by passing a TIFF file name .
IlvGeotiffReader(String fileName, IlvWKTCoordinateSystemDictionary WKTdictionary) Constructs a new TIFF reader by passing a TIFF file name and a WKT coordinate system dictionary.
IlvGeotiffReader(URL url) Constructs a new TIFF reader by passing a TIFF URL.
IlvGeotiffReader(URL url, IlvWKTCoordinateSystemDictionary WKTdictionary) Constructs a new TIFF reader by passing a TIFF URL and a WKT coordinate system dictionary.

Method Summary

Modifier and Type	Method and Description
void	dispose() This dispose method does not close the stream opened by the reader.
protected void	finalize() Calls dispose().
IlvCoordinateSystem	getCoordinateSystem() Returns the coordinate system in which the image is expressed.
IlvFeatureRenderer	getDefaultFeatureRenderer() Retrieves the default feature renderer, which is an IlvDefaultImageRenderer.
RenderedImage	getImage() Returns the RenderedImage opened by the reader.
IlvCoordinate	getLowerRightCorner() Returns the lower right corner of the image.
IlvMapFeature	getNextFeature() Returns the map feature whose geometry is an IlvMapImage.
IlvProjection	getProjection() Returns the projection in which the image is expressed.
RenderedImage	getTile(int c, int r) Retrieves the tile at row c and column r as a RenderedImage.
IlvRect	getTileOrigin() Retrieves the tile origin if the TIFF file is tiled.
IlvCoordinate	getUpperLeftCorner() Returns the upper left corner of the image.
boolean	isGeoreferenced() Checks the content of the TIFF directory.
boolean	isInteractiveProjectionInputEnabled() Returns true if the interactive input of the projection is enabled.
protected IlvMapGeometry	makeGeometry() Constructs the geometry, which is an IlvMapImage.
void	setCoordinateSystem(IlvCoordinateSystem coordsys) Sets the coordinate system in which the image is expressed.
void	setInteractiveProjectionInputEnabled(boolean interactiveProjectionInputEnabled) Enables the display of a dialog when projection information is missing (default is true).
void	setLowerRightCorner(IlvCoordinate c) Sets the lower right corner of the image.
void	setUpperLeftCorner(IlvCoordinate c) Sets the upper left corner of the image.

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvGeotiffReader

public IlvGeotiffReader(String fileName,
                        IlvWKTCoordinateSystemDictionary WKTdictionary)
                 throws IOException

Constructs a new TIFF reader by passing a TIFF file name and a WKT coordinate system dictionary.

Parameters:

fileName - The TIFF file name.

WKTdictionary - The dictionary of coordinate systems.

Throws:

IOException

Since:

JViews 7.5

IlvGeotiffReader

public IlvGeotiffReader(URL url,
                        IlvWKTCoordinateSystemDictionary WKTdictionary)
                 throws IOException

Constructs a new TIFF reader by passing a TIFF URL and a WKT coordinate system dictionary.

Parameters:

url - The TIFF URL

WKTdictionary - The dictionary of coordinate systems.

Throws:

IOException

Since:

JViews 7.5

IlvGeotiffReader

public IlvGeotiffReader(URL url)
                 throws IOException

Constructs a new TIFF reader by passing a TIFF URL.

Parameters:

url - The TIFF file name.

Throws:

IOException

Since:

JViews 7.5

IlvGeotiffReader

public IlvGeotiffReader(String fileName)
                 throws IOException

Constructs a new TIFF reader by passing a TIFF file name .

Parameters:

fileName - The TIFF file name.

Throws:

IOException

Since:

JViews 7.5

Method Detail

getTileOrigin

public IlvRect getTileOrigin()
                      throws Exception

Retrieves the tile origin if the TIFF file is tiled. This method is used by the IlvGeotiffTileLoader to retrieve the origin tile of the file. If the file is not tiled, an IllegalArgumentException is thrown.

Returns:

The tile origin if the TIFF file is tiled.

Throws:

Exception - if the Tiff file is not tiled.

getTile

public RenderedImage getTile(int c,
                             int r)

Retrieves the tile at row c and column r as a RenderedImage. The returned value can be null if the requested tile is not part of the image.

Parameters:

c - The tile column.

r - The tile row.

Returns:

The tile at row c and column r.

makeGeometry

protected IlvMapGeometry makeGeometry()
                               throws IlvProjectionException,
                                      IOException

Constructs the geometry, which is an IlvMapImage.

Returns:

The image geometry.

Throws:

IOException

IlvProjectionException

getNextFeature

public IlvMapFeature getNextFeature()
                             throws IOException

Returns the map feature whose geometry is an IlvMapImage.

Specified by:

getNextFeature in interface IlvMapFeatureIterator

Returns:

The feature containing an IlvMapGeometry.

Throws:

IOException - if the image cannot be decoded.

isGeoreferenced

public boolean isGeoreferenced()

Checks the content of the TIFF directory.

Specified by:

isGeoreferenced in interface IlvMapFeatureIterator

See Also:

IlvMapFeatureIterator.isGeoreferenced()

getProjection

public IlvProjection getProjection()

Returns the projection in which the image is expressed.

Returns:

The projection in which the image is expressed.

getCoordinateSystem

public IlvCoordinateSystem getCoordinateSystem()

Returns the coordinate system in which the image is expressed.

Specified by:

getCoordinateSystem in interface IlvMapFeatureIterator

Returns:

The coordinate system in which the image is expressed.

setCoordinateSystem

public void setCoordinateSystem(IlvCoordinateSystem coordsys)

Sets the coordinate system in which the image is expressed.

Parameters:

coordsys - The coordinate system to use.

setLowerRightCorner

public void setLowerRightCorner(IlvCoordinate c)

Sets the lower right corner of the image.

Parameters:

c - The lower right corner

getLowerRightCorner

public IlvCoordinate getLowerRightCorner()

Returns the lower right corner of the image.

Specified by:

getLowerRightCorner in interface IlvMapFeatureIterator

Returns:

The lower right corner of the image.

setUpperLeftCorner

public void setUpperLeftCorner(IlvCoordinate c)

Sets the upper left corner of the image.

Parameters:

c - The upper left corner of the image.

getUpperLeftCorner

public IlvCoordinate getUpperLeftCorner()

Returns the upper left corner of the image.

Specified by:

getUpperLeftCorner in interface IlvMapFeatureIterator

Returns:

The upper left corner of the image.

dispose

public void dispose()

This dispose method does not close the stream opened by the reader. When using the standard "getNextFeature" map loading, the image generated will need access to this stream to display each tile.

Specified by:

dispose in interface IlvMapFeatureIterator

finalize

protected void finalize()

Calls dispose().

Overrides:

finalize in class Object

getImage

public RenderedImage getImage()

Returns the RenderedImage opened by the reader.

Returns:

The RenderedImage opened by the reader.

getDefaultFeatureRenderer

public IlvFeatureRenderer getDefaultFeatureRenderer()

Retrieves the default feature renderer, which is an IlvDefaultImageRenderer.

Specified by:

getDefaultFeatureRenderer in interface IlvMapFeatureIterator

Returns:

The default feature renderer, which is an IlvDefaultImageRenderer.

isInteractiveProjectionInputEnabled

public boolean isInteractiveProjectionInputEnabled()

Returns true if the interactive input of the projection is enabled.

Returns:

true if the interactive input of the projection is enabled.

setInteractiveProjectionInputEnabled

public void setInteractiveProjectionInputEnabled(boolean interactiveProjectionInputEnabled)

Enables the display of a dialog when projection information is missing (default is true). Some GeoTiff files have missing coordinate system information. If you enable the interactive projection input, a dialog will then be displayed asking the user to interactively select the image internal projection.

Parameters:

interactiveProjectionInputEnabled - true to enable interactive projection input.