Application: gvSIG desktop » gvSIG raster

package org.gvsig.raster.cache.buffer.impl.datasource;

import java.awt.geom.Point2D;

import org.gvsig.raster.cache.buffer.Buffer;

/**

 * Interfaz que deben implementar cualquier fuente de datos raster. Cualquier fuente

 * de datos que alimente una cache de informaci?n debe implementar este interfaz para

 * que pueda ser aprovechada por esta.

 * 

 * @version 27/08/2007

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

 *

 */

public interface IRasterDataSource {

        /**

         * 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();

        /**

         * Obtiene el n?mero de bandas del raster

         * @return N?mero de bandas

         */

        public int getBandCount();

        /**

         * Obtiene el n?mero de datasets con el extent completo del IRasterDataSource. El valor 

         * devuelto por esta llamada coincidir?a con el valor devuelto por getDatasetCount() de un

         * MultiRasterDataset que lo compone.

         * @return integer.

         */

        public int getDatasetCount();

        /**

         * 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 una ventana de datos de la imagen a partir de coordenadas reales. 

         * No aplica supersampleo ni subsampleo sino que devuelve una matriz de igual tama?o a los

         * pixeles de disco. 

         * @param x Posici?n X superior izquierda

         * @param y Posici?n Y superior izquierda

         * @param w Ancho en coordenadas pixel

         * @param h Alto en coordenadas pixel

         * @param bandList

         * @return Buffer de datos

         */

        public Buffer getWindowRaster(int x, int y, int w, int h) 

                throws InvalidSetViewException, InterruptedException, DriverException;

        /**

         * Obtiene una ventana de datos de la imagen a partir de coordenadas reales. 

         * Aplica supersampleo o subsampleo en funci?n del tama?o del buffer

         * @param x Posici?n X superior izquierda en pixels

         * @param y Posici?n Y superior izquierda en pixels

         * @param w Ancho en pixels

         * @param h Alto en pixels

         * @param bufWidth ancho del buffer de datos

         * @param bufHeight alto del buffer de datos

         * @param bandList

         * @return Buffer de datos

         */

        public Buffer getWindowRaster(int x, int y, int w, int h, int bufWidth, int bufHeight) 

                throws InvalidSetViewException, InterruptedException, DriverException;

        /**

         * Obtiene el valor del raster en la coordenada que se le pasa.

         * El valor ser? Double, Int, Byte, etc. dependiendo del tipo de

         * raster.

         * @param x        coordenada X

         * @param y coordenada Y

         * @return

         */

        public Object getData(int x, int y, int band)throws InvalidSetViewException, FileNotOpenException, DriverException;

        /**

         * 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); 

        /**

         * Obtiene en un array de String la lista de nombres de ficheros. 

         * @param i Columna para un CompositeDataset 

         * @param j Fila para un CompositeDataset

         * @return lista de nombres de los ficheros del GeoRasterMultiFile

         */

        public String[] getNameDatasetStringList(int i, int j);

        /**

         * Calcula el tama?o en byte de los raster.

         * @return tama?o en bytes de todos los ficheros de la lista

         */

        public long getFileSize();

}