/*
* GeoTools - The Open Source Java GIS Toolkit
* http://geotools.org
*
* (C) 2005-2008, Open Source Geospatial Foundation (OSGeo)
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation;
* version 2.1 of the License.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*/
/*
* NOTICE OF RELEASE TO THE PUBLIC DOMAIN
*
* This work was created by employees of the USDA Forest Service's
* Fire Science Lab for internal use. It is therefore ineligible for
* copyright under title 17, section 105 of the United States Code. You
* may treat it as you would treat any public domain work: it may be used,
* changed, copied, or redistributed, with or without permission of the
* authors, for free or for compensation. You may not claim exclusive
* ownership of this code because it is already owned by everyone. Use this
* software entirely at your own risk. No warranty of any kind is given.
*
* A copy of 17-USC-105 should have accompanied this distribution in the file
* 17USC105.html. If not, you may access the law via the US Government's
* public websites:
* - http://www.copyright.gov/title17/92chap1.html#105
* - http://www.gpoaccess.gov/uscode/ (enter "17USC105" in the search box.)
*/
package org.geotools.gce.geotiff;
import it.geosolutions.imageioimpl.plugins.tiff.TIFFImageReaderSpi;
import it.geosolutions.imageioimpl.plugins.tiff.TIFFImageWriterSpi;
import java.io.File;
import java.io.IOException;
import java.net.URL;
import java.util.HashMap;
import java.util.logging.Level;
import java.util.logging.Logger;
import javax.imageio.ImageIO;
import javax.imageio.ImageReader;
import javax.imageio.metadata.IIOMetadata;
import javax.imageio.stream.ImageInputStream;
import org.geotools.coverage.grid.io.AbstractGridFormat;
import org.geotools.coverage.grid.io.imageio.GeoToolsWriteParams;
import org.geotools.coverage.grid.io.imageio.geotiff.GeoTiffIIOMetadataDecoder;
import org.geotools.data.DataSourceException;
import org.geotools.data.DataUtilities;
import org.geotools.data.MapInfoFileReader;
import org.geotools.factory.Hints;
import org.geotools.parameter.DefaultParameterDescriptor;
import org.geotools.parameter.DefaultParameterDescriptorGroup;
import org.geotools.parameter.ParameterGroup;
import org.opengis.coverage.grid.Format;
import org.opengis.coverage.grid.GridCoverageReader;
import org.opengis.coverage.grid.GridCoverageWriter;
import org.opengis.parameter.GeneralParameterDescriptor;
import org.opengis.parameter.GeneralParameterValue;
import org.opengis.referencing.operation.MathTransform;
/**
* Provides basic information about the GeoTIFF format IO. This is currently an
* extension of the Geotools AbstractGridFormat because the stream and file GCEs
* will pick it up if it extends AbstractGridFormat.
*
* @author Bryce Nordgren, USDA Forest Service
* @author Simone Giannecchini
*
*
* @source $URL$
*/
public class GeoTiffFormat extends AbstractGridFormat implements Format {
/** Logger. */
private final static Logger LOGGER = org.geotools.util.logging.Logging
.getLogger(GeoTiffFormat.class);
/**
* This {@link GeneralParameterValue} can be provided to the
* {@link GeoTiffWriter}s in order
* to force the writer to write a tfw file.
*/
public static final DefaultParameterDescriptor<Boolean> WRITE_TFW = new DefaultParameterDescriptor<Boolean>(
"WRITE_TFW", Boolean.class, new Boolean[] {
Boolean.TRUE, Boolean.FALSE }, Boolean.FALSE);
/**
* This {@link GeneralParameterValue} can be provided to the
* {@link GeoTiffWriter}s in order
* to force the writer to retain the axes order.
*/
public static final DefaultParameterDescriptor<Boolean> RETAIN_AXES_ORDER = new DefaultParameterDescriptor<Boolean>(
"RETAIN_AXES_ORDER", Boolean.class, new Boolean[] {
Boolean.TRUE, Boolean.FALSE }, Boolean.FALSE);
/** factory for getting tiff writers. */
final static TIFFImageWriterSpi IMAGEIO_WRITER_FACTORY = new TIFFImageWriterSpi();
/** SPI for the reader. */
private final static TIFFImageReaderSpi IMAGEIO_READER_FACTORY = new TIFFImageReaderSpi();
/**
* Creates a new instance of GeoTiffFormat
*/
public GeoTiffFormat() {
writeParameters = null;
mInfo = new HashMap<String, String>();
mInfo.put("name", "GeoTIFF");
mInfo.put("description","Tagged Image File Format with Geographic information");
mInfo.put("vendor", "Geotools");
mInfo.put("version", "1.1");
mInfo.put("docURL", "http://www.remotesensing.org/geotiff/spec/geotiffhome.html");
// reading parameters
readParameters = new ParameterGroup(
new DefaultParameterDescriptorGroup(
mInfo,
new GeneralParameterDescriptor[] { READ_GRIDGEOMETRY2D,INPUT_TRANSPARENT_COLOR,SUGGESTED_TILE_SIZE }));
// writing parameters
writeParameters = new ParameterGroup(
new DefaultParameterDescriptorGroup(
mInfo,
new GeneralParameterDescriptor[] {RETAIN_AXES_ORDER,AbstractGridFormat.GEOTOOLS_WRITE_PARAMS,AbstractGridFormat.PROGRESS_LISTENER }));
}
/**
* Currently, we only accept files, and we open the file to verify that it
* has a GeoKeyDirectory tag. If anything more subtle is wrong with the
* file, we deal with that when we try and read it.
*
* @param o
* the source object to test for compatibility with this format.
*
*
* @return true if "o" is a File or a URL that points to a GeoTiff with a
* GeoTiff file as a resource.
*/
@Override
public boolean accepts(Object o,Hints hints) {
if (o == null) {
return false;
}
ImageReader reader = null;
ImageInputStream inputStream = null;
boolean closeMe = true;
try {
if (o instanceof URL) {
// /////////////////////////////////////////////////////////////
//
// URL management
// In case the URL points to a file we need to get to the fie
// directly and avoid caching. In case it points to http or ftp
// or it is an opnen stream we have very small to do and we need
// to enable caching.
//
// /////////////////////////////////////////////////////////////
final URL url = (URL) o;
o = DataUtilities.urlToFile(url);
} else if(o instanceof ImageInputStream) {
closeMe=false;
}
// get a stream
inputStream = (ImageInputStream) ((o instanceof ImageInputStream) ? o: ImageIO.createImageInputStream(o));
if (inputStream == null) {
if (LOGGER.isLoggable(Level.FINE))
LOGGER.fine("Unable to get an ImageInputStream");
return false;
}
// get a reader
if (!IMAGEIO_READER_FACTORY.canDecodeInput(inputStream))
return false;
reader = IMAGEIO_READER_FACTORY.createReaderInstance();
inputStream.mark();
reader.setInput(inputStream);
final IIOMetadata metadata = reader.getImageMetadata(0);
if(metadata==null)
return false;
//
// parse metadata and be resilient with CRS
//
final GeoTiffIIOMetadataDecoder metadataAdapter = new GeoTiffIIOMetadataDecoder(metadata);
if(!metadataAdapter.hasGeoKey()&& LOGGER.isLoggable(Level.FINE))
LOGGER.fine("Unable to find geokey directory for this tif file");
//
// analyze georeferencing
//
// do we have verything as geotiff?
if(metadataAdapter.hasModelTrasformation()|| (metadataAdapter.hasPixelScales()&&metadataAdapter.hasTiePoints()))
return true;
// now look for info into a WLD file or TAB file
MathTransform raster2Model = GeoTiffReader.parseWorldFile(o);
if (raster2Model == null) {
raster2Model = GeoTiffReader.parseMapInfoFile(o).getTransform();
}
if (raster2Model != null)
return true;
else{
if (LOGGER.isLoggable(Level.FINE))
LOGGER.fine("Unable to find georeferencing for this tif file");
return false;
}
} catch (Throwable e) {
if (LOGGER.isLoggable(Level.FINE))
LOGGER.log(Level.FINE, e.getLocalizedMessage(), e);
return false;
} finally {
if (reader != null) {
try{
reader.dispose();
}catch (Exception e) {
}
}
if (closeMe && inputStream != null) {
try{
inputStream.close();
}catch (Throwable t) {
}
}
}
}
/**
* If <CODE>source</CODE> is a file, this will return a reader object.
* This file does not use hints in the construction of the geotiff reader.
*
* @param source
* must be a GeoTiff File
*
* @return a GeoTiffReader object initialized to the specified File.
*/
@Override
public GeoTiffReader getReader(Object source) {
return getReader(source, null);
}
/**
* If <CODE>source</CODE> is a file, this will return a reader object.
* This file does not use hints in the construction of the geotiff reader.
*
* @param source
* must be a GeoTiff File
* @param hints
* Hints to pass the hypothetic {@link GridCoverageReader} to
* control its behaviour.
*
* @return a GeoTiffReader object initialized to the specified File.
*/
@Override
public GeoTiffReader getReader(Object source, Hints hints) {
// if (source instanceof CatalogEntry) {
// source = ((CatalogEntry) source).resource();
// }
if (source instanceof URL) {
URL url = (URL) source;
try {
final File file = DataUtilities.urlToFile(url);
return new GeoTiffReader(file, hints);
} catch (DataSourceException e) {
if (LOGGER.isLoggable(Level.WARNING))
LOGGER.log(Level.WARNING, e.getLocalizedMessage(), e);
return null;
}
}
try {
return new GeoTiffReader(source, hints);
} catch (DataSourceException e) {
if (LOGGER.isLoggable(Level.WARNING))
LOGGER.log(Level.WARNING, e.getLocalizedMessage(), e);
return null;
}
}
/**
* Retrieves a {@link GeoTiffWriter} or <code>null</code> if the provided
* <code>destination</code> is suitable.
*
* This file does not use hints in the construction of the geotiff reader.
*
* @param destination
* must be a GeoTiff File
* @param hints
* Hints to pass the hypothetic {@link GridCoverageReader} to
* control its behaviour.
*
* @return a GeoTiffReader object initialized to the specified File.
*/
@Override
public GridCoverageWriter getWriter(Object destination, Hints hints) {
try {
return new GeoTiffWriter(destination, hints);
} catch (IOException e) {
if (LOGGER.isLoggable(Level.WARNING))
LOGGER.log(Level.WARNING, e.getLocalizedMessage(), e);
return null;
}
}
/**
* Retrieves a {@link GeoTiffWriter} or <code>null</code> if the provided
* <code>destination</code> is suitable.
*
* This file does not use hints in the construction of the geotiff reader.
*
* @param destination
* must be a GeoTiff File
*
* @return a GeoTiffReader object initialized to the specified File.
*/
@Override
public GridCoverageWriter getWriter(Object destination) {
try {
return new GeoTiffWriter(destination);
} catch (IOException e) {
if (LOGGER.isLoggable(Level.WARNING))
LOGGER.log(Level.WARNING, e.getLocalizedMessage(), e);
return null;
}
}
/**
* Returns an instance of {@link GeoTiffWriteParams} for controlling an
* hypothetic writing process.
*
* @return an instance of {@link GeoTiffWriteParams}.
*/
@Override
public GeoToolsWriteParams getDefaultImageIOWriteParameters() {
return new GeoTiffWriteParams();
}
}