de.micromata.opengis.kml.v_2_2_0

Class Model

java.lang.Object

de.micromata.opengis.kml.v_2_2_0.AbstractObject

de.micromata.opengis.kml.v_2_2_0.Geometry

de.micromata.opengis.kml.v_2_2_0.Model

All Implemented Interfaces:

Cloneable

public class Model
extends Geometry
implements Cloneable

A 3D object described in a COLLADA file (referenced in the tag). COLLADA files have a .dae file extension. Models are created in their own coordinate space and then located, positioned, and scaled in Google Earth. See the "Topics in KML" page on Regions for more detail.

Google Earth supports only triangles and lines as primitive types. The maximum number of triangles allowed is 21845. Google Earth does not support animation or skinning. Google Earth does not support external geometry references.

Google Earth supports the COLLADA common profile, with the following exceptions:

Syntax:

<Model id="ID">
   <!-- specific to Model -->
   <altitudeMode>clampToGround</altitudeMode> 
       <!-- kml:altitudeModeEnum: clampToGround,relativeToGround,or absolute -->
       <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
   <Location> 
     <longitude></longitude> <!-- kml:angle180 -->
     <latitude></latitude>   <!-- kml:angle90 -->  
     <altitude>0</altitude>  <!-- double --> 
   </Location> 
   <Orientation>               
     <heading>0</heading>    <!-- kml:angle360 -->
     <tilt>0</tilt>          <!-- kml:angle360 -->
     <roll>0</roll>          <!-- kml:angle360 -->
   </Orientation> 
   <Scale> 
     <x>1</x>                <!-- double -->
     <y>1</y>                <!-- double -->
     <z>1</z>                <!-- double -->
   </Scale> 
   <Link>...</Link>
   <ResourceMap>
     <Alias>
       <targetHref>...</targetHref>   <!-- anyURI -->
       <sourceHref>...</sourceHref>   <!-- anyURI -->
     </Alias>
   </ResourceMap>
 </Model>

Extends:

Field Summary

Fields

Modifier and Type	Field and Description
protected AltitudeMode	altitudeMode AltitudeMode clampToGround, relativeToGround, absolute See Also: See and
protected Link	link (required). see .
protected Location	location Specifies the exact coordinates of the Model's origin in latitude, longitude, and altitude.
protected List<AbstractObject>	modelObjectExtension
protected List<Object>	modelSimpleExtension
protected Orientation	orientation Describes rotation of a 3D model's coordinate system to position the object in Google Earth.
protected ResourceMap	resourceMap
protected Scale	scale Note: The tag has been deprecated.

Fields inherited from class de.micromata.opengis.kml.v_2_2_0.Geometry

geometryObjectExtension, geometrySimpleExtension

Fields inherited from class de.micromata.opengis.kml.v_2_2_0.AbstractObject

id, objectSimpleExtension, targetId

Constructor Summary

Constructors

Constructor and Description
Model()

Method Summary

Methods

Modifier and Type	Method and Description
Model	addToGeometryObjectExtension(AbstractObject geometryObjectExtension) add a value to the geometryObjectExtension property collection
Model	addToGeometrySimpleExtension(Object geometrySimpleExtension) add a value to the geometrySimpleExtension property collection
Model	addToModelObjectExtension(AbstractObject modelObjectExtension) add a value to the modelObjectExtension property collection
Model	addToModelSimpleExtension(Object modelSimpleExtension) add a value to the modelSimpleExtension property collection
Model	addToObjectSimpleExtension(Object objectSimpleExtension) add a value to the objectSimpleExtension property collection
Model	clone()
Link	createAndSetLink() Creates a new instance of Link and set it to link.
Location	createAndSetLocation() Creates a new instance of Location and set it to location.
Orientation	createAndSetOrientation() Creates a new instance of Orientation and set it to orientation.
ResourceMap	createAndSetResourceMap() Creates a new instance of ResourceMap and set it to resourceMap.
Scale	createAndSetScale() Creates a new instance of Scale and set it to scale.
boolean	equals(Object obj)
AltitudeMode	getAltitudeMode()
Link	getLink()
Location	getLocation()
List<AbstractObject>	getModelObjectExtension()
List<Object>	getModelSimpleExtension()
Orientation	getOrientation()
ResourceMap	getResourceMap()
Scale	getScale()
int	hashCode()
void	setAltitudeMode(AltitudeMode value)
void	setGeometryObjectExtension(List<AbstractObject> geometryObjectExtension)
void	setGeometrySimpleExtension(List<Object> geometrySimpleExtension)
void	setLink(Link value)
void	setLocation(Location value)
void	setModelObjectExtension(List<AbstractObject> modelObjectExtension)
void	setModelSimpleExtension(List<Object> modelSimpleExtension)
void	setObjectSimpleExtension(List<Object> objectSimpleExtension)
void	setOrientation(Orientation value)
void	setResourceMap(ResourceMap value)
void	setScale(Scale value)
Model	withAltitudeMode(AltitudeMode altitudeMode) fluent setter
Model	withGeometryObjectExtension(List<AbstractObject> geometryObjectExtension) fluent setter
Model	withGeometrySimpleExtension(List<Object> geometrySimpleExtension) fluent setter
Model	withId(String id) fluent setter
Model	withLink(Link link) fluent setter
Model	withLocation(Location location) fluent setter
Model	withModelObjectExtension(List<AbstractObject> modelObjectExtension) fluent setter
Model	withModelSimpleExtension(List<Object> modelSimpleExtension) fluent setter
Model	withObjectSimpleExtension(List<Object> objectSimpleExtension) fluent setter
Model	withOrientation(Orientation orientation) fluent setter
Model	withResourceMap(ResourceMap resourceMap) fluent setter
Model	withScale(Scale scale) fluent setter
Model	withTargetId(String targetId) fluent setter

Methods inherited from class de.micromata.opengis.kml.v_2_2_0.Geometry

getGeometryObjectExtension, getGeometrySimpleExtension

Methods inherited from class de.micromata.opengis.kml.v_2_2_0.AbstractObject

getId, getObjectSimpleExtension, getTargetId, setId, setTargetId

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

altitudeMode

protected AltitudeMode altitudeMode

AltitudeMode

clampToGround, relativeToGround, absolute

See Also: See and

location

protected Location location

Specifies the exact coordinates of the Model's origin in latitude, longitude, and altitude. Latitude and longitude measurements are standard lat-lon projection with WGS84 datum. Altitude is distance above the earth's surface, in meters, and is interpreted according to or . 39.55375305703105 -118.9813220168456 1223

orientation

protected Orientation orientation

Describes rotation of a 3D model's coordinate system to position the object in Google Earth. See diagram below. 45.0 10.0 0.0

scale

protected Scale scale

Note: The tag has been deprecated. Use instead.

Resizes the icon.

Scales a model along the x, y, and z axes in the model's coordinate space. 2.5 2.5 3.5

link

protected Link link

(required). see .

specifies the location of any of the following:

If the file specified in is a local file, the and elements are not used.

KML files fetched by network links Image files used in any Overlay (the element specifies the image in an Overlay; has the same fields as ) Model files used in the element

Specifies the URL of the website containing this KML or KMZ file. Be sure to include the namespace for this element in any KML file that uses it: xmlns:atom="http://www.w3.org/2005/Atom" (see the sample that follows).

Specifies the file to load and optional refresh parameters. See .

The element replaces the element of contained in earlier KML releases and adds functionality for the element (introduced in KML 2.1). In Google Earth releases 3.0 and earlier, the element is ignored.

The file is conditionally loaded and refreshed, depending on the refresh parameters supplied here. Two different sets of refresh parameters can be specified: one set is based on time ( and ) and one is based on the current "camera" view ( and ). In addition, Link specifies whether to scale the bounding box parameters that are sent to the server ( and provides a set of optional viewing parameters that can be sent to the server () as well as a set of optional parameters containing version and language information.

Tip: To display the top-level Folder or Document within a Network Link in the List View, assign an ID to the Folder or Document. Without this ID, only the child object names are displayed in the List View.

When a file is fetched, the URL that is sent to the server is composed of three pieces of information:

the href (Hypertext Reference) that specifies the file to load. an arbitrary format string that is created from (a) parameters that you specify in the element or (b) bounding box parameters (this is the default and is used if no element is included in the file). a second format string that is specified in the element.

Syntax:

<Link id="ID">
   <!-- specific to Link -->
   <href>...</href>                      <!-- string -->
   <refreshMode>onChange</refreshMode>   
     <!-- refreshModeEnum: onChange, onInterval, or onExpire -->   
   <refreshInterval>4</refreshInterval>  <!-- float -->
   <viewRefreshMode>never</viewRefreshMode> 
     <!-- viewRefreshModeEnum: never, onStop, onRequest, onRegion -->
   <viewRefreshTime>4</viewRefreshTime>  <!-- float -->
   <viewBoundScale>1</viewBoundScale>    <!-- float -->
   <viewFormat>BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth]</viewFormat>
                                         <!-- string -->
   <httpQuery>...</httpQuery>            <!-- string -->
 </Link>

Extends:

resourceMap

protected ResourceMap resourceMap

modelSimpleExtension

protected List<Object> modelSimpleExtension

modelObjectExtension

protected List<AbstractObject> modelObjectExtension