ilog.views.maps.format.geotiff

Class IlvRasterGeoTiffReader

java.lang.Object

ilog.views.maps.raster.IlvRasterAbstractReader

ilog.views.maps.format.geotiff.IlvRasterGeoTiffReader

All Implemented Interfaces:

IlvPersistentObject, IlvMapFeatureIterator, IlvMapReusableFeatureIterator, Serializable

public class IlvRasterGeoTiffReader
extends IlvRasterAbstractReader

GeoTIFF reader that creates reprojectable and pixel-on-demand images. Example of use:

 // create the reader
  IlvRasterGeoTiffReader r = new IlvRasterGeoTiffReader();
 // add an image
  r.addMap(fileName);

Since:

JViews 7.5

See Also:

Serialized Form

Field Summary

Fields inherited from class ilog.views.maps.raster.IlvRasterAbstractReader

needReload

Constructor Summary

Constructors

Constructor and Description
IlvRasterGeoTiffReader() Default constructor.
IlvRasterGeoTiffReader(IlvInputStream stream) Creates a reader from saved information.

Method Summary

Modifier and Type	Method and Description
void	addMap(String fileName) Add an image specifying a file name.
void	addMap(URL url) Add an image specifying a URL.
static IlvRasterMappedBuffer	fillMappedRasterSource(IlvRasterProperties props, RenderedImage cr) Utility method to create the data buffer of an on-demand pixel image from a GeoTiff RenderedImage.
static BufferedImage	getAsBufferedImage(RenderedImage roughImage) Utility method to create a BufferedImage from a RenderedImage.
IlvCoordinateSystem	getCoordinateSystem() Returns the spatial reference system that describes the geotiff image.
IlvMathTransform	getInternalTransformation(int imageIndex) Return the projection associated with the raster stored at the given index.
IlvFeatureAttributeProperty	getProperties(int imageIndex) Returns the feature properties to be associated with the image.
boolean	isInteractiveProjectionInputEnabled() Returns true if the interactive input of the projection is enabled.
void	reload(IlvThreadMonitoringData monitorInfo) Given the state of the reader (the number of images were read, coverage zone,...), the purpose of this method is to recreate all images from the original source.
void	setInteractiveProjectionInputEnabled(boolean interactiveProjectionInputEnabled) Enables displaying a dialog when projection information is missing (default true).
void	write(IlvOutputStream stream) Writes the attributes of a persistent object.

Methods inherited from class ilog.views.maps.raster.IlvRasterAbstractReader

addRaster, computeGisImageBounds, computeLimits, createRasterTileLoader, dispose, getDefaultFeatureRenderer, getDefaultMaximumIntervalsForDeterminingImageLocation, getImageBounds, getImageCount, getInverseTransformation, getLowerRightCorner, getLowerRightCorner, getMaximumIntervalsForDeterminingImageLocation, getNextFeature, getRasterMappedBuffer, getRasterProperties, getTileLoader, getTileLoader, getTileLoaders, getTransformation, getUpperLeftCorner, getUpperLeftCorner, isForceImageLoadingWhenSaving, isGeoreferenced, isHighQualityRendering, isNeedReload, removeRaster, restart, setDefaultMaximumIntervalsForDeterminingImageLocation, setForceImageLoadingWhenSaving, setHighQualityRendering, setMaximumIntervalsForDeterminingImageLocation, setTransformation

Methods inherited from class java.lang.Object

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

Constructor Detail

IlvRasterGeoTiffReader

public IlvRasterGeoTiffReader()

Default constructor.

IlvRasterGeoTiffReader

public IlvRasterGeoTiffReader(IlvInputStream stream)
                       throws IlvReadFileException

Creates a reader from saved information.

Parameters:

stream - The stream to read from.

Throws:

IlvReadFileException

Method Detail

getCoordinateSystem

public IlvCoordinateSystem getCoordinateSystem()

Returns the spatial reference system that describes the geotiff image.

Returns:

The coordinate system, or null if the coordinate system is unknown.

See Also:

IlvMapFeatureIterator.getCoordinateSystem()

getInternalTransformation

public IlvMathTransform getInternalTransformation(int imageIndex)

Return the projection associated with the raster stored at the given index.

Specified by:

getInternalTransformation in class IlvRasterAbstractReader

Parameters:

imageIndex - The index of the raster.

Returns:

The projection that corresponds to the raster stored at the given index.

See Also:

IlvRasterAbstractReader.getInternalTransformation(int)

getProperties

public IlvFeatureAttributeProperty getProperties(int imageIndex)

Returns the feature properties to be associated with the image.

Specified by:

getProperties in class IlvRasterAbstractReader

Parameters:

imageIndex - The index of the image.

Returns:

The properties to be associated with the image.

See Also:

IlvRasterAbstractReader.getProperties(int)

write

public void write(IlvOutputStream stream)
           throws IOException

Writes the attributes of a persistent object.

Specified by:

write in interface IlvPersistentObject

Overrides:

write in class IlvRasterAbstractReader

Parameters:

stream - The output stream.

Throws:

IOException - thrown when an exception occurs during the write operation for this object.

isInteractiveProjectionInputEnabled

public boolean isInteractiveProjectionInputEnabled()

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

Returns:

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

Since:

JViews 8.6

setInteractiveProjectionInputEnabled

public void setInteractiveProjectionInputEnabled(boolean interactiveProjectionInputEnabled)

Enables displaying a dialog when projection information is missing (default true). Some GeoTiff files are missing the 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.

Since:

JViews 8.6

addMap

public void addMap(String fileName)
            throws IOException

Add an image specifying a file name.

Parameters:

fileName - The file name to read from.

Throws:

IOException

addMap

public void addMap(URL url)
            throws IOException

Add an image specifying a URL.

Parameters:

url - The URL to read the image from.

Throws:

IOException

Since:

JViews 7.5

reload

public void reload(IlvThreadMonitoringData monitorInfo)

Given the state of the reader (the number of images were read, coverage zone,...), the purpose of this method is to recreate all images from the original source. Note : this method should not rely on the list of IlvRasterProperties of the reader as they might not be saved when the theme only is saved.

Overrides:

reload in class IlvRasterAbstractReader

Parameters:

monitorInfo - Used to update task progress.

getAsBufferedImage

public static BufferedImage getAsBufferedImage(RenderedImage roughImage)

Utility method to create a BufferedImage from a RenderedImage.

Parameters:

roughImage - RenderedImage to analyze.

Returns:

A BufferedImage built using the ColorModel and a WritableRaster created from the initial BufferedImage.

fillMappedRasterSource

public static IlvRasterMappedBuffer fillMappedRasterSource(IlvRasterProperties props,
                                                           RenderedImage cr)

Utility method to create the data buffer of an on-demand pixel image from a GeoTiff RenderedImage. This method creates only the necessary rasters for each tile and then copies them in the memory-mapped data to reduce memory "peak".

Parameters:

props - Raster properties in which to store the GeoTiff ColorModel.

cr - GeoTiff image.

Returns:

An integer raster that maps image pixels.