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.raster.impl.store;

import java.awt.geom.AffineTransform;

import java.awt.geom.Point2D;

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

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

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

import org.gvsig.fmap.dal.coverage.store.RasterDataStore;

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

import org.gvsig.raster.cache.tile.Tile;

import org.gvsig.raster.cache.tile.exception.TileGettingException;

import org.gvsig.raster.impl.buffer.SpiRasterQuery;

/**

 * A kind of dataset which can be queried should implement this interface.

 *

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

 */

public interface QueryableRaster {

        /**

         * Gets the dataset of this queryable raster

         * @return RasterDataSet

         */

        public RasterDataStore getDataStore();

        /**

         * Obtiene la lista de bandas

         * @return BandList

         */

        public BandList getBands();

        /**

         * Asigna las bandas dibujables cuando se solicita una acci?n de lectura de datos

         * @param db int[]

         */

        public void setDrawableBands(int[] db);

        /**

         * Removes the drawable bands

         */

        public void clearDrawableBands();

        /**

         * Obtiene las bandas dibujables cuando se solicita una acci?n de lectura de datos

         * @return

         */

        public int[] getDrawableBands();

        /**

         * Obtiene el n?mero de bandas del raster

         * @return N?mero de bandas

         */

        public int getBandCount();

        /**

         * Obtiene el valor NoData asociado al raster.

         * @return

         */

        public NoData getNoDataValue();

        /**

         * Para este dataset asigna que bandas se pintaran

         * sobre el RasterBuf cuando se haga un update. Especificamos a 

         * trav?s de los par?metros para que posici?n del RasterBuf ir? 

         * dibujada con que banda del fichero de imagen.

         * @param posRasterBuf        Posici?n del RasterBuf que queremos pintar.

         * @param imageBand        Banda de la imagen que se pintar?

         */

        public void addDrawableBand(int posRasterBuf, int imageBand);

        /**

         * Obtiene la paleta correspondiente al nombre del fichero pasado por par?metro. 

         * @param fileName Nombre del fichero

         * @return Paleta o null si no la tiene

         */

        public ColorTable getColorTable(String fileName);

        /**

         * Obtiene la paleta correspondiente a uno de los ficheros que forman el GeoMultiRasterFile

         * @param i Posici?n del raster

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

         */

        public ColorTable getColorTable(int i);

        /**

         * Obtiene el extent del raster.

         * @return Extent

         */

        public Extent getExtent();

        /**

         * Gets an extent adjusted to the bounding box of this raster

         * @param e

         * @return

         */

        public Extent adjustToExtent(Extent e);

        /**

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

        /**

         * Recupera del raster la matriz de transformaci?n que lo situa en cualquier parte de la vista

         * @param band

         * @return AffineTransform

         */

        public AffineTransform getAffineTransform();

        /**

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

        /**

         * Gets a tile of data if the provider is able to return a tile

         * @param wPx

         * @param hPx

         * @param row

         * @param col

         * @param bbox

         * @param cacheStruct

         *        The client CacheStruct or null to use the preferred CacheStruct

         * @return 

         * @throws TileGettingException 

         */

        public Tile getTile(SpiRasterQuery q) throws TileGettingException;

}