<!--
(C) Copyright 1996-2016 ECMWF.
This software is licensed under the terms of the Apache Licence Version 2.0
which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.
In applying this licence, ECMWF does not waive the privileges and immunities
granted to it by virtue of its status as an intergovernmental organisation nor
does it submit to any jurisdiction.
-->
<magics>
	<class inherits="BaseDriver"
		xmltag="kml"
		name="KMLDriver"
		directory="drivers"
		prefix="kml"
		action="KML">
		<documentation for_docs="no">
		This output driver produces output in the KML (Keyhole XML) format. This is the input format for
		Google Earth (http://earth.google.com) and Google Maps (http://maps.google.com).
		The output driver differs much from other drivers, because it describes not only a two-dimensional
		visualisation but also describes the dimensions of height and time.
		See also the parameters for the BaseDriver.
		</documentation>
		<parameter member="kmz"
			to="bool"
			default="on"
			from="string"
			name="kml_kmz">
			<documentation>Defines if output files will be zipped into a KMZ file.</documentation>
		</parameter>
		<parameter member="description"
			to="string"
			default="Generated by Magics"
			from="string"
			name="kml_description">
			<documentation>Short description for the product.</documentation>
		</parameter>
		<parameter member="author"
			to="string"
			default=""
			from="string"
			name="kml_author">
			<documentation>Gives the author of the product.</documentation>
		</parameter>
		<parameter member="link"
			to="string"
			default=""
			from="string"
			name="kml_link">
			<documentation>Gives the HTTP link to the product.</documentation>
		</parameter>
		<parameter member="height"
			to="float"
			default="5.0"
			from="float"
			name="kml_height">
			<documentation>Default height of all layers! [This is still WORK IN PROGRESS!!!]</documentation>
		</parameter>
		<parameter member="latitude"
			to="float"
			default="40.0"
			from="float"
			name="kml_latitude">
			<documentation>Defines the latitude of initial viewpoint.</documentation>
		</parameter>
		<parameter member="longitude"
			to="float"
			default="0.0"
			from="float"
			name="kml_longitude">
			<documentation>Defines the longitude of initial viewpoint.</documentation>
		</parameter>
		<parameter member="transparency"
			to="int"
			default="100"
			from="int"
			name="kml_transparency">
			<documentation>Defines the transparency in percentage ( 0% = invisible) of the layers saved.</documentation>
		</parameter>
		<parameter member="tilt"
			to="int"
			default="0"
			from="int"
			name="kml_tilt">
			<documentation>Defines the tilting angle for the default view (0 equals from above).</documentation>
		</parameter>
		<parameter member="range"
			to="int"
			default="6000"
			from="int"
			name="kml_range">
			<documentation>Defines the distance (km) to the default view in km.</documentation>
		</parameter>
		<parameter member="coastlines"
			to="bool"
			default="off"
			from="string"
			name="kml_coastlines">
			<documentation>Determines if coastlines are plotted by Magics or not. Default is OFF because Google Earth and Google Maps have their own coastlines.</documentation>
		</parameter>
	</class>
</magics>
