RasterCache

java.lang.Object
- org.gvsig.fmap.dal.coverage.dataset.AbstractBuffer
- - org.gvsig.raster.impl.buffer.RasterBuffer
  - - org.gvsig.raster.impl.buffer.cache.RasterCache

All Implemented Interfaces:

Buffer, Histogramable, DataSet, Disposable, Visitable
```
public class RasterCache
extends RasterBuffer
```
Esta clase representa un buffer de datos cacheado. El estar en cache significa que solo una parte de los datos estarán en memoria y que gestiona, dependiendo de las peticiones, que partes hay que cargar a memoria y en que momento. Para esto el buffer no se llena de golpe sino que utiliza una clase que sirve los datos desde la fuente. Esta clase servidora de datos debe implementar el interfaz ICacheDatasetSourcepara servir datos de la forma requerida.

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

class RasterCache.CacheBand

Nested Classes
Modifier and Type	Class and Description
`class`	`RasterCache.CacheBand`

Field Summary
- Fields inherited from class org.gvsig.raster.impl.buffer.RasterBuffer
  cacheOn, cancel, canceled, dataType, forceToLoadInCache, forceToLoadInReadOnlyCache, height, INTERPOLATION_PROCESS, nBands, noDataValue, notValidValue, progressInterpolation, width
- Fields inherited from interface org.gvsig.fmap.dal.coverage.dataset.Buffer
  INCREMENTABLE_HISTOGRAM, INCREMENTABLE_INTERPOLATION, INTERPOLATION_BicubicSpline, INTERPOLATION_Bilinear, INTERPOLATION_BSpline, INTERPOLATION_InverseDistance, INTERPOLATION_NearestNeighbour, INTERPOLATION_Undefined, TYPE_BYTE, TYPE_DOUBLE, TYPE_FLOAT, TYPE_IMAGE, TYPE_INT, TYPE_SHORT, TYPE_UNDEFINED, TYPE_USHORT

Constructor Summary

Constructors
Constructor and Description

RasterCache(int dataType, int width, int height, int nBands)
Constructor.

Constructors
Constructor and Description
`RasterCache(int dataType, int width, int height, int nBands)` Constructor.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`assign(int band, byte value)`
`void`	`assign(int band, double value)`
`void`	`assign(int band, float value)`
`void`	`assign(int band, int value)`
`void`	`assign(int band, short value)`
`void`	`assignBand(int nBand, Band band)` Sustituye una banda completa que se asigna por referencia
`void`	`assignBandToNotValid(int Band)` Asigna una banda al valor especificado como no valido.
`void`	`clearCache()` Limpia los trozos de caché en disco.
`Buffer`	`cloneBuffer()` Clona el buffer actual y devuelve el clone
`void`	`copyBand(int nBand, Band band)` Sustituye una banda completa copiando los datos de la que se pasa por parámetro
`Band`	`createBand(byte defaultValue)` Crea un buffer banda inicializado con el valor pasado por parámetro.
`void`	`dispose()` Disposes the current object, to allow it to close and dispose any used resources.
`protected void`	`finalize()`
`Band`	`getBand(int band)` Obtiene una banda completa del raster
`Buffer`	`getBandBuffer(int Band)` Obtiene una banda completa del raster
`int`	`getBlockHeight()` Gets the height of a block of data.
`Cache`	`getCache()` Obtiene la caché
`void`	`getElemByte(int line, int col, byte[] data)`
`byte`	`getElemByte(int line, int col, int band)`
`void`	`getElemDouble(int line, int col, double[] data)`
`double`	`getElemDouble(int line, int col, int band)`
`void`	`getElemFloat(int line, int col, float[] data)`
`float`	`getElemFloat(int line, int col, int band)`
`int`	`getElemInt(int line, int col, int band)`
`void`	`getElemInt(int line, int col, int[] data)`
`short`	`getElemShort(int line, int col, int band)`
`void`	`getElemShort(int line, int col, short[] data)`
`byte[][]`	`getLineByte(int line)` Obtiene una línea de datos con todas las bandas para buffers con tipo de dato byte.
`double[][]`	`getLineDouble(int line)` Obtiene una línea de datos con todas las bandas para buffers con tipo de dato double.
`float[][]`	`getLineFloat(int line)` Obtiene una línea de datos con todas las bandas para buffers con tipo de dato float.
`byte[]`	`getLineFromBandByte(int line, int band)` Obtiene una línea de datos de la banda solicitada para buffers con tipo de dato byte.
`double[]`	`getLineFromBandDouble(int line, int band)` Obtiene una línea de datos de la banda solicitada para buffers con tipo de dato double.
`float[]`	`getLineFromBandFloat(int line, int band)` Obtiene una línea de datos de la banda solicitada para buffers con tipo de dato float.
`int[]`	`getLineFromBandInt(int line, int band)` Obtiene una línea de datos de la banda solicitada para buffers con tipo de dato int.
`short[]`	`getLineFromBandShort(int line, int band)` Obtiene una línea de datos de la banda solicitada para buffers con tipo de dato short.
`int[][]`	`getLineInt(int line)` Obtiene una línea de datos con todas las bandas para buffers con tipo de dato int.
`short[][]`	`getLineShort(int line)` Obtiene una línea de datos con todas las bandas para buffers con tipo de dato short.
`void`	`interchangeBands(int band1, int band2)` Intercambia dos bandas.
`boolean`	`isBandSwitchable()` Informa de si el buffer tiene la capacidad de intercambio de bandas o no la tiene.
`boolean`	`isCached()` Returns true if it is a cached buffer
`boolean`	`isReadOnlyBuffer()` Returns true if the current buffer can't be writed
`void`	`malloc(int dataType, int width, int height, int bandNr)` Reserva de memoria para el rasterbuf
`void`	`mallocOneBand(int dataType, int width, int height, int band)` Reserva de memoria para el rasterbuf solo en la banda solicitada
`void`	`replicateBand(int orig, int dest)` Replica la banda de una posición sobre otra.
`void`	`setCache(Cache cache)` Asigna la cache
`void`	`setElem(int line, int col, int band, byte data)`
`void`	`setElem(int line, int col, int band, double data)`
`void`	`setElem(int line, int col, int band, float data)`
`void`	`setElem(int line, int col, int band, int data)`
`void`	`setElem(int line, int col, int band, short data)`
`void`	`setElemByte(int line, int col, byte[] data)`
`void`	`setElemDouble(int line, int col, double[] data)`
`void`	`setElemFloat(int line, int col, float[] data)`
`void`	`setElemInt(int line, int col, int[] data)`
`void`	`setElemShort(int line, int col, short[] data)`
`void`	`setLineByte(byte[][] data, int line)`
`void`	`setLineDouble(double[][] data, int line)`
`void`	`setLineFloat(float[][] data, int line)`
`void`	`setLineInBandByte(byte[] data, int line, int band)`
`void`	`setLineInBandDouble(double[] data, int line, int band)`
`void`	`setLineInBandFloat(float[] data, int line, int band)`
`void`	`setLineInBandInt(int[] data, int line, int band)`
`void`	`setLineInBandShort(short[] data, int line, int band)`
`void`	`setLineInt(int[][] data, int line)`
`void`	`setLineShort(short[][] data, int line)`
`void`	`switchBands(int[] bandPosition)` Cambia bandas de posición.

Methods inherited from class org.gvsig.raster.impl.buffer.RasterBuffer
accept, addDrawableBands, getAdjustedWindow, getAllBandsLimits, getBandCount, getDataExtent, getDataSize, getDataType, getHeight, getHistogramComputer, getIncrementableTask, getLimits, getNoDataValue, getNotValidValue, getPercent, getStore, getWidth, isFromStore, isInside, resetPercent, setDataExtent, setDataType, setNoDataValue, setNotValidValue, setProcess, setStore, sizeof, typesToString

Methods inherited from class org.gvsig.fmap.dal.coverage.dataset.AbstractBuffer
project

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.gvsig.fmap.dal.coverage.dataset.Buffer
project

- Constructor Detail
  - RasterCache
```
public RasterCache(int dataType,
           int width,
           int height,
           int nBands)
```
    Constructor. Asigna las variables de inicialización y crea la estructura de la caché con los datos pasados.
    
    Parameters:
    dataType - Tipo de dato del buffer
    width - Ancho del buffer
    height - Alto del buffer
    nBands - Número de bandas del buffer
- Method Detail
  - clearCache
```
public void clearCache()
                throws IOException
```
    Limpia los trozos de caché en disco. Después del llamar a este método no puede volver a usarse esta caché.
    
    Throws:
    
    IOException
  - isBandSwitchable
```
public boolean isBandSwitchable()
```
    Description copied from interface: Buffer
    
    Informa de si el buffer tiene la capacidad de intercambio de bandas o no la tiene.
    
    Returns:
    Devuelve true si tiene la capacidad de intercambio de bandas y false si no la tiene.
  - malloc
```
public void malloc(int dataType,
          int width,
          int height,
          int bandNr)
```
    Description copied from class: RasterBuffer
    
    Reserva de memoria para el rasterbuf
    
    Specified by:
    
    malloc in class RasterBuffer
    
    Parameters:
    dataType - Tipo de dato
    width - Ancho
    height - Alto
    bandNr - Numero de bandas
  - getCache
```
public Cache getCache()
```
    Obtiene la caché
    
    Returns:
  - setCache
```
public void setCache(Cache cache)
```
    Asigna la cache
    
    Parameters:
    cache -
  - getLineByte
```
public byte[][] getLineByte(int line)
```
    Description copied from interface: Buffer
    
    Obtiene una línea de datos con todas las bandas para buffers con tipo de dato byte.
    
    Parameters:
    line - Número de línea del buffer a recuperar
    
    Returns:
    Array bidimensional conteniendo la línea de datos donde la primera dimensión representa las bandas y la segunda la posición en la línea
  - getLineShort
```
public short[][] getLineShort(int line)
```
    Description copied from interface: Buffer
    
    Obtiene una línea de datos con todas las bandas para buffers con tipo de dato short.
    
    Parameters:
    line - Número de línea del buffer a recuperar
    
    Returns:
    Array bidimensional conteniendo la línea de datos donde la primera dimensión representa las bandas y la segunda la posición en la línea
  - getLineInt
```
public int[][] getLineInt(int line)
```
    Description copied from interface: Buffer
    
    Obtiene una línea de datos con todas las bandas para buffers con tipo de dato int.
    
    Parameters:
    line - Número de línea del buffer a recuperar
    
    Returns:
    Array bidimensional conteniendo la línea de datos donde la primera dimensión representa las bandas y la segunda la posición en la línea
  - getLineFloat
```
public float[][] getLineFloat(int line)
```
    Description copied from interface: Buffer
    
    Obtiene una línea de datos con todas las bandas para buffers con tipo de dato float.
    
    Parameters:
    line - Número de línea del buffer a recuperar
    
    Returns:
    Array bidimensional conteniendo la línea de datos donde la primera dimensión representa las bandas y la segunda la posición en la línea
  - getLineDouble
```
public double[][] getLineDouble(int line)
```
    Description copied from interface: Buffer
    
    Obtiene una línea de datos con todas las bandas para buffers con tipo de dato double.
    
    Parameters:
    line - Número de línea del buffer a recuperar
    
    Returns:
    Array bidimensional conteniendo la línea de datos donde la primera dimensión representa las bandas y la segunda la posición en la línea
  - setLineByte
```
public void setLineByte(byte[][] data,
               int line)
```
  - setLineShort
```
public void setLineShort(short[][] data,
                int line)
```
  - setLineInt
```
public void setLineInt(int[][] data,
              int line)
```
  - setLineFloat
```
public void setLineFloat(float[][] data,
                int line)
```
  - setLineDouble
```
public void setLineDouble(double[][] data,
                 int line)
```
  - getLineFromBandByte
```
public byte[] getLineFromBandByte(int line,
                         int band)
```
    Description copied from interface: Buffer
    
    Obtiene una línea de datos de la banda solicitada para buffers con tipo de dato byte.
    
    Parameters:
    line - Número de línea del buffer a recuperar
    band - Número de banda a recuperar
    
    Returns:
    Array unidimensional que representa la línea de datos.
  - getLineFromBandShort
```
public short[] getLineFromBandShort(int line,
                           int band)
```
    Description copied from interface: Buffer
    
    Obtiene una línea de datos de la banda solicitada para buffers con tipo de dato short.
    
    Parameters:
    line - Número de línea del buffer a recuperar
    band - Número de banda a recuperar
    
    Returns:
    Array unidimensional que representa la línea de datos.
  - getLineFromBandInt
```
public int[] getLineFromBandInt(int line,
                       int band)
```
    Description copied from interface: Buffer
    
    Obtiene una línea de datos de la banda solicitada para buffers con tipo de dato int.
    
    Parameters:
    line - Número de línea del buffer a recuperar
    band - Número de banda a recuperar
    
    Returns:
    Array unidimensional que representa la línea de datos.
  - getLineFromBandFloat
```
public float[] getLineFromBandFloat(int line,
                           int band)
```
    Description copied from interface: Buffer
    
    Obtiene una línea de datos de la banda solicitada para buffers con tipo de dato float.
    
    Parameters:
    line - Número de línea del buffer a recuperar
    band - Número de banda a recuperar
    
    Returns:
    Array unidimensional que representa la línea de datos.
  - getLineFromBandDouble
```
public double[] getLineFromBandDouble(int line,
                             int band)
```
    Description copied from interface: Buffer
    
    Obtiene una línea de datos de la banda solicitada para buffers con tipo de dato double.
    
    Parameters:
    line - Número de línea del buffer a recuperar
    band - Número de banda a recuperar
    
    Returns:
    Array unidimensional que representa la línea de datos.
  - setLineInBandByte
```
public void setLineInBandByte(byte[] data,
                     int line,
                     int band)
```
  - setLineInBandShort
```
public void setLineInBandShort(short[] data,
                      int line,
                      int band)
```
  - setLineInBandInt
```
public void setLineInBandInt(int[] data,
                    int line,
                    int band)
```
  - setLineInBandFloat
```
public void setLineInBandFloat(float[] data,
                      int line,
                      int band)
```
  - setLineInBandDouble
```
public void setLineInBandDouble(double[] data,
                       int line,
                       int band)
```
  - getElemByte
```
public byte getElemByte(int line,
               int col,
               int band)
```
  - getElemShort
```
public short getElemShort(int line,
                 int col,
                 int band)
```
  - getElemInt
```
public int getElemInt(int line,
             int col,
             int band)
```
  - getElemFloat
```
public float getElemFloat(int line,
                 int col,
                 int band)
```
  - getElemDouble
```
public double getElemDouble(int line,
                   int col,
                   int band)
```
  - setElem
```
public void setElem(int line,
           int col,
           int band,
           byte data)
```
  - setElem
```
public void setElem(int line,
           int col,
           int band,
           short data)
```
  - setElem
```
public void setElem(int line,
           int col,
           int band,
           int data)
```
  - setElem
```
public void setElem(int line,
           int col,
           int band,
           float data)
```
  - setElem
```
public void setElem(int line,
           int col,
           int band,
           double data)
```
  - getElemByte
```
public void getElemByte(int line,
               int col,
               byte[] data)
```
  - getElemShort
```
public void getElemShort(int line,
                int col,
                short[] data)
```
  - getElemInt
```
public void getElemInt(int line,
              int col,
              int[] data)
```
  - getElemFloat
```
public void getElemFloat(int line,
                int col,
                float[] data)
```
  - getElemDouble
```
public void getElemDouble(int line,
                 int col,
                 double[] data)
```
  - setElemByte
```
public void setElemByte(int line,
               int col,
               byte[] data)
```
  - setElemShort
```
public void setElemShort(int line,
                int col,
                short[] data)
```
  - setElemInt
```
public void setElemInt(int line,
              int col,
              int[] data)
```
  - setElemFloat
```
public void setElemFloat(int line,
                int col,
                float[] data)
```
  - setElemDouble
```
public void setElemDouble(int line,
                 int col,
                 double[] data)
```
  - getBandBuffer
```
public Buffer getBandBuffer(int Band)
```
    Description copied from interface: Buffer
    
    Obtiene una banda completa del raster
    
    Parameters:
    Band - Número de banda
  - replicateBand
```
public void replicateBand(int orig,
                 int dest)
```
    Description copied from class: RasterBuffer
    
    Replica la banda de una posición sobre otra. Si la banda de destino no existe se crea nueva. Si la posición de la banda de destino está intercalada entre bandas que ya existen las otras se desplazan hacia abajo, NO se machacan los datos de ninguna. Los datos se replican por referencia por lo que al modificar la banda original las del resto quedarán afectadas.
    
    Specified by:
    
    replicateBand in interface Buffer
    
    Specified by:
    
    replicateBand in class RasterBuffer
  - switchBands
```
public void switchBands(int[] bandPosition)
```
    Description copied from class: RasterBuffer
    
    Cambia bandas de posición. Las posiciones deben existir como bandas del raster. Cada elemento del array representa una banda existente en el buffer (de longitud rasterBuf.length) y el valor contenido dentro la banda que le corresponde. Por ejemplo si pasamos un array {1, 0, 3, 2} significa que el buffer tiene cuatro bandas y que cambiamos la 0 por la 1 y la 2 por la 3. Un array {0, 1, 2, 3} en el mismo caso no produciría nigún cambio. Si quisieramos asignar en un buffer monobanda su banda a la segunda posición habria que insertar una vacia, por ejemplo con addBandFloat(0, null) se insertaria una banda nula en la posición 0 y la banda que estaba en la 0 pasaría a la segunda.
    
    Specified by:
    
    switchBands in interface Buffer
    
    Specified by:
    
    switchBands in class RasterBuffer
    
    Parameters:
    bandPosition - Array con la nueva distribución de bandas
  - assign
```
public void assign(int band,
          byte value)
```
  - assign
```
public void assign(int band,
          short value)
```
  - assign
```
public void assign(int band,
          int value)
```
  - assign
```
public void assign(int band,
          float value)
```
  - assign
```
public void assign(int band,
          double value)
```
  - cloneBuffer
```
public Buffer cloneBuffer()
```
    Description copied from interface: Buffer
    
    Clona el buffer actual y devuelve el clone
    
    Specified by:
    
    cloneBuffer in interface Buffer
    
    Specified by:
    
    cloneBuffer in class RasterBuffer
    
    Returns:
    Buffer clonado
  - interchangeBands
```
public void interchangeBands(int band1,
                    int band2)
```
    Description copied from interface: Buffer
    
    Intercambia dos bandas.
    
    Parameters:
    band1 - Banda 1 a intercambiar
    band2 - Banda 2 a intercambiar
  - mallocOneBand
```
public void mallocOneBand(int dataType,
                 int width,
                 int height,
                 int band)
```
    Description copied from interface: Buffer
    
    Reserva de memoria para el rasterbuf solo en la banda solicitada
    
    Parameters:
    dataType - Tipo de dato
    width - Ancho
    height - Alto
    band - Número de banda
  - getBand
```
public Band getBand(int band)
```
    Description copied from interface: Buffer
    
    Obtiene una banda completa del raster
    
    Parameters:
    band - Número de banda
  - copyBand
```
public void copyBand(int nBand,
            Band band)
```
    Description copied from interface: Buffer
    
    Sustituye una banda completa copiando los datos de la que se pasa por parámetro
    
    Parameters:
    nBand - Número de banda a sustituir
  - assignBand
```
public void assignBand(int nBand,
              Band band)
```
    Description copied from interface: Buffer
    
    Sustituye una banda completa que se asigna por referencia
    
    Parameters:
    nBand - Número de banda a sustituir
  - createBand
```
public Band createBand(byte defaultValue)
```
    Description copied from interface: Buffer
    
    Crea un buffer banda inicializado con el valor pasado por parámetro. Las dimensiones corresponden a las del buffer existente.
    
    Parameters:
    defaultValue - Valor con el que se inicializa la banda creada
  - assignBandToNotValid
```
public void assignBandToNotValid(int Band)
```
    Description copied from interface: Buffer
    
    Asigna una banda al valor especificado como no valido. Esta banda es común para todas las bandas del buffer, es decir se asigna por referencia. No tiene el mismo resultado que asignar una banda a un valor fijo.
    
    Parameters:
    Band - Número de banda
  - isReadOnlyBuffer
```
public boolean isReadOnlyBuffer()
```
    Description copied from interface: Buffer
    
    Returns true if the current buffer can't be writed
    
    Returns:
  - isCached
```
public boolean isCached()
```
    Description copied from interface: Buffer
    
    Returns true if it is a cached buffer
    
    Specified by:
    
    isCached in interface Buffer
    
    Overrides:
    
    isCached in class RasterBuffer
    
    Returns:
  - getBlockHeight
```
public int getBlockHeight()
```
    Description copied from interface: Buffer
    
    Gets the height of a block of data.
    
    Specified by:
    
    getBlockHeight in interface Buffer
    
    Overrides:
    
    getBlockHeight in class RasterBuffer
    
    Returns:
  - dispose
```
public void dispose()
```
    Description copied from interface: Disposable
    
    Disposes the current object, to allow it to close and dispose any used resources.
    NOTE:After calling this method, the object may not be usable anymore.
  - finalize
```
protected void finalize()
                 throws Throwable
```
    Overrides:
    
    finalize in class RasterBuffer
    
    Throws:
    
    Throwable

Class RasterCache

Nested Class Summary

Field Summary

Fields inherited from class org.gvsig.raster.impl.buffer.RasterBuffer

Fields inherited from interface org.gvsig.fmap.dal.coverage.dataset.Buffer

Constructor Summary

Method Summary

Methods inherited from class org.gvsig.raster.impl.buffer.RasterBuffer

Methods inherited from class org.gvsig.fmap.dal.coverage.dataset.AbstractBuffer

Methods inherited from class java.lang.Object

Methods inherited from interface org.gvsig.fmap.dal.coverage.dataset.Buffer

Constructor Detail

RasterCache

Method Detail

clearCache

isBandSwitchable

malloc

getCache

setCache

getLineByte

getLineShort

getLineInt

getLineFloat

getLineDouble

setLineByte

setLineShort

setLineInt

setLineFloat

setLineDouble

getLineFromBandByte

getLineFromBandShort

getLineFromBandInt

getLineFromBandFloat

getLineFromBandDouble

setLineInBandByte

setLineInBandShort

setLineInBandInt

setLineInBandFloat

setLineInBandDouble

getElemByte

getElemShort

getElemInt

getElemFloat

getElemDouble

setElem

setElem

setElem

setElem

setElem

getElemByte

getElemShort

getElemInt

getElemFloat

getElemDouble

setElemByte

setElemShort

setElemInt

setElemFloat

setElemDouble

getBandBuffer

replicateBand

switchBands

assign

assign

assign

assign

assign

cloneBuffer

interchangeBands

mallocOneBand

getBand

copyBand

assignBand

createBand

assignBandToNotValid

isReadOnlyBuffer

isCached

getBlockHeight

dispose

finalize