Application: gvSIG desktop » gvSIG raster

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

 * Interfaz que deben implementar cualquier fuente de datos raster. Estas pueden estar

 * compuestas por N datasets. B?sicamente hay dos fuentes que deben implementar este interfaz, 

 * MultiRasterDataset y CompositeDataset. La primera es un dataset compuesto por varios ficheros

 * con el mismo Extent de N bandas cada uno. MultiRasterDataset proporciona una encapsulaci?n al acceso

 * a datos de todos ellos. CompositeDataset es un dataset compuesto de N MultiRasterDatasets cuya extensi?n

 * es continua formando un Grid de datasets con continuidad espacial. IRasterDataSource proporciona

 * una visi?n de acceso a datos com?n para ambos.

	 * Dado unas coordenadas reales, un tama?o de buffer y un tama?o de raster. 

	 * Si el buffer es de mayor tama?o que el raster (supersampleo) quiere decir que 

	 * por cada pixel de buffer se repiten varios del raster. Esta funci?n calcula el 

	 * n?mero de pixels de desplazamiento en X e Y que corresponden al primer pixel del

	 * buffer en la esquina superior izquierda. Esto es necesario porque la coordenada

	 * solicitada es real y puede no caer sobre un pixel completo. Este calculo es

	 * util cuando un cliente quiere supersamplear sobre un buffer y que no se lo haga

	 * el driver autom?ticamente.

	 * @param dWorldTLX Coordenada real X superior izquierda

	 * @param dWorldTLY Coordenada real Y superior izquierda

	 * @param nWidth Ancho del raster

	 * @param nHeight Alto del raster

	 * @param bufWidth Ancho del buffer

	 * @param bufHeight Alto del buffer

	 * @return Array de cuatro. Los dos primeros elementos son el desplazamiento en X e Y y los dos segundos

	 * el tama?o en pixels de buffer de un pixel de la imagen en ancho y alto.  

	 */

	public double[] calcSteps(double dWorldTLX, double dWorldTLY, double dWorldBRX, double dWorldBRY,

			double nWidth, double nHeight, int bufWidth, int bufHeight);

	/**

	 * Lee un bloque completo de datos del raster y devuelve un array tridimensional del tipo correcto. Esta funci?n es util

	 * para una lectura rapida de todo el fichero sin necesidad de asignar vista.

	 * @param pos Posici?n donde se empieza  a leer

	 * @param blockHeight Altura m?xima del bloque leido

	 * @return Object que es un array tridimendional del tipo de datos del raster. (Bandas X Filas X Columnas)

	 * @throws InvalidSetViewException

	 * @throws FileNotOpenException

	 * @throws RasterDriverException

	 * Some sevices has neither limits nor pixel size. For instance, WebMapService 

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

	/**

	 * Gets a default band list for this provider

	 * @return

	 */

	public BandList getDefaultBandList();