| gvSIG desktop 1

 * de consulta. Tipicamente en gvSIG es implementado por DataSource que ofrecer?

 * sus datos a trav?s de un RasterBuffer y su interfaz IBuffer.

	/**

	 * Obtiene el ancho de la imagen

	 * @return  Ancho en pixeles de la imagen

	 */

	public int getWidth();

	 * Obtiene el alto de la imagen

	 * @return  Alto en pixeles de la imagen

	public int getHeight();

	 * Tama?o de celda en X

	 * @return 

	public double getXCellSize();

	/**

	 * Tama?o de celda en Y

	 * @return

	 */

	public double getYCellSize();

	/**

	 * Asigna el ?rea de interes en coordenadas del mundo real. Si las coordenadas exceden del tama?o de la imagen

	 * estas coordenadas son ajustadas el extent.

	 * @param x Coordenada X, esquina superior izquierda

	 * @param y Coordenada Y, esquina superior izquierda

	 * @param w Ancho del ?rea 

	 * @param h Alto del ?rea

	 * @param adjustToExtent Flag que dice si el extent solicitado debe ajustarse al extent del raster o no.

	 * @throws ArrayIndexOutOfBoundsException

	 */

	public void setAreaOfInterest(double x, double y, double w, double h, boolean adjustToExtent) throws ArrayIndexOutOfBoundsException;

	/**

	 * Asigna el ?rea de interes en coordenadas pixel. Si las coordenadas exceden del tama?o de la imagen

	 * lanza una excepci?n.

	 * @param x Coordenada X, esquina superior izquierda

	 * @param y Coordenada Y, esquina superior izquierda

	 * @param w Ancho del ?rea 

	 * @param h Alto del ?rea

	 * @throws ArrayIndexOutOfBoundsException

	 */

	public void setAreaOfInterest(int x, int y, int w, int h) throws ArrayIndexOutOfBoundsException;

	/**

	 * Asigna el ?rea de inter?s a toda la extensi?n del raster.

	 */

	public void setAreaOfInterest();

	/**

	 * Asigna el ?rea de interes en coordenadas pixel. Esta operaci?n cargar? un RasterBuffer con los datos solicitados por

	 * lo que, si al acabar hacemos getRasterBuf obtendremos la matriz de datos. Si las coordenadas exceden del tama?o 

	 * de la imagen lanza una excepci?n.

	 * @param x Coordenada X, esquina superior izquierda

	 * @param y Coordenada Y, esquina superior izquierda

	 * @param w Ancho del ?rea 

	 * @param h Alto del ?rea

	 * @param bufWidth Ancho del buffer

	 * @param bufHeight Alto del buffer

	 * @throws ArrayIndexOutOfBoundsException

	 */

	public void setAreaOfInterest(int x, int y, int w, int h, int bufWidth, int bufHeight) throws ArrayIndexOutOfBoundsException;

	/**

	 * Asigna el ?rea de interes en coordenadas del mundo real. Si las coordenadas exceden del tama?o de la imagen

	 * estas coordenadas son ajustadas el extent.

	 * @param x Coordenada X, esquina superior izquierda

	 * @param y Coordenada Y, esquina superior izquierda

	 * @param w Ancho del ?rea 

	 * @param h Alto del ?rea

	 * @param bufWidth Ancho del buffer

	 * @param bufHeight Alto del buffer

	 * @param adjustToExtent Flag que dice si el extent solicitado debe ajustarse al extent del raster o no. 

	 * @return En caso de que el buffer sea mayor que el tama?o seleccionado de raster se produce supersampleo. La funci?n devuelve

	 * un array de dos elementos que representan el desplazamiento en pixels de X e Y de la esquina superior izquierda. 

	 * @throws ArrayIndexOutOfBoundsException

	 */

	public int[] setAreaOfInterest(double minX, double minY, double maxX, double maxY, int bufWidth, int bufHeight, boolean adjustToExtent) throws ArrayIndexOutOfBoundsException;

	/**

	 * Obtiene un buffer desde la posici?n x,y en pixeles de ancho w y alto h

	 * @param x Coordenada x de la esquina superior izquierda

	 * @param y Coordenada y de la esquina superior izquierda

	 * @param w Ancho del grid

	 * @param h Alto del grid

	 * @return Buffer de datos

	 */

	public RasterBuffer getData(int x, int y, int w, int h);

	/**

	 * Devuelve el tipo de datos del raster

	 * @see java.awt.image.DataBuffer

	 */

	public int getDataType();

	/**

	 * Asigna tipo de datos del raster

	 * @see java.awt.image.DataBuffer

	 */

	public void setDataType(int dt);

	/**

	 * Devuelve true si la celda contiene un valor de NODATA

	 * @param x	coordenada X

	 * @param y coordenada Y

	 * @return

	 */

	public boolean isNoData(int x, int y, int band);

	/**

	 * Obtiene el n?mero de bandas

	 * @return N?mero de bandas

	 */

	public int getBandCount();

	/**

	 * Obtiene el buffer de datos del grid

	 * @return RasterBuf

	 */

	public IBuffer getRasterBuf();

	/**

	 * Para este GeoRasterFile asigna que bandas se pintaran

	 * sobre el RasterBuf cuando se haga un update. Cada posici?n del vector es una banda

	 * del rasterBuf y el contenido de esa posici?n es la banda de la imagen que se dibujar?

	 * sobre ese RasterBuf.

	 * @param drawableBands	Array con las bandas a dibujar.

	 * @return array con tantos elementos como bandas a dibujar. El valor contenido es el fichero del 

	 * dataset multifichero al que corresponde la banda.

	 */

	public int[] addDrawableBands(int[] drawableBands);

	/**

	 * Para este GeoRasterFile asigna que bandas se pintaran

	 * sobre el RasterBuf cuando se haga un update. Cada posici?n del vector es una banda

	 * del rasterBuf y el contenido de esa posici?n es la banda de la imagen que se dibujar?

	 * sobre ese RasterBuf. Esta llamada asigna todas las bandas dibujables en su orden natural.

	 * @return array con tantos elementos como bandas a dibujar. El valor contenido es el fichero del 

	 * dataset multifichero al que corresponde la banda.

	 */

	public int[] setAllDrawableBands();

	/**

	 * Obtiene el array que contiene el orden de bandas. Cada posici?n del vector es una banda

	 * del rasterBuf y el contenido de esa posici?n es la banda de la imagen que se dibujar?

	 * sobre ese RasterBuf.

	 * @return Array de enteros con el orden de las badas

	 */

	public int[] getDrawableBands();

	/**

	 * Obtiene el extent de la fuente de datos

	 * @return Extent

	 */

	public Extent getExtent();

	/**

	 * Obtiene el extent correspondiente a los datos cargados en el buffer

	 * @return Extent

	 */

	public Extent getDataExtent();

	/**

	 * Obtiene las coordenadas del fichero worldFile (o cabecera del raster) asociado 

	 * o el RMF en caso de que existan. Si la imagen no est? georreferenciada tendr?

	 * las coordenadas pixel de la misma 

	 * @return Array de seis valores:

	 * 	<TABLE BORDER="1">

	 * 	<TR><TD><B>0:</B></TD><TD>Valor X de la esquina superior izquierda.</TD></TR>

	 * 	<TR><TD><B>1:</B></TD><TD>Tama?o de pixel en X.</TD></TR>

	 * 	<TR><TD><B>2:</B></TD><TD>Shearing en X.</TD></TR>

	 * 	<TR><TD><B>3:</B></TD><TD>Valor Y de la esquina superior izquierda.</TD></TR>

	 * 	<TR><TD><B>4:</B></TD><TD>Shearing en Y.</TD></TR>

	 * 	<TR><TD><B>5:</B></TD><TD>Tama?o de pixel en Y.</TD></TR>

	 * 	</TABLE>

	 */

	public double[] getCoordsGeoTransformFile();

	/**

	 * Obtiene el extent de la ?ltima selecci?n hecha con alguna de las llamadas

	 * setAreaOfInterest. Este extent es devuelto en coordenadas reales con las transformaciones

	 * que se hayan aplicado sobre el/los dataset.

	 * @return Extent Coordenadas reales que representan el ?ltimo ?rea de datos

	 * solicitada.

	 */

	public Extent getLastSelectedView();

	/**

	 * Obtiene la estructura que contiene la lista de ficheros del Grid

	 * @return GeoRasterMultiFile

	 */

	public RasterMultiDataset getGeoRasterMultiFile();

	/**

	 * Obtiene la lista de paletas asociadas a las bandas cargadas en el DataSource

	 * @return Lista con las paletas o null si no hay ninguna asocida. Un nulo en una

	 * posici?n del array tambi?n indicar? que para esa banda no hay paletas asociadas.

	 */

	public DatasetPalette[] getPalettes();