/ - Diff - | gvSIG desktop 1 - gvSIG

Revision 11284

      * @author Nacho Brodin (nachobrodin@gmail.com)
      */
     public interface IDataWriter {
     	/**
     	 * 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
     	 */
     	public int[] readARGBData(int sizeX, int sizeY, int nBand);
     	/**
     	 * 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);
+    }

          * @param drvType        Tipo de driver
          */
         public GdalWriter(String fileName) {
         	ident = fileName.toLowerCase().substring(fileName.lastIndexOf(".") + 1);
         	ident = RasterUtilities.getExtensionFromFileName(fileName);
         	driver = (String)typeList.get(ident);
         	loadParams();

     import org.gvsig.raster.RasterLibrary;
     import org.gvsig.raster.shared.Extent;
     import org.gvsig.raster.util.RasterUtilities;
     import org.gvsig.raster.util.extensionPoints.ExtensionPoint;
     import org.gvsig.raster.util.extensionPoints.ExtensionPoints;
     import org.gvsig.raster.util.extensionPoints.ExtensionPointsSingleton;
-...
     	 * @return GeoRasterWriter, o null si hay problemas.
     	 */
     	public static GeoRasterWriter getWriter(String fName) throws NotSupportedExtensionException, RasterDriverException {
     		String ext = fName.toLowerCase().substring(fName.lastIndexOf('.')+1);
     		String ext = RasterUtilities.getExtensionFromFileName(fName);
     		GeoRasterWriter grw = null;
     		ExtensionPoints extensionPoints = ExtensionPointsSingleton.getInstance();

     		return  mDataset.getDatasetCount();
+    	}
     	/*
     	 *  (non-Javadoc)
     	 * @see org.gvsig.fmap.dataaccess.IQueryableRaster#getGeoRasterMultiFile()
     	/**
     	 * Obtiene la estructura que contiene la lista de ficheros del Grid
     	 * @return GeoRasterMultiFile
     	 */
     	public RasterMultiDataset getGeoRasterMultiFile() {
     		return mDataset;
-...
     		palette = null;
+    	}
     	/*
     	 *  (non-Javadoc)
     	 * @see org.gvsig.fmap.dataaccess.IQueryableRaster#addDrawableBands(int[])
     	/**
     	 * Para este GeoRasterFile asigna que bandas se pintaran
     	 * sobre el RasterBuf cuando se haga un update. Cada posici?n del vector es una banda
     	 * del rasterBuf y el contenido de esa posici?n es la banda de la imagen que se dibujar?
     	 * sobre ese RasterBuf.
     	 * @param drawableBands	Array con las bandas a dibujar.
     	 * @return array con tantos elementos como bandas a dibujar. El valor contenido es el fichero del
     	 * dataset multifichero al que corresponde la banda.
     	 */
     	public int[] addDrawableBands(int[] drawableBands) {
     		this.drawableBands = drawableBands;
-...
     		return files;
+    	}
     	/*
     	 *  (non-Javadoc)
     	 * @see org.gvsig.fmap.dataaccess.IQueryableRaster#setAllDrawableBands()
     	/**
     	 * Para este GeoRasterFile asigna que bandas se pintaran
     	 * sobre el RasterBuf cuando se haga un update. Cada posici?n del vector es una banda
     	 * del rasterBuf y el contenido de esa posici?n es la banda de la imagen que se dibujar?
     	 * sobre ese RasterBuf. Esta llamada asigna todas las bandas dibujables en su orden natural.
     	 * @return array con tantos elementos como bandas a dibujar. El valor contenido es el fichero del
     	 * dataset multifichero al que corresponde la banda.
     	 */
     	public int[] setAllDrawableBands() {
     		clearDrawableBand();
-...
     		return files;
+    	}
     	/*
     	 *  (non-Javadoc)
     	 * @see org.gvsig.fmap.dataaccess.IQueryableRaster#getDrawableBands()
     	/**
     	 * Obtiene el array que contiene el orden de bandas. Cada posici?n del vector es una banda
     	 * del rasterBuf y el contenido de esa posici?n es la banda de la imagen que se dibujar?
     	 * sobre ese RasterBuf.
     	 * @return Array de enteros con el orden de las badas
     	 */
     	public int[] getDrawableBands() {
     		return drawableBands;
-...
     		return width;
+    	}
     	/*
     	 *  (non-Javadoc)
     	 * @see org.gvsig.fmap.dataaccess.IQueryableRaster#getXCellSize()
     	/**
     	 * Tama?o de celda en X
     	 * @return
     	 */
     	public double getXCellSize() {
-...
+    	}
     	/*
     	 *  (non-Javadoc)
     	 * @see org.gvsig.fmap.dataaccess.IQueryableRaster#getYCellSize()
     	/**
     	 * Tama?o de celda en Y
     	 * @return
     	 */
     	public double getYCellSize() {
     		return 0;
+    	}
     	/*
     	 *  (non-Javadoc)
     	 * @see org.gvsig.fmap.dataaccess.IQueryableRaster#isNoData(int, int, int)
     	/**
     	 * Devuelve true si la celda contiene un valor de NODATA
     	 * @param x	coordenada X
     	 * @param y coordenada Y
     	 * @return
     	 */
     	public boolean isNoData(int x, int y, int band) {
-...
     		return 0D;
+    	}
     	/*
     	 *  (non-Javadoc)
     	 * @see org.gvsig.fmap.dataaccess.IQueryableRaster#setDataType(int)
     	/**
     	 * Asigna tipo de datos del raster
     	 * @see java.awt.image.DataBuffer
     	 */
     	public void setDataType(int dt) {
+    	}
     	/*
     	 *  (non-Javadoc)
     	 * @see org.gvsig.fmap.dataaccess.IQueryableRaster#getBandCount()
     	/**
     	 * Obtiene el n?mero de bandas
     	 * @return N?mero de bandas
     	 */
     	public int getBandCount() {
     		if(rasterBuf != null)
-...
     		return mDataset.getExtent();
+    	}
     	/*
     	 *  (non-Javadoc)
     	 * @see org.gvsig.fmap.dataaccess.IQueryableRaster#getData(int, int, int, int)
     	/**
     	 * Obtiene un buffer desde la posici?n x,y en pixeles de ancho w y alto h
     	 * @param x Coordenada x de la esquina superior izquierda
     	 * @param y Coordenada y de la esquina superior izquierda
     	 * @param w Ancho del grid
     	 * @param h Alto del grid
     	 * @return Buffer de datos
     	 */
     	public RasterBuffer getData(int x, int y, int w, int h) {
     		return null;
+    	}
     	/*
     	 *  (non-Javadoc)
     	 * @see org.gvsig.fmap.dataaccess.IQueryableRaster#getCoordsGeoTransformFile()
     	/**
     	 * Obtiene las coordenadas del fichero worldFile (o cabecera del raster) asociado
     	 * o el RMF en caso de que existan. Si la imagen no est? georreferenciada tendr?
     	 * las coordenadas pixel de la misma
     	 * @return Array de seis valores:
     	 * 	<TABLE BORDER="1">
     	 * 	<TR><TD><B>0:</B></TD><TD>Valor X de la esquina superior izquierda.</TD></TR>
     	 * 	<TR><TD><B>1:</B></TD><TD>Tama?o de pixel en X.</TD></TR>
     	 * 	<TR><TD><B>2:</B></TD><TD>Shearing en X.</TD></TR>
     	 * 	<TR><TD><B>3:</B></TD><TD>Valor Y de la esquina superior izquierda.</TD></TR>
     	 * 	<TR><TD><B>4:</B></TD><TD>Shearing en Y.</TD></TR>
     	 * 	<TR><TD><B>5:</B></TD><TD>Tama?o de pixel en Y.</TD></TR>
     	 * 	</TABLE>
     	 */
     	public double[] getCoordsGeoTransformFile() {
     		return mDataset.getCoordsGeoTransformFile();
+    	}
     	/*
     	 *  (non-Javadoc)
     	 * @see org.gvsig.fmap.dataaccess.IQueryableRaster#getLastSelectedView()
     	/**
     	 * Obtiene el extent de la ?ltima selecci?n hecha con alguna de las llamadas
     	 * setAreaOfInterest. Este extent es devuelto en coordenadas reales con las transformaciones
     	 * que se hayan aplicado sobre el/los dataset.
     	 * @return Extent Coordenadas reales que representan el ?ltimo ?rea de datos
     	 * solicitada.
     	 */
     	public Extent getLastSelectedView() {
     		return mDataset.getLastSelectedView();
-...
     		return dataExtent;
+    	}
     	/*
     	 * (non-Javadoc)
     	 * @see org.gvsig.fmap.dataaccess.IQueryableRaster#getPalettes()
     	/**
     	 * Obtiene la lista de paletas asociadas a las bandas cargadas en el DataSource
     	 * @return Lista con las paletas o null si no hay ninguna asocida. Un nulo en una
     	 * posici?n del array tambi?n indicar? que para esa banda no hay paletas asociadas.
     	 */
     	public DatasetPalette[] getPalettes() {
     		return palette;

     /**
      * Interfaz que deben implementar las clases que sirven datos y tienen posibilidad
      * de consulta. Tipicamente en gvSIG es implementado por DataSource que ofrecer?
      * sus datos a trav?s de un RasterBuffer y su interfaz IBuffer.
      * de consulta.
+     *
      * @author Nacho Brodin (nachobrodin@gmail.com)
+     *
-...
     	public final static int INTERPOLATION_InverseDistance	= 3;
     	public final static int INTERPOLATION_BicubicSpline		= 4;
     	public final static int INTERPOLATION_BSpline			= 5;
     	/**
     	 * Obtiene el ancho de la imagen
     	 * @return  Ancho en pixeles de la imagen
     	 */
     	public int getWidth();
     	/**
     	 * Obtiene el alto de la imagen
     	 * @return  Alto en pixeles de la imagen
     	 * Consulta si una capa est? siendo tileada o no
     	 * @return true si est? siendo tileada y false si no lo est?
     	 */
     	public int getHeight();
     	public boolean isTiled();
     	/**
     	 * Tama?o de celda en X
     	 * @return
     	 * Obtiene el tama?o del tile si la capa est? siendo tileada. Esta funci?n e fundamentalmente
     	 * usada por salvar a raster donde se consulta el tama?o del tile para hacer bandas de ese ancho.
     	 * @return array con dos enteros que representan el ancho y el alto del tile
     	 */
     	public double getXCellSize();
     	public int[] getTileSize();
     	/**
     	 * Tama?o de celda en Y
     	 * @return
     	 */
     	public double getYCellSize();
     	/**
     	 * Asigna el ?rea de interes en coordenadas del mundo real. Si las coordenadas exceden del tama?o de la imagen
     	 * estas coordenadas son ajustadas el extent.
     	 * @param x Coordenada X, esquina superior izquierda
     	 * @param y Coordenada Y, esquina superior izquierda
     	 * @param w Ancho del ?rea
     	 * @param h Alto del ?rea
     	 * @param adjustToExtent Flag que dice si el extent solicitado debe ajustarse al extent del raster o no.
     	 * @throws ArrayIndexOutOfBoundsException
     	 */
     	public void setAreaOfInterest(double x, double y, double w, double h, boolean adjustToExtent) throws ArrayIndexOutOfBoundsException;
     	/**
     	 * Asigna el ?rea de interes en coordenadas pixel. Si las coordenadas exceden del tama?o de la imagen
     	 * lanza una excepci?n.
     	 * @param x Coordenada X, esquina superior izquierda
     	 * @param y Coordenada Y, esquina superior izquierda
     	 * @param w Ancho del ?rea
     	 * @param h Alto del ?rea
     	 * @throws ArrayIndexOutOfBoundsException
     	 */
     	public void setAreaOfInterest(int x, int y, int w, int h) throws ArrayIndexOutOfBoundsException;
     	/**
     	 * Asigna el ?rea de inter?s a toda la extensi?n del raster.
     	 */
     	public void setAreaOfInterest();
     	/**
     	 * Asigna el ?rea de interes en coordenadas pixel. Esta operaci?n cargar? un RasterBuffer con los datos solicitados por
     	 * lo que, si al acabar hacemos getRasterBuf obtendremos la matriz de datos. Si las coordenadas exceden del tama?o
     	 * de la imagen lanza una excepci?n.
     	 * @param x Coordenada X, esquina superior izquierda
     	 * @param y Coordenada Y, esquina superior izquierda
     	 * @param w Ancho del ?rea
     	 * @param h Alto del ?rea
     	 * @param bufWidth Ancho del buffer
     	 * @param bufHeight Alto del buffer
     	 * @throws ArrayIndexOutOfBoundsException
     	 */
     	public void setAreaOfInterest(int x, int y, int w, int h, int bufWidth, int bufHeight) throws ArrayIndexOutOfBoundsException;
     	/**
     	 * Asigna el ?rea de interes en coordenadas del mundo real. Si las coordenadas exceden del tama?o de la imagen
     	 * estas coordenadas son ajustadas el extent.
     	 * @param x Coordenada X, esquina superior izquierda
     	 * @param y Coordenada Y, esquina superior izquierda
     	 * @param w Ancho del ?rea
     	 * @param h Alto del ?rea
     	 * @param bufWidth Ancho del buffer
     	 * @param bufHeight Alto del buffer
     	 * @param adjustToExtent Flag que dice si el extent solicitado debe ajustarse al extent del raster o no.
     	 * @return En caso de que el buffer sea mayor que el tama?o seleccionado de raster se produce supersampleo. La funci?n devuelve
     	 * un array de dos elementos que representan el desplazamiento en pixels de X e Y de la esquina superior izquierda.
     	 * @throws ArrayIndexOutOfBoundsException
     	 */
     	public int[] setAreaOfInterest(double minX, double minY, double maxX, double maxY, int bufWidth, int bufHeight, boolean adjustToExtent) throws ArrayIndexOutOfBoundsException;
     	/**
     	 * Obtiene un buffer desde la posici?n x,y en pixeles de ancho w y alto h
     	 * @param x Coordenada x de la esquina superior izquierda
     	 * @param y Coordenada y de la esquina superior izquierda
     	 * @param w Ancho del grid
     	 * @param h Alto del grid
     	 * @return Buffer de datos
     	 */
     	public RasterBuffer getData(int x, int y, int w, int h);
     	/**
     	 * Devuelve el tipo de datos del raster
     	 * @see java.awt.image.DataBuffer
     	 */
     	public int getDataType();
     	/**
     	 * Asigna tipo de datos del raster
     	 * @see java.awt.image.DataBuffer
     	 */
     	public void setDataType(int dt);
     	/**
     	 * Devuelve true si la celda contiene un valor de NODATA
     	 * @param x	coordenada X
     	 * @param y coordenada Y
     	 * @return
     	 */
     	public boolean isNoData(int x, int y, int band);
     	/**
     	 * Obtiene el n?mero de bandas
     	 * @return N?mero de bandas
     	 */
     	public int getBandCount();
     	/**
     	 * Obtiene el buffer de datos del grid
     	 * @return RasterBuf
     	 */
     	public IBuffer getRasterBuf();
     	/**
     	 * Para este GeoRasterFile asigna que bandas se pintaran
     	 * sobre el RasterBuf cuando se haga un update. Cada posici?n del vector es una banda
     	 * del rasterBuf y el contenido de esa posici?n es la banda de la imagen que se dibujar?
     	 * sobre ese RasterBuf.
     	 * @param drawableBands	Array con las bandas a dibujar.
     	 * @return array con tantos elementos como bandas a dibujar. El valor contenido es el fichero del
     	 * dataset multifichero al que corresponde la banda.
     	 */
     	public int[] addDrawableBands(int[] drawableBands);
     	/**
     	 * Para este GeoRasterFile asigna que bandas se pintaran
     	 * sobre el RasterBuf cuando se haga un update. Cada posici?n del vector es una banda
     	 * del rasterBuf y el contenido de esa posici?n es la banda de la imagen que se dibujar?
     	 * sobre ese RasterBuf. Esta llamada asigna todas las bandas dibujables en su orden natural.
     	 * @return array con tantos elementos como bandas a dibujar. El valor contenido es el fichero del
     	 * dataset multifichero al que corresponde la banda.
     	 */
     	public int[] setAllDrawableBands();
     	/**
     	 * Obtiene el array que contiene el orden de bandas. Cada posici?n del vector es una banda
     	 * del rasterBuf y el contenido de esa posici?n es la banda de la imagen que se dibujar?
     	 * sobre ese RasterBuf.
     	 * @return Array de enteros con el orden de las badas
     	 */
     	public int[] getDrawableBands();
     	/**
     	 * Obtiene el extent de la fuente de datos
     	 * @return Extent
     	 */
     	public Extent getExtent();
     	/**
     	 * Obtiene el extent correspondiente a los datos cargados en el buffer
     	 * @return Extent
     	 */
     	public Extent getDataExtent();
     	/**
     	 * Obtiene las coordenadas del fichero worldFile (o cabecera del raster) asociado
     	 * o el RMF en caso de que existan. Si la imagen no est? georreferenciada tendr?
     	 * las coordenadas pixel de la misma
     	 * @return Array de seis valores:
     	 * 	<TABLE BORDER="1">
     	 * 	<TR><TD><B>0:</B></TD><TD>Valor X de la esquina superior izquierda.</TD></TR>
     	 * 	<TR><TD><B>1:</B></TD><TD>Tama?o de pixel en X.</TD></TR>
     	 * 	<TR><TD><B>2:</B></TD><TD>Shearing en X.</TD></TR>
     	 * 	<TR><TD><B>3:</B></TD><TD>Valor Y de la esquina superior izquierda.</TD></TR>
     	 * 	<TR><TD><B>4:</B></TD><TD>Shearing en Y.</TD></TR>
     	 * 	<TR><TD><B>5:</B></TD><TD>Tama?o de pixel en Y.</TD></TR>
     	 * 	</TABLE>
     	 */
     	public double[] getCoordsGeoTransformFile();
     	/**
     	 * Obtiene el extent de la ?ltima selecci?n hecha con alguna de las llamadas
     	 * setAreaOfInterest. Este extent es devuelto en coordenadas reales con las transformaciones
     	 * que se hayan aplicado sobre el/los dataset.
     	 * @return Extent Coordenadas reales que representan el ?ltimo ?rea de datos
     	 * solicitada.
     	 */
     	public Extent getLastSelectedView();
     	/**
     	 * Obtiene la estructura que contiene la lista de ficheros del Grid
     	 * @return GeoRasterMultiFile
     	 */
     	public RasterMultiDataset getGeoRasterMultiFile();
     	/**
     	 * Obtiene la lista de paletas asociadas a las bandas cargadas en el DataSource
     	 * @return Lista con las paletas o null si no hay ninguna asocida. Un nulo en una
     	 * posici?n del array tambi?n indicar? que para esa banda no hay paletas asociadas.
     	 */
     	public DatasetPalette[] getPalettes();
+    }

     		return "";
+        }
         /**
          * Obtiene la extensi?n del fichero a partir de su nombre.
          * @param file Nombre o ruta del fichero
          * @return Cadena con la extensi?n que representa el tipo de fichero.
          */
         public static String getExtensionFromFileName(String file) {
         	return file.toLowerCase().substring(file.lastIndexOf(".") + 1);
+        }
         //---------------------------------------------------------------
         //VARIOS

Also available in: Unified diff