Application: gvSIG desktop » gvSIG raster

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program 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 General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.fmap.dal.coverage.store;

import java.awt.geom.AffineTransform;

import java.awt.geom.Point2D;

import org.cresques.cts.IProjection;

import org.gvsig.fmap.dal.DataStore;

import org.gvsig.fmap.dal.coverage.dataset.Buffer;

import org.gvsig.fmap.dal.coverage.datastruct.BandList;

import org.gvsig.fmap.dal.coverage.datastruct.Extent;

import org.gvsig.fmap.dal.coverage.exception.BandAccessException;

import org.gvsig.fmap.dal.coverage.exception.HistogramException;

import org.gvsig.fmap.dal.coverage.exception.InvalidSetViewException;

import org.gvsig.fmap.dal.coverage.exception.ProcessInterruptedException;

import org.gvsig.fmap.dal.coverage.exception.RasterDriverException;

import org.gvsig.fmap.dal.coverage.exception.RmfSerializerException;

import org.gvsig.fmap.dal.coverage.grid.render.Render;

import org.gvsig.fmap.dal.coverage.process.vector.Vectorization;

import org.gvsig.fmap.dal.coverage.store.props.ColorInterpretation;

import org.gvsig.fmap.dal.coverage.store.props.ColorTable;

import org.gvsig.fmap.dal.coverage.store.props.Histogram;

import org.gvsig.fmap.dal.coverage.store.props.Histogramable;

import org.gvsig.fmap.dal.coverage.store.props.Metadata;

import org.gvsig.fmap.dal.coverage.store.props.SerialInfo;

import org.gvsig.fmap.dal.coverage.store.props.Statistics;

import org.gvsig.fmap.dal.coverage.store.props.Transparency;

import org.gvsig.fmap.dal.exception.CloseException;

import org.gvsig.fmap.dal.raster.spi.CoverageStoreProvider;

/**

 * Interfaz que deben implementar los almacenes de datos raster.

 * 

 * @author Nacho Brodin (nachobrodin@gmail.com)

 */

public interface RasterDataStore extends DataStore, Histogramable {

        public static final int              RED_BAND            = 0x01;

        public static final int              GREEN_BAND          = 0x02;

        public static final int              BLUE_BAND           = 0x04;

        public static final int              ALPHA_BAND          = 0x08;

        /**

         * Obtiene el tipo de dato por banda

         * @return tipo de dato por banda

         */

        public int[] getDataType();

        /**

         * Obtiene el valor NoData asociado al raster.

         * @return

         */

        public double getNoDataValue();

        /**

         * Vuelve a poner el valor noData como estaba inicialmente

         */

        public void resetNoDataValue();

        /**

         * Define el valor NoData asociado al raster.

         * @return

         */

        public void setNoDataValue(double value);

        /**

         * Obtiene si esta activo el valor NoData asociado al raster.

         * @return

         */

        public boolean isNoDataEnabled();

        /**

         * Define si se activa el valor NoData asociado al raster.

         * @return

         */

        public void setNoDataEnabled(boolean enabled);

        /**

         * Obtiene el n?mero de bandas del raster

         * @return N?mero de bandas

         */

        public int getBandCount();

        /**

         * Gets the number of sources that this data store has

         * @return

         */

        public int getDataStoreCount();

        /**

         * Obtiene la altura del raster en p?xeles.

         * @return altura

         */

        public double getHeight();

        /**

         * Obtiene la anchura del raster en p?xeles.

         * @return anchura

         */

        public double getWidth();

        /**

         * Obtiene el tama?o de celda del raster

         * @return Valor del tama?o de celda

         */

        public double getCellSize();

        /**

         * Obtiene el tama?o de pixel en X

         * @return tama?o de pixel en X

         */

        public double getPixelSizeX();

        /**

         * Obtiene el tama?o de pixel en Y

         * @return tama?o de pixel en Y

         */

        public double getPixelSizeY();

        /**

         * Obtiene el extent asignado

         * @return        Extent

         */

        public Extent getView();

        /**

         * Este es el extent sobre el que se ajusta una petici?n para que esta no

         * exceda el extent m?ximo del raster. Para un raster sin rotar ser? igual al

         * extent pero para un raster rotado ser? igual al extent del raster como si

         * no tuviera rotaci?n. Esto ha de ser as? ya que la rotaci?n solo se hace

         * sobre la vista y las peticiones han de hacerse en coordenadas de la imagen

         * sin shearing aplicado.

         * @return Extent

         */

        public Extent getExtentWithoutRot();

        /**

         * Crea un un nuevo dataset que referencia al mismo fichero en disco

         * @return IRasterDataSource

         */

        public RasterDataStore newDataStore();

        /**

         * Obtiene el Tama?o de cada fichero de que consta el raster en bytes. 

         * @return long que representa el tama?o

         */

        public long getFileSize();

        /**

         * Obtiene el extent del raster.

         * @return Extent

         */

        public Extent getExtent();

        /**

         * Convierte un punto desde coordenadas pixel a coordenadas del mundo.

         * @param pt Punto a transformar

         * @return punto transformado en coordenadas del mundo

         */

        public Point2D rasterToWorld(Point2D pt);

        /**

         * Convierte un punto desde del mundo a coordenadas pixel.

         * @param pt Punto a transformar

         * @return punto transformado en coordenadas pixel

         */

        public Point2D worldToRaster(Point2D pt);

        /**

         * Obtiene el flag que dice si el raster est? o no georreferenciado

         * @return true si est? georreferenciado y false si no lo est?.

         */

        public boolean isGeoreferenced();

        /**

         * Obtiene el nombre del dataStore

         * @return String 

         *         nombre del fichero

         */

        public String getName();

        /**

         * Obtiene la proyecci?n asociada al raster. Como todos los dataset del 

         * multiDataset deben tener la misma proyecci?n obtenemos esta del primer

         * dataset.

         * @return Proyecci?n en formato cadena

         * @throws RasterDriverException

         */

        public String getWktProjection() throws RasterDriverException;

        /**

         * Metodo que obtiene si un punto cae dentro de los l?mites de la extensi?n de la fuente de 

         * datos raster o fuera de ellos.

         * @param p Punto a calcular

         * @return true si est? dentro de los l?mites y false si est? fuera

         */

        public boolean isInside(Point2D p); 

        /**

         * Returns true if this data store is reproyectable or false if not

         * @return

         */

        public boolean isReproyectable();

        /**

         * Obtiene la matriz de transformaci?n del propio raster. Esta matriz es la

         * encargada de convertir las coordenadas de la petici?n en coordenadas a las

         * que se pide a la libreria. En gdal, por ejemplo, se piden las coordenadas a

         * la libreria en coordenadas pixel por lo que esta matriz tendr? la

         * georreferenciaci?n asociada en el worldfile o cabecera. Otras librerias

         * como ermapper la petici?n a la libreria se hace en coordenadas geograficas

         * que son las mismas en las que pide el usuario de gvSIG por lo que esta

         * matriz en este caso se inicializa con la identidad.

         * @return

         */

        public AffineTransform getOwnAffineTransform();

        /**

         * Obtiene la transformaci?n afin aplicada en las peticiones con coordenadas

         * reales. Esta corresponde al producto matricial entre la transformaci?n de

         * la propia georreferenciaci?n del raster (ownTransformation) y la

         * transformaci?n que se le aplique de forma externa. Si esta ?ltima no existe

         * ser? la matriz identidad.

         * @return Matriz de la transformaci?n af?n.

         */

        public AffineTransform getAffineTransform();

        /**

         * Asigna una transformaci?n al raster para que se tenga en cuenta en la

         * asignaci?n del setView. Esta asignaci?n recalcula el extent, el

         * requestExtent y asigna el AffineTransform que se usar? para la

         * transformaci?n. Esta transformaci?n ser? considerada como si la imagen

         * tuviera asociado un rmf.

         * @param t Transformaci?n af?n a aplicar

         */

        public void setAffineTransform(AffineTransform transf);

        /**

         * Obtiene la proyecci?n del dataset

         * @return IProjection

         */

        public IProjection getProjection();

        /**

         * Consulta de si un raster tiene rotaci?n o no.

         * @return true si tiene rotaci?n y false si no la tiene.

         */

        public boolean isRotated();

        public Transparency getTransparencyFilesStatus();

        /**

         * Obtiene el n?mero de overviews de una banda

         * @return N?mero de overviews del raster.

         */

        public int getOverviewCount(int band) throws BandAccessException, RasterDriverException;

        /**

         * Informa de si el dataset soporta overviews o no.

         * @return true si soporta overviews y false si no las soporta.

         */

        public boolean overviewsSupport();

        /**

         * Gets an object which vectorize a raster

         * @return

         * @throws RasterDriverException

         * @throws ProcessInterruptedException

         *         When the object Vectorization is built the raster data buffer is loaded. 

         *         This operation can be interrupted

         */

        public Vectorization createVectorizeObject() throws RasterDriverException, ProcessInterruptedException;

        /**

         * Builds an render object using this RasterDataStore

         * @return Render

         */

        public Render getRender();

        /**

         * Assigns a render object

         * @param render

         */

        public void setRender(Render render);

        /**

         * Saves georeferencing information in the rmf file

         * @throws RmfSerializerException

         */

        public void saveGeoreferencingToRmf() throws RmfSerializerException;

        /**

         * Saves a color table

         * @param table

         * @throws RmfSerializerException

         */

        public void saveColorTableToRmf(ColorTable table) throws RmfSerializerException;

        /**

         * Tipo de fichero soportado.

         * Devuelve true si el tipo de fichero (extension) est? soportado, si no

         * devuelve false.

         *

         * @param fName Fichero raster

         * @return  true si est? soportado, si no false.

                */

        public boolean isFileSupported(String fName);

        /**

         * Returns true if this DataStore is open and false if not

         * @return

         */

        public boolean isOpen();

        /**

         * Obtiene el ancho de una overview de una banda

         * @return

         */

        public int getOverviewWidth(int band, int overview) throws BandAccessException, RasterDriverException;

        /**

         * Obtiene el alto de una overview de una banda

         * @return

         */

        public int getOverviewHeight(int band, int overview) throws BandAccessException, RasterDriverException;

        /**

         * Returns the band list

         * @return

         */

        public BandList getBands();

        /**

         * Clones this object

         * @return RasterDataStore

         */

        public RasterDataStore cloneDataStore();

        /**

         * Gets a provider

         * @return

         */

        public CoverageStoreProvider getProvider();

        /**

         * Closes this data store

         * @throws CloseException

         */

        public void close() throws CloseException;

        //******************************************

        //***********Dataset Properties*************

        /**

         * Obtiene el objeto que contiene que contiene la interpretaci?n de 

         * color por banda para el dataset seleccionado

         * @param dataset Dataset del que se necesesita la informaci?n de color dentro del RasterMultiDataset

         * @return DatasetColorInterpretation

         */

        public ColorInterpretation getColorInterpretation();

        /**

         * Gets the object with the metadata

         * @return

         */

        public Metadata getMetadata();

        /**

         * Obtiene la paleta correspondiente al dataset. 

         * @return Paleta asociada a este o null si no tiene

         */

        public ColorTable getColorTable();

        /**

         * Obtiene el estado de transparencia a partir de los estados de transparencia de todos

         * los ficheros que lo componen. Si varios de los ficheros que lo componen tienen banda de 

         * transparencia estas tendr?n que ser mezcladas sobre una banda de transparencia ?nica.

         * @return Objeto FileTransparency con el estado de transparencia

         */

        public Transparency getTransparency();

        /**

         * Obtiene el objeto con las estadisticas

         * @return MultiFileStatistics

         */

        public Statistics getStatistics();

        /**

         * Obtiene el histograma asociado al dataset. 

         *

         * @return Histograma asociado al dataset.

         */

        public Histogram getHistogram() throws HistogramException;

        /**

         * Gets the serial information

         * @return

         * @throws RmfSerializerException 

         */

        public SerialInfo getSerialInfo() throws RmfSerializerException;

        /**

         * Sets the serial information

         * @throws RmfSerializerException 

         */

        public void setSerialInfo(SerialInfo serialInfo) throws RmfSerializerException;

        //******************************************

        //***********Query methods******************

        /**

         * Returns the last buffer loaded if the flag storeLastBuffer in the query is true

         * @return

         */

        public Buffer getLastBuffer();

        /**

         * Gets the step

         * @return

         */

        public double[] getStep();

        /**

         * Hace una consulta para la carga de un buffer de datos.

         * @param query 

         * @return IBuffer

         */

        public Buffer query(RasterQuery query) throws ProcessInterruptedException, RasterDriverException, InvalidSetViewException;

}