org.gvsig.raster.impl.buffer.cache

Class CacheStruct

java.lang.Object

org.gvsig.raster.impl.buffer.cache.CacheStruct

public class CacheStruct
extends java.lang.Object

Esta clase representa la estructura en memoria de la cache. Contiene el número de páginas así como los subconjuntos en las que se divide. Tendrá también datos como en ancho y alto de cada página y tamaño en memoria de esta.

Constructor Summary

Constructors

Constructor and Description
CacheStruct() Constructor de una sola banda y sin el calculo de parámetros.
CacheStruct(int nBands, int dataType, int dataSourceWidth, int dataSourceHeight) Calcula los parámetros del tamaño de caché y de página, asi como la altura de las mismas y el número de grupos que salen en caché.
CacheStruct(int nBands, int dataType, int dataSourceWidth, int dataSourceHeight, long cacheSize, long pageSize) Constructor solo para test.

Method Summary

Modifier and Type	Method and Description
int	getBitsPag() Obtiene el número de bits por página para poder calcular el desplazamiento binario de la dirección de acceso de la petición.
long	getCacheSize() Obtiene el tamaño de caché en Bytes
long	getCacheSizePerBand() Obtiene el tamaño de la caché por cada banda del raster.
int	getDataType() Obtiene el tipo de dato
int	getHPag() Obtiene la altura de la página de cache en líneas.
int	getNBands() Obtiene el número de bandas
int	getNGroups() Obtiene el número de grupos de caché
int	getNPags() Obtiene el número de páginas de la caché
int	getNTotalPags() Obtiene el número total de páginas del raster
int	getOffset() Obtiene el valor del desplazamiento Para extraer el desplazamiento de una dirección (línea de raster) hay que hacer una operación And con con la altura de la página -1.
long	getPagSize() Obtiene el tamaño de página en bytes
long	getPagSizePerBand() Obtiene el tamaño de una página de caché correspondiente a una banda
int	getPagsPerGroup() Obtiene el número de páginas que contiene cada grupo.
void	setBitsPag(int bitsPag) Asigna el número de bits por página para poder calcular el desplazamiento binario de la dirección de acceso de la petición.
void	setCacheSizePerBand(long cacheSizePerBand) Asigna el tamaño de la caché por cada banda del raster.
void	setDataType(int dataType) Asigna el tipo de dato
void	setHPag(int hPag) Asigna la altura de la página de cache en líneas.
void	setNBands(int nBands) Asigna el número de bandas
void	setNGroups(int nGroups) Asigna el número de grupos de caché
void	setNPags(int nPags) Asigna el número de páginas de la caché
void	setNTotalPags(int nPags) Asigna el número total de páginas del raster
void	setOffset(int offset) Asigna el valor del desplazamiento.
void	setPagSizePerBand(long pagSizePerBand) Asigna el tamaño de una página de caché correspondiente a una banda
void	show() Imprime la información de estructura de caché

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CacheStruct

public CacheStruct(int nBands,
                   int dataType,
                   int dataSourceWidth,
                   int dataSourceHeight)

Calcula los parámetros del tamaño de caché y de página, asi como la altura de las mismas y el número de grupos que salen en caché.

Parameters:

nBands - Número de bandas del raster

dataType - Tipo de dato de la imagen

dataSourceWidth - ancho de cada línea completa del raster.

CacheStruct

public CacheStruct()

Constructor de una sola banda y sin el calculo de parámetros. Estos deben ser asignados posteriorimente. Esta llamada es usada en casos especiales de creación de buffers cacheados.

CacheStruct

public CacheStruct(int nBands,
                   int dataType,
                   int dataSourceWidth,
                   int dataSourceHeight,
                   long cacheSize,
                   long pageSize)

Constructor solo para test. No utilizar con un uso normal de la librería Calcula los parámetros del tamaño de caché y de página, asi como la altura de las mismas y el número de grupos que salen en caché.

Parameters:

nBands - Número de bandas del raster

dataType - Tipo de dato de la imagen

dataSourceWidth - ancho de cada línea completa del raster.

Method Detail

getCacheSize

public long getCacheSize()

Obtiene el tamaño de caché en Bytes

Returns:

Tamaño de caché en Bytes

getHPag

public int getHPag()

Obtiene la altura de la página de cache en líneas.

Returns:

Número de líneas de altura de página.

setHPag

public void setHPag(int hPag)

Asigna la altura de la página de cache en líneas.

Parameters:

Número - de líneas de altura de página.

getNBands

public int getNBands()

Obtiene el número de bandas

Returns:

Número de bandas

setNBands

public void setNBands(int nBands)

Asigna el número de bandas

Parameters:

Número - de bandas

getNPags

public int getNPags()

Obtiene el número de páginas de la caché

Returns:

Número total de páginas de la caché

setNPags

public void setNPags(int nPags)

Asigna el número de páginas de la caché

Parameters:

Número - total de páginas de la caché

getPagSize

public long getPagSize()

Obtiene el tamaño de página en bytes

Returns:

Tamaño de página en bytes

getPagsPerGroup

public int getPagsPerGroup()

Obtiene el número de páginas que contiene cada grupo.

Returns:

Número de páginas de un grupo.

getNGroups

public int getNGroups()

Obtiene el número de grupos de caché

Returns:

Número de grupos

setNGroups

public void setNGroups(int nGroups)

Asigna el número de grupos de caché

Parameters:

nGroups - Número de grupos

getNTotalPags

public int getNTotalPags()

Obtiene el número total de páginas del raster

Returns:

Número total de páginas

setNTotalPags

public void setNTotalPags(int nPags)

Asigna el número total de páginas del raster

Parameters:

Número - total de páginas

getBitsPag

public int getBitsPag()

Obtiene el número de bits por página para poder calcular el desplazamiento binario de la dirección de acceso de la petición. Es decir si se solicita un dato en la línea 36 (en decimal) del raster 100100(en binario) y el desplazamiento es 4 bits el número de página resultante será 10(en binario) 2 (en decimal)

Returns:

Número de bits por página.

setBitsPag

public void setBitsPag(int bitsPag)

Asigna el número de bits por página para poder calcular el desplazamiento binario de la dirección de acceso de la petición. Es decir si se solicita un dato en la línea 36 (en decimal) del raster 100100(en binario) y el desplazamiento es 4 bits el número de página resultante será 10(en binario) 2 (en decimal)

Parameters:

bitsPag -

getOffset

public int getOffset()

Obtiene el valor del desplazamiento Para extraer el desplazamiento de una dirección (línea de raster) hay que hacer una operación And con con la altura de la página -1. Por ejemplo, una página de 16 líneas de altura el desplazamiento será 16 - 1 = 15 porque 15 en binario es 1111. Si queremos acceder a la linea del raster número 83 (1010011) realizando la operación And con el valor del desplazamiento obtenemos (0001111 & 1010011 = 0000011), es decir el valor 3 en decimal. Esto quiere decir que la línea 83 del raster es la 3 de su página.

Returns:

valor del desplazamiento

setOffset

public void setOffset(int offset)

Asigna el valor del desplazamiento. Para extraer el desplazamiento de una dirección (línea de raster) hay que hacer una operación And con con la altura de la página -1. Por ejemplo, una página de 16 líneas de altura el desplazamiento será 16 - 1 = 15 porque 15 en binario es 1111. Si queremos acceder a la linea del raster número 83 (1010011) realizando la operación And con el valor del desplazamiento obtenemos (0001111 & 1010011 = 0000011), es decir el valor 3 en decimal. Esto quiere decir que la línea 83 del raster es la 3 de su página.

Parameters:

offset - valor del desplazamiento

getCacheSizePerBand

public long getCacheSizePerBand()

Obtiene el tamaño de la caché por cada banda del raster. Hay que tener en cuenta que cada banda se trata como una estructura de datos en memoria distinta para poder hacer switch con las bandas de una forma sencilla

Returns:

long con el tamaño de cache por banda

setCacheSizePerBand

public void setCacheSizePerBand(long cacheSizePerBand)

Asigna el tamaño de la caché por cada banda del raster. Hay que tener en cuenta que cada banda se trata como una estructura de datos en memoria distinta para poder hacer switch con las bandas de una forma sencilla

Parameters:

long - con el tamaño de cache por banda

getPagSizePerBand

public long getPagSizePerBand()

Obtiene el tamaño de una página de caché correspondiente a una banda

Returns:

tamaño de una página de caché correspondiente a una banda

setPagSizePerBand

public void setPagSizePerBand(long pagSizePerBand)

Asigna el tamaño de una página de caché correspondiente a una banda

Parameters:

tamaño - de una página de caché correspondiente a una banda

show

public void show()

Imprime la información de estructura de caché

getDataType

public int getDataType()

Obtiene el tipo de dato

Returns:

Tipo de dato

setDataType

public void setDataType(int dataType)

Asigna el tipo de dato

Parameters:

dataType -