| gvSIG desktop 1

/**********************************************************************

 * $Id: GdalDriver.java 10988 2007-03-30 11:54:34Z nacho $

 *

 * Name:     Gdal.java

 * Project:  JGDAL. Interface java to gdal (Frank Warmerdam).

 * Purpose:   

 * Author:   Nacho Brodin, brodin_ign@gva.es

 *

 **********************************************************************/

/* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana

*

* Copyright (C) 2004 IVER T.I. and Generalitat Valenciana.

*

* 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., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.

*

* For more information, contact:

*

*  Generalitat Valenciana

*   Conselleria d'Infraestructures i Transport

*   Av. Blasco Ib??ez, 50

*   46010 VALENCIA

*   SPAIN

*

*      +34 963862235

*   gvsig@gva.es

*      www.gvsig.gva.es

*

*    or

*

*   IVER T.I. S.A

*   Salamanca 50

*   46005 Valencia

*   Spain

*

*   +34 963163400

*   dac@iver.es

*//* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana

*

* Copyright (C) 2004 IVER T.I. and Generalitat Valenciana.

*

* 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., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.

*

* For more information, contact:

*

*  Generalitat Valenciana

*   Conselleria d'Infraestructures i Transport

*   Av. Blasco Ib??ez, 50

*   46010 VALENCIA

*   SPAIN

*

*      +34 963862235

*   gvsig@gva.es

*      www.gvsig.gva.es

*

*    or

*

*   IVER T.I. S.A

*   Salamanca 50

*   46005 Valencia

*   Spain

*

*   +34 963163400

*   dac@iver.es

*/

package es.gva.cit.jgdal;

import java.util.StringTokenizer;

/**

 * Representa un driver de un tipo de im?gen 

 * 

 * @author Nacho Brodin <brodin_ign@gva.es>.<BR> Equipo de desarrollo gvSIG.<BR> http://www.gvsig.gva.es

 * @version 0.0

 * @link http://www.gvsig.gva.es

 */

public class GdalDriver extends JNIBase{

        private native long createCopyNat(long cPtr, String file, long src, int bstrict);

        private native long createCopyParamsNat(long cPtr, String file, long src, int bstrict, Options opc);

        private native long createNat(long cPtr, String filename, int nXSize, int nYSize, int nBands, int nType, Options opc);

        /**

         * Constructor de Driver pasandole como par?metro la referencia al objeto 

         * GdalDriver en C

         * 

         * @param cPtr        direcci?n de memoria del objeto 

         */

        public GdalDriver(long cPtr){

                this.cPtr=cPtr;

        }

        /**

         * Crea una copia de una im?gen a partir de un dataset de origen especificado.

         * @param file        Nombre del fichero sobre el cual se guardar? la copia

         * @param src        Dataset fuente a copiar

         * @param bstrict        TRUE si la copia debe ser estrictamente equivalente y FALSE indica que la copia puede

         * adaptarse a las necesidades del formato de salida

         * @return Gdal        Dataset de la im?gen de salida

         * @throws GdalException

         */

        public Gdal createCopy( String file, Gdal src, boolean bstrict )throws GdalException{

                long ptr;

                if(bstrict)

                        ptr = createCopyNat(cPtr,file,src.getPtro(),1);

                else

                        ptr = createCopyNat(cPtr,file,src.getPtro(),0);

                return (new Gdal(ptr));

        }

        /**

         * A partir de las opciones en forma de vector de Strings pasadas por el usuario donde cada

         * elemento del vector tiene la forma VARIABLE=VALOR crea el objeto Options para que sea accesible

         * a las funciones JNI desde C.

         * @param params        Vector de strigs con las opciones

         * @return Options        Objeto de opciones

         */

        private Options selectOptions(String[] params){

                if(params==null)return null;

                Options opc=new Options(params.length);

                StringTokenizer st;

                for(int i=0;i<params.length;i++){

                        st = new StringTokenizer(params[i],"=");

                    String var=st.nextToken();

                    String dato=st.nextToken();

                    opc.addOption(var,dato);                            

                }

                return opc;

        }

        /**

         * Crea una copia de una im?gen a partir de un dataset de origen especificado y unos par?metros dados.

         * @param file        Nombre del fichero sobre el cual se guardar? la copia

         * @param src        Dataset fuente a copiar

         * @param bstrict        TRUE si la copia debe ser estrictamente equivalente y FALSE indica que la copia puede

         * adaptarse a las necesidades del formato de salida

         * @param params        Vector de strigs con las opciones de la copia

         * @return Gdal        Dataset de la im?gen de salida

         * @throws GdalException

         */

        public Gdal createCopy( String file, Gdal src, boolean bstrict, String[] params )throws GdalException{

                long papszOptions=-1;

                long ptr;

                if(bstrict)

                        ptr = createCopyParamsNat(cPtr, file, src.getPtro(), 1, selectOptions(params));

                else

                        ptr = createCopyParamsNat(cPtr, file, src.getPtro(), 0, selectOptions(params));

                return (new Gdal(ptr));

        }

        /**

         * Crea un nuevo dataset con el driver actual

         * 

         * @param filename        Nombre del dataset a crear

         * @param nXSize        Ancho en pixels

         * @param nYSize        Alto en pixels

         * @param nBands        N?mero de bandas

         * @param nType        Tipo de raster

         * @param params        lista de par?metros especificos del driver

         */

        public Gdal create(String filename, int nXSize, int nYSize, int nBands, int nType, String[] params)throws GdalException{

                long papszOptions=-1;

                long ptr = createNat(cPtr, filename, nXSize, nYSize, nBands, nType, selectOptions(params));

                return (new Gdal(ptr));

        }

}