Application: gvSIG desktop

package org.gvsig.gpe.kml.bindings.geometries;

import java.io.IOException;

import org.gvsig.gpe.kml.GPEKmlParser;

import org.gvsig.gpe.kml.KmlTags;

import org.gvsig.gpe.kml.exceptions.KmlBodyParseException;

import org.kxml2.io.KXmlParser;

import org.xmlpull.v1.XmlPullParser;

import org.xmlpull.v1.XmlPullParserException;

/* 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

 */

/* CVS MESSAGES:

 *

 * $Id: CoordinatesTypeBinding.java 11485 2007-05-08 08:22:37Z jorpiell $

 * $Log$

 * Revision 1.3  2007-05-08 08:22:37  jorpiell

 * Add comments to create javadocs

 *

 * Revision 1.2  2007/04/14 16:08:07  jorpiell

 * Kml writing support added

 *

 * Revision 1.1  2007/04/13 13:16:21  jorpiell

 * Add KML reading support

 *

 * Revision 1.1  2007/03/07 08:19:10  jorpiell

 * Pasadas las clases de KML de libGPE-GML a libGPE-KML

 *

 * Revision 1.1  2007/02/28 11:48:31  csanchez

 * *** empty log message ***

 *

 * Revision 1.1  2007/02/20 10:53:20  jorpiell

 * A?adidos los proyectos de kml y gml antiguos

 *

 * Revision 1.1  2007/02/12 13:49:18  jorpiell

 * A?adido el driver de KML

 *

 *

 */

/**

 * This class parses a coordinates tag. Example:

 * <p>

 * <pre>

 * <code>

 * <coordinates>60.0,60.0 60.0,90.0 90.0,90.0</coordinates>

 * </code>

 * </pre>

 * </p> 

 * @author Jorge Piera LLodr? (jorge.piera@iver.es)

 * @see http://code.google.com/apis/kml/documentation/kml_tags_21.html#coordinates

 */

public class CoordinatesTypeBinding {

        /**

         * It parses the coordinates tag

         * @param parser

         * The XML parser

         * @param handler

         * The GPE parser that contains the content handler and

         * the error handler

         * @return

         * It retuns a matrix of doubles with 3 columns (x,y,z) and

         * one row for each coordinate.

         * @throws IOException 

         * @throws XmlPullParserException 

         */

        public static double[][] parse(XmlPullParser parser,GPEKmlParser handler) throws XmlPullParserException, IOException  {

                boolean endFeature = false;

                int currentTag;

                double[][] aCoordinates = null;

                String tag = parser.getName();

                currentTag = parser.getEventType();

                while (!endFeature){

                        switch(currentTag){

                        case KXmlParser.START_TAG:

                                if (tag.compareTo(KmlTags.COORDINATES) == 0){

                                        parser.next();

                                        String[] coordinates = parser.getText().split(KmlTags.TUPLES_SEPARATOR);

                                        aCoordinates = new double[3][coordinates.length];

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

                                                String[] coordinate = coordinates[i].trim().split(KmlTags.COORDINATES_SEPARATOR);

                                                aCoordinates[0][i] = Double.valueOf(coordinate[0]).doubleValue();

                                                aCoordinates[1][i] = Double.valueOf(coordinate[1]).doubleValue();

                                                aCoordinates[2][i] = Double.valueOf(coordinate[2]).doubleValue();

                                        }                                        

                                }

                                break;

                        case KXmlParser.END_TAG:

                                if (tag.compareTo(KmlTags.COORDINATES) == 0){                                                

                                        endFeature = true;

                                }

                                break;

                        case KXmlParser.TEXT:                                        

                                break;

                        }

                        if (!endFeature){                                        

                                currentTag = parser.next();

                                tag = parser.getName();

                        }

                }                        

                return aCoordinates;        

        }

}