org.gvsig.raster.impl.buffer

Class RasterBuffer

java.lang.Object

org.gvsig.fmap.dal.coverage.dataset.AbstractBuffer

org.gvsig.raster.impl.buffer.RasterBuffer

All Implemented Interfaces:

Buffer, Histogramable, DataSet, Disposable, Visitable

Direct Known Subclasses:

RasterCache, RasterMemoryBuffer, RasterReadOnlyBuffer

public abstract class RasterBuffer
extends AbstractBuffer
implements Buffer

Rectangulo de pixeles. Para cada tipo de datos java hay un buffer distinto donde cada elemento es accedido de la siguiente forma: [banda][fila][columna] m[1][2][0] = cte;-> Sustituye el elemento de la fila 2 de la banda 1 columna 0 m[1][0] = array; -> Sustituye la fila 0 de la banda 1 m[0] = matriz cuadrada; -> Sustituye la banda entera.

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	cacheOn Variable estática que si está a false desactiva el uso de caché.
protected boolean[]	cancel
protected boolean	canceled
protected int	dataType
static boolean	forceToLoadInCache Fuerza la carga de los datos en caché independientemente de su tamaño.
static boolean	forceToLoadInReadOnlyCache Fuerza la carga de los datos en caché de solo lectura independientemente de su tamaño.
protected int	height
static int	INTERPOLATION_PROCESS
protected int	nBands
NoData	noDataValue
protected double	notValidValue Valor con el que se rellena una banda no valida del buffer.
protected int	progressInterpolation
protected int	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
RasterBuffer()

Method Summary

Methods

Modifier and Type	Method and Description
void	accept(Visitor visitor) Provides each value of this Store to the provided Visitor.
void	addDrawableBands(int[] db) Assigns the band list but only for a read only buffer
abstract Buffer	cloneBuffer() Clona el buffer actual y devuelve el clone
protected void	finalize()
Buffer	getAdjustedWindow(int w, int h, int interpolationMethod) Ajusta el área del grid a un ancho y un alto dado en pixeles.
double[][]	getAllBandsLimits()
int	getBandCount() Número de bandas
int	getBlockHeight() Gets the height of a block of data.
Rectangle2D	getDataExtent() Gets a bouding box of this buffer
int	getDataSize() Obtiene el tamaño del tipo de dato en bytes
int	getDataType() Obtiene el tipo de dato.
int	getHeight() Alto del raster
HistogramComputer	getHistogramComputer() Gets the object which computes the histogram
IncrementableTask	getIncrementableTask(int type) This call returns an incrementable task that is needed to load the buffer.
double[]	getLimits() Calcula el mínimo y el máximo del histograma previamente.
NoData	getNoDataValue() Gets the NoData value of this buffer
double	getNotValidValue() Obtiene el valor de no valido.
int	getPercent()
RasterDataStore	getStore() Gets the RasterDataStore reference
int	getWidth() Ancho del raster
boolean	isCached() Returns true if it is a cached buffer
boolean	isFromStore(DataStore store) Indicates whether this DataSet belongs to a specific store
boolean	isInside(int x, int y) Obtiene true si el pixel pasado por parámetro cae dentro de los límites del rater y false si cae fuera.
abstract void	malloc(int dataType, int width, int height, int bandNr) Reserva de memoria para el rasterbuf
abstract void	replicateBand(int orig, int dest) Replica la banda de una posición sobre otra.
void	resetPercent()
void	setDataExtent(Rectangle2D r) Sets a bounding box of this buffer
void	setDataType(int dataType) Asigna el tipo de dato.
void	setNoDataValue(NoData nd) Sets the NoData value
void	setNotValidValue(double value) Asigna el valor de no valido.
void	setProcess(int process) Asigna el proceso del cual se desea obtener información.
void	setStore(RasterDataStore store) Sets the RasterDataStore reference
long	sizeof() Obtiene el tamaño del buffer
abstract void	switchBands(int[] bandPosition) Cambia bandas de posición.
static String	typesToString(int type) Convierte un tipo de dato a cadena

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

assign, assign, assign, assign, assign, assignBand, assignBandToNotValid, copyBand, createBand, getBand, getBandBuffer, getElemByte, getElemByte, getElemDouble, getElemDouble, getElemFloat, getElemFloat, getElemInt, getElemInt, getElemShort, getElemShort, getLineByte, getLineDouble, getLineFloat, getLineFromBandByte, getLineFromBandDouble, getLineFromBandFloat, getLineFromBandInt, getLineFromBandShort, getLineInt, getLineShort, interchangeBands, isBandSwitchable, isReadOnlyBuffer, mallocOneBand, project, setElem, setElem, setElem, setElem, setElem, setElemByte, setElemDouble, setElemFloat, setElemInt, setElemShort, setLineByte, setLineDouble, setLineFloat, setLineInBandByte, setLineInBandDouble, setLineInBandFloat, setLineInBandInt, setLineInBandShort, setLineInt, setLineShort

Methods inherited from interface org.gvsig.tools.dispose.Disposable

dispose

Field Detail

INTERPOLATION_PROCESS

public static final int INTERPOLATION_PROCESS

See Also:

Constant Field Values

cancel

protected boolean[] cancel

noDataValue

public NoData noDataValue

progressInterpolation

protected int progressInterpolation

canceled

protected boolean canceled

width

protected int width

height

protected int height

nBands

protected int nBands

dataType

protected int dataType

cacheOn

public static boolean cacheOn

Variable estática que si está a false desactiva el uso de caché. Puede ser usada por un cliente para cargar siempre los datos en memoria. independientemente de su tamaño.

forceToLoadInCache

public static boolean forceToLoadInCache

Fuerza la carga de los datos en caché independientemente de su tamaño. Su uso suele ser util solo para depuración. Su valor por defecto y recomendado es siempre false.

forceToLoadInReadOnlyCache

public static boolean forceToLoadInReadOnlyCache

Fuerza la carga de los datos en caché de solo lectura independientemente de su tamaño. Su uso suele ser util solo para depuración. Su valor por defecto y recomendado es siempre false.

notValidValue

protected double notValidValue

Valor con el que se rellena una banda no valida del buffer. Una banda no valida es la que no tiene datos asignados y tampoco puede ser null. Todas las bandas no validas de un buffer apuntan por referencia a la misma banda.

Constructor Detail

RasterBuffer

public RasterBuffer()

Method Detail

getStore

public RasterDataStore getStore()

Description copied from interface: Buffer

Gets the RasterDataStore reference

Specified by:

getStore in interface Buffer

Returns:

setStore

public void setStore(RasterDataStore store)

Description copied from interface: Buffer

Sets the RasterDataStore reference

Specified by:

setStore in interface Buffer

malloc

public abstract void malloc(int dataType,
          int width,
          int height,
          int bandNr)

Reserva de memoria para el rasterbuf

Parameters:

dataType - Tipo de dato

width - Ancho

height - Alto

bandNr - Numero de bandas

orig -

getWidth

public int getWidth()

Description copied from interface: Buffer

Ancho del raster

Specified by:

getWidth in interface Buffer

Returns:

Entero con el ancho del raster

getDataExtent

public Rectangle2D getDataExtent()

Gets a bouding box of this buffer

Specified by:

getDataExtent in interface Buffer

Returns:

setDataExtent

public void setDataExtent(Rectangle2D r)

Sets a bounding box of this buffer

Specified by:

setDataExtent in interface Buffer

Parameters:

r -

getHeight

public int getHeight()

Description copied from interface: Buffer

Alto del raster

Specified by:

getHeight in interface Buffer

Returns:

Entero con el alto del raster

getBandCount

public int getBandCount()

Description copied from interface: Buffer

Número de bandas

Specified by:

getBandCount in interface Buffer

Returns:

Entero con el número de bandas

getDataType

public int getDataType()

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

Specified by:

getDataType in interface Buffer

Returns:

tipo de datos

setDataType

public void setDataType(int dataType)

Asigna el tipo de dato. Los tipos de dato posibles están definidos en IRaster.

Specified by:

setDataType in interface Buffer

Parameters:

dataType - Tipo de dato del buffer

getDataSize

public int getDataSize()

Obtiene el tamaño del tipo de dato en bytes

Returns:

Tipo de dato

sizeof

public long sizeof()

Obtiene el tamaño del buffer

Returns:

tamaño del buffer

replicateBand

public abstract void replicateBand(int orig,
                 int dest)

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

Parameters:

orig. - Posición de la banda de origen.

dest. - Posición de la banda destino

switchBands

public abstract void switchBands(int[] bandPosition)

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

Parameters:

bandPosition - Array con la nueva distribución de bandas

typesToString

public static String typesToString(int type)

Convierte un tipo de dato a cadena

Parameters:

type - Tipo de dato

Returns:

cadena que representa el tipo de dato

isInside

public boolean isInside(int x,
               int y)

Description copied from interface: Buffer

Obtiene true si el pixel pasado por parámetro cae dentro de los límites del rater y false si cae fuera.

Specified by:

isInside in interface Buffer

Parameters:

x - Posición X del pixel a averiguar

y - Posición Y del pixel a averiguar

Returns:

true si está dentro y false si cae fuera.

getNoDataValue

public NoData getNoDataValue()

Description copied from interface: Buffer

Gets the NoData value of this buffer

Specified by:

getNoDataValue in interface Buffer

Returns:

getBlockHeight

public int getBlockHeight()

Description copied from interface: Buffer

Gets the height of a block of data.

Specified by:

getBlockHeight in interface Buffer

Returns:

setNoDataValue

public void setNoDataValue(NoData nd)

Description copied from interface: Buffer

Sets the NoData value

Specified by:

setNoDataValue in interface Buffer

getNotValidValue

public double getNotValidValue()

Description copied from interface: Buffer

Obtiene el valor de no valido.

Specified by:

getNotValidValue in interface Buffer

Returns:

value

setNotValidValue

public void setNotValidValue(double value)

Description copied from interface: Buffer

Asigna el valor de no valido.

Specified by:

setNotValidValue in interface Buffer

cloneBuffer

public abstract Buffer cloneBuffer()

Description copied from interface: Buffer

Clona el buffer actual y devuelve el clone

Specified by:

cloneBuffer in interface Buffer

Returns:

Buffer clonado

getAdjustedWindow

public Buffer getAdjustedWindow(int w,
                       int h,
                       int interpolationMethod)
                         throws ProcessInterruptedException

Ajusta el área del grid a un ancho y un alto dado en pixeles. Este ajuste se hará en relación a un método de interpolación definido en el parámetro.

Specified by:

getAdjustedWindow in interface Buffer

Parameters:

w - Ancho de la nueva imagen.

h - Alto de la nueva imagen.

interpolation - Método de interpolación que se usará en el ajuste.

Throws:

ProcessInterruptedException

getIncrementableTask

public IncrementableTask getIncrementableTask(int type)

Description copied from interface: Buffer

This call returns an incrementable task that is needed to load the buffer. Usually this is a BufferInterpolation class.

Specified by:

getIncrementableTask in interface Buffer

Returns:

getHistogramComputer

public HistogramComputer getHistogramComputer()

Description copied from interface: Histogramable

Gets the object which computes the histogram

Specified by:

getHistogramComputer in interface Histogramable

Returns:

Histograma

getLimits

public double[] getLimits()
                   throws ProcessInterruptedException

Description copied from interface: Buffer

Calcula el mínimo y el máximo del histograma previamente.

Specified by:

getLimits in interface Buffer

Returns:

double[] con el mínimo y máximo y el segundo minimo y maximo.

Throws:

ProcessInterruptedException

getAllBandsLimits

public double[][] getAllBandsLimits()
                             throws ProcessInterruptedException

Specified by:

getAllBandsLimits in interface Buffer

Throws:

ProcessInterruptedException

addDrawableBands

public void addDrawableBands(int[] db)

Description copied from interface: Buffer

Assigns the band list but only for a read only buffer

Specified by:

addDrawableBands in interface Buffer

resetPercent

public void resetPercent()

getPercent

public int getPercent()

setProcess

public void setProcess(int process)

Asigna el proceso del cual se desea obtener información. Los procesos disponibles se definen como constantes en esta clase.

Parameters:

process -

isCached

public boolean isCached()

Description copied from interface: Buffer

Returns true if it is a cached buffer

Specified by:

isCached in interface Buffer

Returns:

isFromStore

public boolean isFromStore(DataStore store)

Description copied from interface: DataSet

Indicates whether this DataSet belongs to a specific store

Specified by:

isFromStore in interface DataSet

Parameters:

store - a DataStore

Returns:

true if this belongs to the given DataStore, false if not.

accept

public void accept(Visitor visitor)
            throws BaseException

Description copied from interface: DataSet

Provides each value of this Store to the provided Visitor. The values received through the Visitor.visit(Object) method may be transient, reused or externally modifiable, so they can't be used to be stored in any external form out of the visit method. If you need to store any of the values out of the Visitor.visit(Object) method execution, create a copy or clone the received value in order to be stored.

Specified by:

accept in interface DataSet

Specified by:

accept in interface Visitable

Parameters:

visitor - the visitor to apply to each value.

Throws:

BaseException - if there is an error while performing the visit

finalize

protected void finalize()
                 throws Throwable

Overrides:

finalize in class Object

Throws:

Throwable