org.gvsig.raster.cache.buffer

Interface BufferCacheManager

public interface BufferCacheManager

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 BufferCacheServices.

Field Summary

Fields

Modifier and Type	Field and Description
static int	BAND_CACHE
static int	BAND_VERT_CACHE
static double	defaultNoDataValue Valor noData por defecto para la librería.
static int	DONT_FORCE
static int	MEMORY_BUFFER
static boolean	noDataValueEnable
static int	READ_ONLY_CACHE

Method Summary

Modifier and Type	Method and Description
Buffer	createBuffer(BufferParam params) Genera instancias del buffer de datos adecuado al tamaño del raster.
BufferParam	createBufferParams(int w, int h) Builds a new parameter object
BufferParam	createBufferParams(int w, int h, int bandCount, int dataType) Creates a parameter object for building a buffer.
BufferParam	createBufferParams(String[] files, int x, int y, int w, int h, int[] bands) Creates a parameter object for building a buffer.
BufferParam	createBufferParams(String file, int x, int y, int w, int h) Creates a parameter object for building a buffer.
BufferParam	createBufferParams(String file, int x, int y, int w, int h, int[] bands) Creates a parameter object for building a buffer.
BufferNoData	createDefaultNoData(int bandCount, int dataType) Builds a new NoData for DEMs
BufferHistogram	createHistogram(int nBands, double[] min, double[] max, int dataType, int numberOfClasses) Creates a empty histogram
BufferHistogram	createHistogram(int nBands, int nClasses, double[] min, double[] max) Creates a empty histogram
BufferInterpolation	createInterpolation(Buffer buf) Creates a new instance of an interpolation object.
Buffer	createMemoryBuffer(BufferParam params) Creates an instance of a memory buffer
Buffer	createMemoryBuffer(int dataType, int width, int height, int bandNr, boolean malloc) Creates an instance of a memory buffer
BufferNoData	createNoData(Number noData, Number nativeNoData, String fileName) Builds a new NoData for DEMs
BufferNoData	createNoData(Number noData, Number nativeNoData, String fileName, int bandCount) Builds a new NoData object
Buffer	createReadOnlyBuffer(String file) Genera una instancia del buffer de solo lectura.
TaskEventManager	createTask(Object process) Registers the object as a task using the current thread ID.
TaskEventManager	getTask() Gets a register task.

Field Detail

DONT_FORCE

static final int DONT_FORCE

See Also:

Constant Field Values

MEMORY_BUFFER

static final int MEMORY_BUFFER

See Also:

Constant Field Values

BAND_CACHE

static final int BAND_CACHE

See Also:

Constant Field Values

BAND_VERT_CACHE

static final int BAND_VERT_CACHE

See Also:

Constant Field Values

READ_ONLY_CACHE

static final int READ_ONLY_CACHE

See Also:

Constant Field Values

defaultNoDataValue

static final double defaultNoDataValue

Valor noData por defecto para la librería. En caso de no tener un valor asociado al raster se usará este.

See Also:

Constant Field Values

noDataValueEnable

static final boolean noDataValueEnable

See Also:

Constant Field Values

Method Detail

createBuffer

Buffer createBuffer(BufferParam params)

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.

Parameters:

params - Parámetros de la carga

Returns:

Objeto RasterBuffer

createReadOnlyBuffer

Buffer createReadOnlyBuffer(String file)

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.

Parameters:

file - File to read data

createMemoryBuffer

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

Creates an instance of a memory buffer

Parameters:

dataType - Tipo de dato

width - Ancho

height - Alto

bandNr - Banda

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.

createMemoryBuffer

Buffer createMemoryBuffer(BufferParam params)

Creates an instance of a memory buffer

Parameters:

params - Parameters to instantiate this buffer

createInterpolation

BufferInterpolation createInterpolation(Buffer buf)

Creates a new instance of an interpolation object.

Parameters:

buf - IRasterBuffer

Returns:

IBufferInterpolation

createBufferParams

BufferParam createBufferParams(int w,
                               int h)

Builds a new parameter object

Parameters:

x - Upper left X position

y - Upper left X position

w - Width

h - Height

createBufferParams

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

Creates a parameter object for building a buffer. The buffer type is read-write. This type could be changed after the creation of a BufferParam object.

Parameters:

w - Width

h - Height

bandCount - Number of bands

dataType - Type of data

createBufferParams

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 and the source will be a multifile.

Parameters:

files - File list in disk

x - initial pixel

y - initial pixel

w - Width in pixels

h - Height in pixels

bands - bands to render

Returns:

BufferParam

Throws:

IOException

createBufferParams

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.

Parameters:

file - File in disk

x - initial pixel

y - initial pixel

w - Width in pixels

h - Height in pixels

bands - bands to render

Returns:

BufferParam

Throws:

IOException

createBufferParams

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

Creates a parameter object for building a buffer. For this call the buffer type is read-only.

Parameters:

file - File in disk

x - initial pixel

y - initial pixel

w - Width in pixels

h - Height in pixels

bands - bands to render

Returns:

BufferParam

Throws:

IOException

createNoData

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

Builds a new NoData object

Parameters:

noData - value to assign to all bands

nativeNoData - The native is the original value saved in the head of the file or its metadata.

fileName - Name of file owner of this nodata value. This string is useful to save the rmf file

bandCount - Number of bands of the file

Returns:

NoData

createNoData

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

Builds a new NoData for DEMs

Parameters:

noData - value to assign to all bands

nativeNoData - The native is the original value saved in the head of the file or its metadata.

fileName - Name of file owner of this nodata value. This string is useful to save the rmf file

Returns:

NoData

createDefaultNoData

BufferNoData createDefaultNoData(int bandCount,
                                 int dataType)

Builds a new NoData for DEMs

Parameters:

dataType - dataType of this NoData

bandCount - Number of bands

Returns:

NoData

createHistogram

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

Creates a empty histogram

Parameters:

nBands -

min -

max -

dataType -

numberOfClasses -

Returns:

createHistogram

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

Creates a empty histogram

Parameters:

nBands -

min -

max -

dataType -

numberOfClasses -

Returns:

getTask

TaskEventManager getTask()

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

Returns:

TaskEventManager

createTask

TaskEventManager createTask(Object process)

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

Parameters:

process -

Returns: