Application: gvSIG desktop » gvSIG raster

/* 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.fmap.dal.coverage.store;

import org.gvsig.fmap.dal.coverage.dataset.Buffer;

import org.gvsig.fmap.dal.coverage.exception.ProcessInterruptedException;

import org.gvsig.fmap.dal.coverage.process.BaseIncrementableTask;

import org.gvsig.tools.dispose.Disposable;

/**

 * Este interfaz debe ser implementado por las clases que vayan a

 * servir datos a los drivers de escritura.

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

 */

public interface DataServerWriter extends Disposable, BaseIncrementableTask {

        /**

         * Para el tipo de datos ARGB (32 bits en un solo entero) obtiene un array que representa 

         * los datos le?dos. Este array se obtendr? de la fuente de datos

         * asociada al renderizador y sera de ancho sizeX y alto sizeY. Es el propio renderizador

         * el encargado de llevar la posici?n de la ?ltima l?nea le?da para la siguiente petici?n

         * ofrecer datos a partir de donde se quedo.

         * @param sizeX Ancho del bloque de datos

         * @param sizeY Alto del bloque de datos

         * @return Array con los datos leidos

         * @throws OutOfMemoryError 

         * @throws ProcessInterruptedException 

         */

        public int[] readARGBData(int sizeX, int sizeY, int nBand) throws ProcessInterruptedException, OutOfMemoryError;

        /**

         * Para el tipo de datos byte obtiene un array bidimensional donde la primera dimensi?n

         * son las bandas y la segunda los datos. Este array se obtendra de la fuente de datos

         * asociada al renderizador y sera de ancho sizeX y alto sizeY. Es el propio renderizador

         * el encargado de llevar la posici?n de la ?ltima l?nea le?da para la siguiente petici?n

         * ofrecer datos a partir de donde se quedo.

         * @param sizeX Ancho del bloque de datos

         * @param sizeY Alto del bloque de datos

         * @return Array bidimensionar de numero de bandas por datos leidos

         */

    public byte[][] readByteData(int sizeX, int sizeY);

        /**

         * Para el tipo de datos short obtiene un array bidimensional donde la primera dimensi?n

         * son las bandas y la segunda los datos. Este array se obtendra de la fuente de datos

         * asociada al renderizador y sera de ancho sizeX y alto sizeY. Es el propio renderizador

         * el encargado de llevar la posici?n de la ?ltima l?nea le?da para la siguiente petici?n

         * ofrecer datos a partir de donde se quedo.

         * @param sizeX Ancho del bloque de datos

         * @param sizeY Alto del bloque de datos

         * @return Array bidimensionar de numero de bandas por datos leidos

         */

    public short[][] readShortData(int sizeX, int sizeY);

        /**

         * Para el tipo de datos int obtiene un array bidimensional donde la primera dimensi?n

         * son las bandas y la segunda los datos. Este array se obtendra de la fuente de datos

         * asociada al renderizador y sera de ancho sizeX y alto sizeY. Es el propio renderizador

         * el encargado de llevar la posici?n de la ?ltima l?nea le?da para la siguiente petici?n

         * ofrecer datos a partir de donde se quedo.

         * @param sizeX Ancho del bloque de datos

         * @param sizeY Alto del bloque de datos

         * @return Array bidimensionar de numero de bandas por datos leidos

         */

    public int[][] readIntData(int sizeX, int sizeY);

        /**

         * Para el tipo de datos float obtiene un array bidimensional donde la primera dimensi?n

         * son las bandas y la segunda los datos. Este array se obtendra de la fuente de datos

         * asociada al renderizador y sera de ancho sizeX y alto sizeY. Es el propio renderizador

         * el encargado de llevar la posici?n de la ?ltima l?nea le?da para la siguiente petici?n

         * ofrecer datos a partir de donde se quedo.

         * @param sizeX Ancho del bloque de datos

         * @param sizeY Alto del bloque de datos

         * @return Array bidimensionar de numero de bandas por datos leidos

         */

    public float[][] readFloatData(int sizeX, int sizeY);

        /**

         * Para el tipo de datos double obtiene un array bidimensional donde la primera dimensi?n

         * son las bandas y la segunda los datos. Este array se obtendra de la fuente de datos

         * asociada al renderizador y sera de ancho sizeX y alto sizeY. Es el propio renderizador

         * el encargado de llevar la posici?n de la ?ltima l?nea le?da para la siguiente petici?n

         * ofrecer datos a partir de donde se quedo.

         * @param sizeX Ancho del bloque de datos

         * @param sizeY Alto del bloque de datos

         * @return Array bidimensionar de numero de bandas por datos leidos

         */

    public double[][] readDoubleData(int sizeX, int sizeY);

        /**

         * Asigna el buffer de datos e inicializa variables de

         * @param buffer

         * @param nband Si es menor que cero sirve datos de todas las bandas. Si es

         * mayor que cero sirve datos de la banda indicada por el valor.

         */

        public void setBuffer(Buffer buffer, int nband);

        /**

         * Assigns the band number to serve

         * @param nband Number of band or lesser than zero for all bands

         */

        public void setBand(int nband);

        /**

         * Obtiene el porcentaje de incremento de la lectura de datos

         * @return

         */

        public int getPercent();

        /**

         * @param alphaBuffer the alphaBuffer to set

         */

        public void setAlphaBuffer(Buffer alphaBuffer);

}