Application: gvSIG desktop » gvSIG raster

org.gvsig.raster.cache.tile.TileCacheLibrary

/* 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.cache.buffer;

import java.io.IOException;

import org.gvsig.raster.cache.buffer.histogram.BufferHistogram;

import org.gvsig.raster.cache.buffer.task.TaskEventManager;

/**

 * This class is responsible of the management of the library's business logic.

 * It is the library's main entry point, and provides all the services to manage

 * {@link BufferCacheService}s.

 * 

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

 * @version $Id$

 */

public interface BufferCacheManager {

	public static int		      DONT_FORCE                 = 0;

	public static int		      MEMORY_BUFFER              = 1;

	public static int		      BAND_CACHE                 = 2;

	public static int		      BAND_VERT_CACHE            = 3;

	public static int		      READ_ONLY_CACHE            = 4;

	/**

	 * Valor noData por defecto para la librer?a. En caso de no tener un valor asociado

	 * al raster se usar? este.

	 */

	public static double            defaultNoDataValue       = -99999;

	public static boolean           noDataValueEnable        = false;

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

	//BUFFER API

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

	/**

	 * Genera instancias del buffer de datos adecuado al tama?o del raster. Si no hay muchos datos

	 * (menos de cacheMemorySize) crear? un buffer en memoria. Si hay m?s de esta cantidad

	 * entonces crearemos un buffer cacheado (RasterCache). A partir de la cantidad se?alada

	 * por multicacheMemorySize haremos un buffer cacheado donde cada p?gina no ocupa todo

	 * el ancho del raster ya que este ser? muy grande. La gesti?n de una cache donde cada

	 * pagina ha de partir una l?nea lleva una complejidad a?adida.

	 *  

	 * @param params Par?metros de la carga

	 * @return Objeto RasterBuffer

	 */

	public Buffer createBuffer(BufferParam params);

	/**

	 * Genera una instancia del buffer de solo lectura. Este buffer consta de una cache y unos apuntadores

	 * a las p?ginas en disco. Cuando se accede a los datos se carga en memoria la p?gina pedida.

	 *  

	 * @param  file 

	 *         File to read data

	 */

	public Buffer createReadOnlyBuffer(String file);

	/**

	 * Creates an instance of a memory buffer

	 * 

	 * @param dataType Tipo de dato

	 * @param width Ancho

	 * @param height Alto

	 * @param bandNr Banda

	 * @param flag En caso de buffers de memoria este flag a true significa que se reserva la memoria

	 * para el buffer de forma normal y si est? a false no se reserva por lo que la reserva deber? ser

	 * posterior. 

	 */

	public Buffer createMemoryBuffer(int dataType, int width, int height, int bandNr, boolean malloc);

	/**

	 * Creates an instance of a memory buffer

	 * 

	 * @param params

	 *        Parameters to instantiate this buffer

	 */

	public Buffer createMemoryBuffer(BufferParam params);

	/**

	 * Creates a new instance of an interpolation object.

	 * @param buf IRasterBuffer

	 * @return IBufferInterpolation

	 */

	public BufferInterpolation createInterpolation(Buffer buf);

	/**

	 * Builds a new parameter object

	 * @param  x

	 *         Upper left X position 

	 * @param  y

	 *         Upper left X position

	 * @param  w

	 *         Width

	 * @param  h

	 *         Height

	 */

	public BufferParam createBufferParams(int w, int h);

	/**

	 * Creates a parameter object for building a buffer. The buffer type is read-write.

	 * This type could be changed after the creation of a {@link BufferParam} object.

	 * @param  w

	 *         Width

	 * @param  h

	 *         Height

	 * @param  bandCount

	 * 		   Number of bands

	 * @param  dataType

	 *         Type of data        

	 */

	public BufferParam createBufferParams(int w, int h, int bandCount, int dataType);

	/**

	 * Creates a parameter object for building a buffer. For this call the buffer type 

	 * is read-only and the source will be a multifile. 

	 * @param files

	 *        File list in disk

	 * @param x

	 *        initial pixel

	 * @param y

	 *        initial pixel

	 * @param w

	 *        Width in pixels

	 * @param h

	 *        Height in pixels

	 * @param bands

	 *        bands to render

	 * @return {@link BufferParam}

	 * @throws IOException 

	 */

	public BufferParam createBufferParams(String[] files, int x, int y, int w, int h, int[] bands) throws IOException;

	/**

	 * Creates a parameter object for building a buffer. For this call the buffer type 

	 * is read-only. 

	 * @param file

	 *        File in disk

	 * @param x

	 *        initial pixel

	 * @param y

	 *        initial pixel

	 * @param w

	 *        Width in pixels

	 * @param h

	 *        Height in pixels

	 * @param bands

	 *        bands to render

	 * @return {@link BufferParam}

	 * @throws IOException 

	 */

	public BufferParam createBufferParams(String file, int x, int y, int w, int h, int[] bands) throws IOException;

	/**

	 * Creates a parameter object for building a buffer. For this call the buffer type 

	 * is read-only. 

	 * @param file

	 *        File in disk

	 * @param x

	 *        initial pixel

	 * @param y

	 *        initial pixel

	 * @param w

	 *        Width in pixels

	 * @param h

	 *        Height in pixels

	 * @param bands

	 *        bands to render

	 * @return {@link BufferParam}

	 * @throws IOException 

	 */

	public BufferParam createBufferParams(String file, int x, int y, int w, int h) throws IOException;

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

	//NODATA API

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

	/**

	 * Builds a new NoData object

	 * @param noData

	 *        value to assign to all bands

	 * @param nativeNoData

	 *        The native is the original value

	 *        saved in the head of the file or its metadata.

	 * @param fileName

	 *        Name of file owner of this nodata value. This string is useful to

	 *        save the rmf file

	 * @param bandCount

	 *        Number of bands of the file

	 * @return NoData

	 */

	public BufferNoData createNoData(Number noData, Number nativeNoData, String fileName, int bandCount);

	/**

	 * Builds a new NoData for DEMs

	 * @param noData

	 *        value to assign to all bands

	 * @param nativeNoData

	 *        The native is the original value

	 *        saved in the head of the file or its metadata.

	 * @param fileName

	 *        Name of file owner of this nodata value. This string is useful to

	 *        save the rmf file

	 * @return NoData

	 */

	public BufferNoData createNoData(Number noData, Number nativeNoData, String fileName);

	/**

	 * Builds a new NoData for DEMs

	 * @param dataType

	 *        dataType of this NoData

	 * @param bandCount

	 *        Number of bands

	 * @return NoData

	 */

	public BufferNoData createDefaultNoData(int bandCount, int dataType);

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

	//HISTOGRAM API

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

	/**

	 * Creates a empty histogram

	 * @param nBands

	 * @param min

	 * @param max

	 * @param dataType

	 * @param numberOfClasses

	 * @return

	 */

	public BufferHistogram createHistogram(int nBands, double[] min, double[] max, int dataType, int numberOfClasses);

	/**

	 * Creates a empty histogram

	 * @param nBands

	 * @param min

	 * @param max

	 * @param dataType

	 * @param numberOfClasses

	 * @return

	 */

	public BufferHistogram createHistogram(int nBands, int nClasses, double[] min, double[] max);

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

	//TASK API

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

	/**

	 * Gets a register task. To get a task it will use the current thread ID

	 * @return TaskEventManager

	 */

	public TaskEventManager getTask();

	/**

	 * Registers the object as a task using the current thread ID. It returns

	 * a TaskEventManager

	 * @param process

	 * @return

	 */

	public TaskEventManager createTask(Object process);

}

package org.gvsig.raster.cache.buffer;

import java.util.ArrayList;

import org.gvsig.raster.cache.buffer.exception.ProcessInterruptedException;

/**

 * This class is used to calculate basic statistics in a buffer.

 * 

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

 */

public interface BufferStats {

	/**

	 * Calculate statistics

	 */

	public void calculate();

    public double[] getLimits() throws ProcessInterruptedException;

    public double[][] getAllBandsLimits() throws ProcessInterruptedException;

    /**

     * Gets the band list. Each band contains the statistics using

     * {@link StatsValues}

     * @return

     */

    public ArrayList<Band> getBandList();

}

package org.gvsig.raster.cache.buffer;

import java.awt.geom.Rectangle2D;

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

/**

 * Buffer parameters. This class contains generic parameters. 

 * Basic information to fill: x, y, w, h, datatype and bandcount. If

 * the buffer is RasterReadOnlyBuffer is necessary a IBufferDataSource too.

 * 02/11/2008

 * @author Nacho Brodin nachobrodin@gmail.com

 */

public interface BufferParam {

	/**

	 * Get a interest area

	 * @return Rectangle2D

	 */

	public Rectangle2D getAreaOfInterest();

	/**

	 * Set a interest area

	 * @param selection

	 */

	public void setAreaOfInterest(Rectangle2D selection);

	/**

	 * Get the file reference

	 * @return

	 */

	public String getReference();

	/**

	 * Set the file reference

	 * @param ref

	 */

	public void setReference(String ref);

	/**

	 * Set the data source

	 * @param dataSource

	 */

	public void setDataSource(BufferDataSource dataSource);

	/**

	 * Get the data source

	 * @return

	 */

	public BufferDataSource getDataSource();

	/**

	 * Returns the width in pixels

	 * @return Width in pixels of this raster

	 */

	public int getWidth();

	/**

	 * Sets the width in pixels

	 * @param  width

	 *         Width in pixels of this raster

	 */

	public void setWidth(int width);

	/**

	 * Returns the height in pixels

	 * @return Height in pixels of this raster

	 */

	public int getHeight();

	/**

	 * Sets the height in pixels

	 * @param  height

	 *         Height in pixels of this raster 

	 */

	public void setHeight(int height);

	/**

	 * Returns the X upper left coordinate

	 * @return X upper left coordinate in pixels

	 */

	public int getX();

	/**

	 * Sets the X upper left coordinate

	 * @params  x

	 *          X upper left coordinate in pixels

	 */

	public void setX(int x);

	/**

	 * Returns the Y upper left coordinate

	 * @return Y upper left coordinate in pixels

	 */

	public int getY();

	/**

	 * Sets the Y upper left coordinate

	 * @params  y

	 *          Y upper left coordinate in pixels

	 */

	public void setY(int y);

	/**

	 * Gets the data type

	 * @return

	 */

	public int getDataType();

	/**

	 * Sets the data type

	 * @param dataType

	 */

	public void setDataType(int dataType);

	/**

	 * Gets number of bands

	 * @return

	 */

	public int getBandCount();

	/**

	 * Sets number of bands

	 * @param bandCount

	 */

	public void setBandCount(int bandCount);

	/**

	 * Adds one to the band counter

	 */

	public void bandPlusPlus();

	/**

	 * Substracts one to the band counter

	 */

	public void bandLessLess();

	 /**

     * Gets no data value

     * @return double

     */

 	public double getNoDataValue();

 	/**

 	 * Sets no data value

 	 * @return double

 	 */

 	public void setNoDataValue(double noDataValue);

	/**

	 * Gets the size of the data type in bytes

	 * @return Size of the data type that is used

	 */

	public int getDataSize();

    /**

	 * Gets the buffer size

	 * @return buffer size

	 */

	public long sizeof();

	/**

	 * Sets the type of access defined as constant in Buffer interface

	 */

	public void setAccessType(int accessType);

	/**

	 * Gets the type of access defined as constant in Buffer interface

	 */

	public int getAccessType();

	/**

	 * Sets the band list

	 * @param file

	 */

	public void setBandList(int[] bands);

	/**

	 * Gets the band list

	 * @return

	 */

	public int[] getBandList();

}

package org.gvsig.raster.cache.buffer;

/**

 * Base class for raster elements. This class contains methos for

 * reading width, height, number of bands and other raster parameters 

 * 

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

 */

public abstract class RasterBase {

	private static final long    serialVersionUID = 1L;

	private int                  dataType         = Buffer.TYPE_UNDEFINED;

	private int                  bandCount        = 0;

	private int                  width            = 0;

	private int                  height           = 0;

	private int                  x                = 0;

	private int                  y                = 0;

	public double 			     noDataValue      = -99999.0;

	/**

	 * Sets size and position values

	 * @param  x

	 *         Upper left X position 

	 * @param  y

	 *         Upper left X position

	 * @param  w

	 *         Width

	 * @param  h

	 *         Height

	 */

	public RasterBase(int x, int y, int w, int h) {

		this.x = x;

		this.y = y;

		this.width = w;

		this.height = h;

	}

	/**

	 * Sets size and position values

	 * @param  x

	 *         Upper left X position 

	 * @param  y

	 *         Upper left X position

	 * @param  w

	 *         Width

	 * @param  h

	 *         Height

	 * @param  datatype

	 * 	       Data type of this raster

	 * @param  nBands

	 * 	       Number of bands of this raster

	 */

	public RasterBase(int x, int y, int w, int h, int dataType, int nBands) {

		this.x = x;

		this.y = y;

		this.width = w;

		this.height = h;

		this.dataType = dataType;

		this.bandCount = nBands;

	}

	/**

	 * Returns the width in pixels

	 * @return Width in pixels of this raster

	 */

	public int getWidth() {

		return width;

	}

	/**

	 * Sets the width in pixels

	 * @param  width

	 *         Width in pixels of this raster

	 */

	public void setWidth(int width) {

		this.width = width;

	}

	/**

	 * Returns the height in pixels

	 * @return Height in pixels of this raster

	 */

	public int getHeight() {

		return height;

	}

	/**

	 * Sets the height in pixels

	 * @param  height

	 *         Height in pixels of this raster 

	 */

	public void setHeight(int height) {

		this.height = height;

	}

	/**

	 * Returns the X upper left coordinate

	 * @return X upper left coordinate in pixels

	 */

	public int getX() {

		return x;

	}

	/**

	 * Sets the X upper left coordinate

	 * @params  x

	 *          X upper left coordinate in pixels

	 */

	public void setX(int x) {

		this.x = x;

	}

	/**

	 * Returns the Y upper left coordinate

	 * @return Y upper left coordinate in pixels

	 */

	public int getY() {

		return y;

	}

	/**

	 * Sets the Y upper left coordinate

	 * @params  y

	 *          Y upper left coordinate in pixels

	 */

	public void setY(int y) {

		this.y = y;

	}

	/**

	 * Gets the data type

	 * @return

	 */

	public int getDataType() {

		return dataType;

	}

	/**

	 * Sets the data type

	 * @param dataType

	 */

	public void setDataType(int dataType) {

		this.dataType = dataType;

	}

	/**

	 * Gets number of bands

	 * @return

	 */

	public int getBandCount() {

		return bandCount;

	}

	/**

	 * Sets number of bands

	 * @param bandCount

	 */

	public void setBandCount(int bandCount) {

		this.bandCount = bandCount;

	}

	/**

	 * Adds one to the band counter

	 */

	public void bandPlusPlus() {

		this.bandCount ++;

	}

	/**

	 * Substracts one to the band counter

	 */

	public void bandLessLess() {

		this.bandCount --;

	}

	 /**

     * Gets no data value

     * @return double

     */

 	public double getNoDataValue() {

 		return noDataValue;

 	}

 	/**

 	 * Sets no data value

 	 * @return double

 	 */

 	public void setNoDataValue(double noDataValue) {

 		this.noDataValue = noDataValue;

 	}

	/**

	 * Gets the size of the data type in bytes

	 * @return Size of the data type that is used

	 */

	public int getDataSize() {

		if (getDataType() == Buffer.TYPE_BYTE) {

			return 1;

		} else if ((getDataType() == Buffer.TYPE_SHORT) | (getDataType() == Buffer.TYPE_USHORT)) {

			return 2;

		} else if (getDataType() == Buffer.TYPE_INT) {

			return 4;

		}else if (getDataType() == Buffer.TYPE_FLOAT) {

			return 8;

		}else if (getDataType() == Buffer.TYPE_DOUBLE) {

			return 16;

		}

		return 0;

	}

    /**

	 * Gets the buffer size

	 * @return buffer size

	 */

	public long sizeof() {

		return (long)(getDataSize() * getWidth() * getHeight() * getBandCount());

	}

}

/* 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.cache.buffer;

/**

 * This class represents the nodata value.

 * 

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

 */

public interface BufferNoData {

	public static byte           defaultByteNoDataValue     = -128;

	public static short          defaultShortNoDataValue    = -32768;

	public static int            defaultIntegerNoDataValue  = -99999;

	public static float          defaultFloatNoDataValue    = -99999F;

	public static double         defaultDoubleNoDataValue   = -99999D;

	/**

	 * Gets a unique value for nodata. It doesn't take into account if the raster has

	 * several bands. Returns the same value for all of them.

	 * @return the noData

	 */

	public Number getValue();

	/**

	 * Sets a unique value for nodata. It doesn't take into account if the raster has

	 * several bands. Assigns the same value for all of them.

	 * @param noData the noData to set

	 */

	public void setValue(Number noData);

	/**

	 * Returns true if getValue is defined and false if is null

	 * @return

	 */

	public boolean isDefined();

	/**

	 * Deletes the nodata value.

	 */

	public void delete();

	/**

	 * Restores native value. The native is the original value

	 * saved in the head of the file or its metadata. This value

	 * has to be assign when NoData object is initialize. 

	 */

	public void restore();

	/**

	 * The native is the original value

	 * saved in the head of the file or its metadata. This value

	 * has to be assign when NoData object is initialize

	 * @return the noData

	 */

	public Number getNativeValue();

	/**

	 * The native is the original value

	 * saved in the head of the file or its metadata. This value

	 * has to be assign when NoData object is initialize.

	 * @param nativeNoDataValue

	 */

	public void setNativeValue(Number nativeNoDataValue);

	/**

	 * Sets the file name

	 * @param bandCount

	 */

	public void setFileName(String fileName);

	/**

	 * Gets the file name

	 * @return

	 */

	public String getFileName();

	/**

	 * Flag to renderize nodata values as transparent

	 * @return

	 */

	public boolean isNoDataTransparent();

	/**

	 * Flag to renderize nodata values as transparent

	 * @param noDataAsTransparent

	 */

	public void setNoDataTransparent(boolean noDataAsTransparent);

	/**

	 * Gets the NoData data type

	 * @return

	 */

	public int getDataType();

	/**

	 * Sets the datatype

	 */

	public void setDataType(int datatype);

	/**

	 * Compares two NoData objects an returns true if contains the same values

	 * @param noData

	 * @return

	 */

	public boolean compare(BufferNoData noData);

	/**

     * Creates and returns a copy of this object.

	 * @return

	 */

	public Object clone();

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

	//Only for file with more than one band

	/**

	 * Gets the nodata value by band

	 * @param nBand

	 * @return

	 */

	public Number getValueByBand(int nBand);

	/**

	 * Gets the number of bands

	 * @return

	 */

	public int getBandCount();

	/**

	 * Sets the number of bands

	 * @param bandCount

	 */

	public void setBandCount(int bandCount);

	/**

	 * Assigns one value in a band

	 * @param noDataValue

	 */

	public void setValueByBand(Number noDataValue, int nBand);

}

package org.gvsig.raster.cache.buffer;

import org.gvsig.raster.cache.buffer.exception.OperationNotSupportedException;

/**

 * Interface implemented by a raster band 

 * 

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

 *

 */

public interface Band extends StatsValues {

    public final static int TYPE_UNDEFINED = Buffer.TYPE_UNDEFINED;

    public final static int TYPE_BYTE = Buffer.TYPE_BYTE;

    public final static int TYPE_SHORT = Buffer.TYPE_SHORT;

    public final static int TYPE_USHORT = Buffer.TYPE_USHORT;

    public final static int TYPE_INT = Buffer.TYPE_INT;

    public final static int TYPE_FLOAT = Buffer.TYPE_FLOAT;

    public final static int TYPE_DOUBLE = Buffer.TYPE_DOUBLE;

    public final static int TYPE_IMAGE = -1;

    /**

     * Ancho de la banda

     * @return Entero con el ancho de la banda

     */

    public int getWidth();

    /**

     * Alto de la banda

     * @return Entero con el alto de la banda

     */

    public int getHeight();

    /**

     * Obtiene el tipo de dato. Los tipos de dato posibles est?n definidos en IRaster.

     * @return tipo de datos

     */

	public int getDataType();

	/**

	 * Gets the height of each minimum data block. For instance, when you're using 

	 * a cache the BlockSize is the height of one piece of cache. If it is a vertical

	 * cache the BlockSize is the width of each block.

	 * @return size of minimum data block

	 */

	public int getBlockSize();

	/**

	 * Gets the number of blocks

	 * @return integer that represents the number of blocks

	 */

	public int getNumberOfBlocks();

	/**

	 * Returns true if the block is horizontal and false if is not

	 * @return integer that represents the number of blocks

	 */

	public boolean isHorizontalBlock();

	/**

	 * Assigns a new band number

	 * @param  band New band number

	 */

	public void setBandNumber(int band);

	/**

	 * Gets the band number

	 * @return band number

	 */

	public int getBandNumber();

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

    //Getting a block of data

	/**

	 * Gets a minimum block of data. The height of this data block is getBlockHeight

	 * pixels. 

	 * @return Data buffer in memory. This is an array of two dimensions (width x heigth).

	 */

	public byte[][] getByteBlock(int block);

	/**

	 * Gets a minimum block of data. The height of this data block is getBlockHeight

	 * pixels. 

	 * @return Data buffer in memory. This is an array of two dimensions (width x heigth).

	 */

	public short[][] getShortBlock(int block);

	/**

	 * Gets a minimum block of data. The height of this data block is getBlockHeight

	 * pixels. 

	 * @return Data buffer in memory. This is an array of two dimensions (width x heigth).

	 */

	public int[][] getIntBlock(int block);

	/**

	 * Gets a minimum block of data. The height of this data block is getBlockHeight

	 * pixels. 

	 * @return Data buffer in memory. This is an array of two dimensions (width x heigth).

	 */

	public float[][] getFloatBlock(int block);

	/**

	 * Gets a minimum block of data. The height of this data block is getBlockHeight

	 * pixels. 

	 * @return Data buffer in memory. This is an array of two dimensions (width x heigth).

	 */

	public double[][] getDoubleBlock(int block);

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

    //Obtiene una linea de datos

    /**

     * Obtiene una l?nea de datos de esta banda para buffers con tipo

	 * de dato byte.

     * @param  line 

     *         N?mero de l?nea del buffer a recuperar

     * @return Array unidimensional que representa la l?nea de datos.

     */

    public byte[] getByteLine(int line) throws OperationNotSupportedException;

    /**

     * Obtiene una l?nea de datos de esta banda para buffers con tipo

	 * de dato short.

     * @param  line 

     *         N?mero de l?nea del buffer a recuperar

     * @return Array unidimensional que representa la l?nea de datos.

     */

    public short[] getShortLine(int line) throws OperationNotSupportedException;

    /**

     * Obtiene una l?nea de datos de esta banda para buffers con tipo

	 * de dato int.

     * @param  line 

     *         N?mero de l?nea del buffer a recuperar

     * @return Array unidimensional que representa la l?nea de datos.

     */

    public int[] getIntLine(int line) throws OperationNotSupportedException;

    /**

     * Obtiene una l?nea de datos de esta banda para buffers con tipo

	 * de dato float.

     * @param  line 

     *         N?mero de l?nea del buffer a recuperar

     * @return Array unidimensional que representa la l?nea de datos.

     */

    public float[] getFloatLine(int line) throws OperationNotSupportedException;

    /**

     * Obtiene una l?nea de datos de esta banda para buffers con tipo

	 * de dato double.

     * @param  line 

     *         N?mero de l?nea del buffer a recuperar

     * @return Array unidimensional que representa la l?nea de datos.

     */

    public double[] getDoubleLine(int line) throws OperationNotSupportedException;

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

    //Obtiene un elemento de la matriz

    /**

     * Gets one element from the array if this is byte datatype

     * @param  line 

     *         Y position

     * @param  col 

     *         X position

     * @param  band Number of band to read

     * @return Readed element

     */

    public byte getElemByte(int line, int col);

    /**

    * Gets one element from the array if this is short datatype

    * @param  line 

    *         Y position

    * @param  col 

    *         X position

    * @param  band Number of band to read

    * @return Readed element

    */

    public short getElemShort(int line, int col);

    /**

     * Gets one element from the array if this is int datatype

     * @param  line 

     *         Y position

     * @param  col 

     *         X position

     * @param  band 

     *         Number of band to read

     * @return Readed element

     */

    public int getElemInt(int line, int col);

    /**

     * Gets one element from the array if this is float datatype

     * @param  line 

     *         Y position

     * @param  col 

     *         X position

     * @param  band 

     *         Number of band to read

     * @return Readed element

     */

    public float getElemFloat(int line, int col);

    /**

     * Gets one element from the array if this is double datatype

     * @param  line 

     *         Y position

     * @param  col 

     *         X position

     * @param  band 

     *         Number of band to read

     * @return Readed element

     */

    public double getElemDouble(int line, int col);

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

    //Asigna una linea de datos a una banda

    /**

     * Sets one line of byte data

     * @param  data 

     *         line of data

     * @param  line 

     *         Number of line to set

     * @throws OperationNotSupportedException 

     */

    public void setByteLine(byte[] data, int line) throws OperationNotSupportedException;

    /**

     * Sets one line of short data

     * @param  data 

     *         line of data

     * @param  line 

     *         Number of line to set

     * @throws OperationNotSupportedException 

     */

    public void setShortLine(short[] data, int line) throws OperationNotSupportedException;

    /**

     * Sets one line of int data

     * @param  data 

     *         line of data

     * @param  line 

     *         Number of line to set

     * @throws OperationNotSupportedException 

     */

    public void setIntLine(int[] data, int line) throws OperationNotSupportedException;

    /**

     * Sets one line of float data

     * @param  data 

     *         line of data

     * @param  line 

     *         Number of line to set

     * @throws OperationNotSupportedException 

     */

    public void setFloatLine(float[] data, int line) throws OperationNotSupportedException;

    /**

     * Sets one line of double data

     * @param  data 

     *         line of data

     * @param  line 

     *         Number of line to set

     * @throws OperationNotSupportedException 

     */

    public void setDoubleLine(double[] data, int line) throws OperationNotSupportedException;

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

    //Asigna un elemento de la matriz

    /**

     * Sets one byte element

     * @param  line 

     *         Y position

     * @param  col 

     *         X position

     * @param  data 

     *         data value to set

     * @throws OperationNotSupportedException 

     */

    public void setElem(int line, int col, byte data) throws OperationNotSupportedException;

    /**

     * Sets one short element

     * @param  line 

     *         Y position

     * @param  col 

     *         X position

     * @param  data 

     *         data value to set

     * @throws OperationNotSupportedException 

     */

    public void setElem(int line, int col, short data) throws OperationNotSupportedException;

    /**

     * Sets one int element

     * @param  line 

     *         Y position

     * @param  col 

     *         X position

     * @param  data 

     *         data value to set

     * @throws OperationNotSupportedException 

     */

    public void setElem(int line, int col, int data) throws OperationNotSupportedException;

    /**

     * Sets one float element

     * @param  line 

     *         Y position

     * @param  col 

     *         X position

     * @param  data 

     *         data value to set

     * @throws OperationNotSupportedException 

     */

    public void setElem(int line, int col, float data) throws OperationNotSupportedException;

    /**

     * Sets one double element

     * @param  line 

     *         Y position

     * @param  col 

     *         X position

     * @param  data 

     *         data value to set

     * @throws OperationNotSupportedException 

     */

    public void setElem(int line, int col, double data) throws OperationNotSupportedException;

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

    //Inicializa la banda al valor pasado por par?metro

    /**

     * Sets all elements in this band to the parameter value

     * @param  value 

     *         Value to set

     * @throws OperationNotSupportedException 

     */

    public void assign(byte value) throws OperationNotSupportedException;

    /**

     * Sets all elements in this band to the parameter value

     * @param  value 

     *         Value to set

     * @throws OperationNotSupportedException 

     */

    public void assign(short value) throws OperationNotSupportedException;

    /**

     * Sets all elements in this band to the parameter value

     * @param  value 

     *         Value to set

     * @throws OperationNotSupportedException 

     */

    public void assign(int value) throws OperationNotSupportedException;

    /**

     * Sets all elements in this band to the parameter value

     * @param  value 

     *         Value to set

     * @throws OperationNotSupportedException 

     */

    public void assign(float value) throws OperationNotSupportedException;

    /**

     * Sets all elements in this band to the parameter value

     * @param  value 

     *         Value to set

     * @throws OperationNotSupportedException 

     */

    public void assign(double value) throws OperationNotSupportedException;

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

    //Getting a block of data

	/**

	 * Sets a minimum byte block. The height of this data block is getBlockHeight

	 * pixels. 

	 * @param  data 

	 *         Data buffer in memory. This is an array of two dimensions (width x heigth).

	 * @param  block 

	 *         Number of block to assign

	 * @throws OperationNotSupportedException 

	 */

	public void setByteBlock(byte[][] data, int block) throws OperationNotSupportedException;

	/**

	 * Sets a minimum short block. The height of this data block is getBlockHeight

	 * pixels. 

	 * @param  data 

	 *         Data buffer in memory. This is an array of two dimensions (width x heigth).

	 * @param  block 

	 *         Number of block to assign

	 * @throws OperationNotSupportedException 

	 */

	public void setShortBlock(short[][] data, int block) throws OperationNotSupportedException;

	/**

	 * Sets a minimum int block. The height of this data block is getBlockHeight

	 * pixels. 

	 * @param  data 

	 *         Data buffer in memory. This is an array of two dimensions (width x heigth).

	 * @param  block 

	 *         Number of block to assign

	 * @throws OperationNotSupportedException 

	 */

	public void setIntBlock(int[][] data, int block) throws OperationNotSupportedException;

	/**

	 * Sets a minimum float block. The height of this data block is getBlockHeight

	 * pixels. 

	 * @param  data 

	 *         Data buffer in memory. This is an array of two dimensions (width x heigth).

	 * @param  block 

	 *         Number of block to assign

	 * @throws OperationNotSupportedException 

	 */

	public void setFloatBlock(float[][] data, int block) throws OperationNotSupportedException;

	/**

	 * Sets a minimum double block. The height of this data block is getBlockHeight

	 * pixels. 

	 * @param  data 

	 *         Data buffer in memory. This is an array of two dimensions (width x heigth).

	 * @param  block 

	 *         Number of block to assign

	 * @throws OperationNotSupportedException 

	 */

	public void setDoubleBlock(double[][] data, int block) throws OperationNotSupportedException;

}

package org.gvsig.raster.cache.buffer;

public abstract class PxTile extends RasterBase {

	/**

	 * Set size and position values

	 * @param  x

	 *         Upper left X position 

	 * @param  y

	 *         Upper left X position

	 * @param  w

	 *         Width

	 * @param  h

	 *         Height

	 */

	public PxTile(int x, int y, int w, int h) {

		super(x, y, w, h);

	}

	/**

	 * Set size, position values and a file reference

	 * @param  x

	 *         Upper left X position 

	 * @param  y

	 *         Upper left X position

	 * @param  w

	 *         Width

	 * @param  h

	 *         Height

	 * @param  ref

	 *         file reference

	 */

	public PxTile(int x, int y, int w, int h, String ref) {

		super(x, y, w, h);

	}

}

package org.gvsig.raster.cache.buffer;

import java.awt.geom.Rectangle2D;

import java.awt.image.DataBuffer;

import java.io.IOException;

import java.util.ArrayList;

import org.gvsig.raster.cache.buffer.exception.BandNotCompatibleException;

import org.gvsig.raster.cache.buffer.exception.OperationNotSupportedException;

import org.gvsig.raster.cache.buffer.exception.ProcessInterruptedException;

import org.gvsig.raster.cache.buffer.exception.WrongParameterException;

import org.gvsig.raster.cache.buffer.histogram.Histogramable;

/**

 * Interfaz que contiene las operaciones que debe soportar un buffer de datos.

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

 *

 */

public interface Buffer extends Histogramable {

	public static boolean   noDataValueEnable = false;

	public static double    defaultNoDataValue = -99999.0;

    public final static int TYPE_UNDEFINED = DataBuffer.TYPE_UNDEFINED;

    public final static int TYPE_BYTE = DataBuffer.TYPE_BYTE;

    public final static int TYPE_SHORT = DataBuffer.TYPE_SHORT;

    public final static int TYPE_USHORT = DataBuffer.TYPE_USHORT;

    public final static int TYPE_INT = DataBuffer.TYPE_INT;

    public final static int TYPE_FLOAT = DataBuffer.TYPE_FLOAT;

    public final static int TYPE_DOUBLE = DataBuffer.TYPE_DOUBLE;

    //Read type constants

	public static final int      READ_ONLY             = 0;

	public static final int      READ_WRITE            = 1;

	//If the returned buffer is a cache buffer then it will have vertical stripes

	public static final int      READ_WRITE_CVERT      = 2;

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

    //************GETTING INFO**************

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

    /**

     * Ancho del raster

     * @return Entero con el ancho del raster

     */

    public int getWidth();

    /**

     * Alto del raster

     * @return Entero con el alto del raster

     */

    public int getHeight();

    /**

     * N?mero de bandas

     * @return Entero con el n?mero de bandas

     */

    public int getBandCount();

    /**

     * Obtiene el tipo de dato. Los tipos de dato posibles est?n definidos en IRaster.

     * @return tipo de datos

     */

	public int getDataType();

	/**