| gvSIG desktop 1

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

import java.io.IOException;

import org.gvsig.gpe.kml.KmlTags;

import org.gvsig.gpe.xml.writer.Writer;

/* 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: CoordinatesWriter.java 11484 2007-05-08 07:53:08Z jorpiell $

 * $Log$

 * Revision 1.2  2007-05-08 07:53:08  jorpiell

 * Add comments to the writers

 *

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

 * Kml writing support added

 *

 *

 */

/**

 * This class writes a coordinates Kml 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 CoordinatesWriter {

        /**

         * It writes the coordinates tag and its value.

         * @param writer

         * Writer to write the labels

         * @param longitude

         * Longitude >= -180 and <= 180

         * @param latitude

         * Latitude >= -90 and <= 90

         * @param altitude

         * Meters above sea level

         * @throws IOException

         */

        public static void write(Writer writer,double longitude, double latitude,

                        double altitude) throws IOException{

                        writer.write("\n");

                        writer.write("<" + KmlTags.COORDINATES + ">");

                        writeOneCoordinate(writer,longitude,latitude,altitude);

                        writer.write("</" + KmlTags.COORDINATES + ">");

        }

        /**

         * It writes an array of coordinates written using

         * the kml coordinates tag

         * @param writer

         * Writer to write the labels

         * @param longitudes

         * Array of longitudes (>= -180 and <= 180)

         * @param latitudes

         * Array of latitudes (>= -90 and <= 90)

         * @param altitudes

         * Array of altitudes (Meters above sea level)

         * @throws IOException

         */

        public static void write(Writer writer,double[] longitudes, double[] latitudes,

                        double[] altitudes) throws IOException{

                writer.write("\n");

                writer.write("<" + KmlTags.COORDINATES + ">");

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

                        writeOneCoordinate(writer,longitudes[i],latitudes[i],altitudes[i]);

                        if (i<longitudes.length-1){

                                writer.write(KmlTags.TUPLES_SEPARATOR);

                        }

                }

                writer.write("</" + KmlTags.COORDINATES + ">");

        }

        /**

         * Writes the content of a coordinates kml tag

         * @param writer

         * Writer to write the labels

         * @param x

         * Longitude >= -180 and <= 180

         * @param y

         * Latitude >= -90 and <= 90

         * @param altitude

         * Meters above sea level

         * @throws IOException

         */

        private static void writeOneCoordinate(Writer writer,double x, double y,

                        double z) throws IOException{                

                DoubleWriter.write(writer,x);

                writer.write(KmlTags.COORDINATES_SEPARATOR);

                DoubleWriter.write(writer,y);

                writer.write(KmlTags.COORDINATES_SEPARATOR);

                DoubleWriter.write(writer,z);

        }

}