de.micromata.opengis.kml.v_2_2_0
Class LookAt

java.lang.Object
  extended by de.micromata.opengis.kml.v_2_2_0.AbstractObject
      extended by de.micromata.opengis.kml.v_2_2_0.AbstractView
          extended by de.micromata.opengis.kml.v_2_2_0.LookAt
All Implemented Interfaces:
java.lang.Cloneable

public class LookAt
extends AbstractView
implements java.lang.Cloneable

Defines a virtual camera that is associated with any element derived from Feature. The LookAt element positions the "camera" in relation to the object that is being viewed. In Google Earth, the view "flies to" this LookAt viewpoint when the user double-clicks an item in the Places panel or double-clicks an icon in the 3D viewer.

Syntax:
<LookAt id="ID">
   <!-- inherited from AbstractView element -->
   <TimePrimitive>...</TimePrimitive>  <!-- gx:TimeSpan or gx:TimeStamp -->
    
   <!-- specific to LookAt -->
   <longitude>0</longitude>            <!-- kml:angle180 -->
   <latitude>0</latitude>              <!-- kml:angle90 -->
   <altitude>0</altitude>              <!-- double --> 
   <heading>0</heading>                <!-- kml:angle360 -->
   <tilt>0</tilt>                      <!-- kml:anglepos90 -->
   <range></range>                     <!-- double -->
   <altitudeMode>clampToGround</altitudeMode> 
           <!--kml:altitudeModeEnum:clampToGround, relativeToGround, absolute -->
           <!-- or, gx:altitudeMode can be substituted: clampToSeaFloor, relativeToSeaFloor -->
 
 </LookAt>
Extends:


Field Summary
protected  double altitude
          
protected  AltitudeMode altitudeMode
          AltitudeMode
protected  double heading
          
protected  double latitude
          
protected  double longitude
          
protected  java.util.List<AbstractObject> lookAtObjectExtension
          
protected  java.util.List<java.lang.Object> lookAtSimpleExtension
           
protected  double range
           (required)
protected  double tilt
          
 
Fields inherited from class de.micromata.opengis.kml.v_2_2_0.AbstractView
abstractViewObjectExtension, abstractViewSimpleExtension
 
Fields inherited from class de.micromata.opengis.kml.v_2_2_0.AbstractObject
id, objectSimpleExtension, targetId
 
Constructor Summary
LookAt()
           
 
Method Summary
 LookAt addToAbstractViewObjectExtension(AbstractObject abstractViewObjectExtension)
          add a value to the abstractViewObjectExtension property collection
 LookAt addToAbstractViewSimpleExtension(java.lang.Object abstractViewSimpleExtension)
          add a value to the abstractViewSimpleExtension property collection
 LookAt addToLookAtObjectExtension(AbstractObject lookAtObjectExtension)
          add a value to the lookAtObjectExtension property collection
 LookAt addToLookAtSimpleExtension(java.lang.Object lookAtSimpleExtension)
          add a value to the lookAtSimpleExtension property collection
 LookAt addToObjectSimpleExtension(java.lang.Object objectSimpleExtension)
          add a value to the objectSimpleExtension property collection
 LookAt clone()
           
 boolean equals(java.lang.Object obj)
           
 double getAltitude()
           
 AltitudeMode getAltitudeMode()
           
 double getHeading()
           
 double getLatitude()
           
 double getLongitude()
           
 java.util.List<AbstractObject> getLookAtObjectExtension()
           
 java.util.List<java.lang.Object> getLookAtSimpleExtension()
           
 double getRange()
           
 double getTilt()
           
 int hashCode()
           
 void setAbstractViewObjectExtension(java.util.List<AbstractObject> abstractViewObjectExtension)
          Sets the value of the abstractViewObjectExtension property Objects of the following type(s) are allowed in the list List.
 void setAbstractViewSimpleExtension(java.util.List<java.lang.Object> abstractViewSimpleExtension)
          Sets the value of the abstractViewSimpleExtension property Objects of the following type(s) are allowed in the list List.
 void setAltitude(double value)
           
 void setAltitudeMode(AltitudeMode value)
           
 void setHeading(double value)
           
 void setLatitude(double value)
           
 void setLongitude(double value)
           
 void setLookAtObjectExtension(java.util.List<AbstractObject> lookAtObjectExtension)
           
 void setLookAtSimpleExtension(java.util.List<java.lang.Object> lookAtSimpleExtension)
           
 void setObjectSimpleExtension(java.util.List<java.lang.Object> objectSimpleExtension)
           
 void setRange(double value)
           
 void setTilt(double value)
           
 LookAt withAbstractViewObjectExtension(java.util.List<AbstractObject> abstractViewObjectExtension)
          fluent setter
 LookAt withAbstractViewSimpleExtension(java.util.List<java.lang.Object> abstractViewSimpleExtension)
          fluent setter
 LookAt withAltitude(double altitude)
          fluent setter
 LookAt withAltitudeMode(AltitudeMode altitudeMode)
          fluent setter
 LookAt withHeading(double heading)
          fluent setter
 LookAt withId(java.lang.String id)
          fluent setter
 LookAt withLatitude(double latitude)
          fluent setter
 LookAt withLongitude(double longitude)
          fluent setter
 LookAt withLookAtObjectExtension(java.util.List<AbstractObject> lookAtObjectExtension)
          fluent setter
 LookAt withLookAtSimpleExtension(java.util.List<java.lang.Object> lookAtSimpleExtension)
          fluent setter
 LookAt withObjectSimpleExtension(java.util.List<java.lang.Object> objectSimpleExtension)
          fluent setter
 LookAt withRange(double range)
          fluent setter
 LookAt withTargetId(java.lang.String targetId)
          fluent setter
 LookAt withTilt(double tilt)
          fluent setter
 
Methods inherited from class de.micromata.opengis.kml.v_2_2_0.AbstractView
getAbstractViewObjectExtension, getAbstractViewSimpleExtension
 
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

longitude

protected double longitude

Longitude of the point the camera is looking at. Angular distance in degrees, relative to the Prime Meridian. Values west of the Meridian range from −180 to 0 degrees. Values east of the Meridian range from 0 to 180 degrees.

Longitude of the virtual camera (eye point). Angular distance in degrees, relative to the Prime Meridian. Values west of the Meridian range from −180 to 0 degrees. Values east of the Meridian range from 0 to 180 degrees.


latitude

protected double latitude

Latitude of the point the camera is looking at. Degrees north or south of the Equator (0 degrees). Values range from −90 degrees to 90 degrees.

Latitude of the virtual camera. Degrees north or south of the Equator (0 degrees). Values range from −90 degrees to 90 degrees.


altitude

protected double altitude

Distance from the earth's surface, in meters. Interpreted according to the LookAt's altitude mode.

Distance of the camera from the earth's surface, in meters. Interpreted according to the Camera's or .

Specifies the distance above the earth's surface, in meters, and is interpreted according to the altitude mode.


heading

protected double heading

Direction (azimuth) of the camera, in degrees. Default=0 (true North). (See diagram.) Values range from 0 to 360 degrees.

Direction (that is, North, South, East, West), in degrees. Default=0 (North). (See diagram below.) Values range from 0 to 360 degrees.

Direction (that is, North, South, East, West), in degrees. Default=0 (North). (See diagram.) Values range from 0 to 360 degrees.

Rotation about the z axis (normal to the Earth's surface). A value of 0 (the default) equals North. A positive rotation is clockwise around the z axis and specified in degrees from 0 to 360.


tilt

protected double tilt

Angle between the direction of the LookAt position and the normal to the surface of the earth. (See diagram below.) Values range from 0 to 90 degrees. Values for cannot be negative. A value of 0 degrees indicates viewing from directly above. A value of 90 degrees indicates viewing along the horizon.

Rotation about the x axis. A positive rotation is clockwise around the x axis and specified in degrees from 0 to 360.

Rotation, in degrees, of the camera around the X axis. A value of 0 indicates that the view is aimed straight down toward the earth (the most common case). A value for 90 for indicates that the view is aimed toward the horizon. Values greater than 90 indicate that the view is pointed up into the sky. Values for are clamped at +180 degrees.


range

protected double range
(required)

Distance in meters from the point specified by , , and to the LookAt position. (See diagram below.)


altitudeMode

protected AltitudeMode altitudeMode
AltitudeMode

clampToGround, relativeToGround, absolute

See Also: See and


lookAtSimpleExtension

protected java.util.List<java.lang.Object> lookAtSimpleExtension

lookAtObjectExtension

protected java.util.List<AbstractObject> lookAtObjectExtension

This is an abstract base class and cannot be used directly in a KML file. It provides the id attribute, which allows unique identification of a KML element, and the targetId attribute, which is used to reference objects that have already been loaded into Google Earth. The id attribute must be assigned if the mechanism is to be used.

Syntax:
<!-- abstract element; do not create -->
 <!-- Object id="ID" targetId="NCName" -->
 <!-- /Object> -->

Constructor Detail

LookAt

public LookAt()
Method Detail

getLongitude

public double getLongitude()
Returns:
possible object is Double
See Also:
longitude

setLongitude

public void setLongitude(double value)
Parameters:
value - allowed object is Double
See Also:
longitude

getLatitude

public double getLatitude()
Returns:
possible object is Double
See Also:
latitude

setLatitude

public void setLatitude(double value)
Parameters:
value - allowed object is Double
See Also:
latitude

getAltitude

public double getAltitude()
Returns:
possible object is Double
See Also:
altitude

setAltitude

public void setAltitude(double value)
Parameters:
value - allowed object is Double
See Also:
altitude

getHeading

public double getHeading()
Returns:
possible object is Double
See Also:
heading

setHeading

public void setHeading(double value)
Parameters:
value - allowed object is Double
See Also:
heading

getTilt

public double getTilt()
Returns:
possible object is Double
See Also:
tilt

setTilt

public void setTilt(double value)
Parameters:
value - allowed object is Double
See Also:
tilt

getRange

public double getRange()
Returns:
possible object is Double
See Also:
range

setRange

public void setRange(double value)
Parameters:
value - allowed object is Double
See Also:
range

getAltitudeMode

public AltitudeMode getAltitudeMode()
Returns:
possible object is <Object <AltitudeMode <de.micromata.opengis.kml.v_2_2_0.gx.AltitudeMode
See Also:
altitudeMode

setAltitudeMode

public void setAltitudeMode(AltitudeMode value)
Parameters:
value - allowed object is <Object <AltitudeMode <de.micromata.opengis.kml.v_2_2_0.gx.AltitudeMode
See Also:
altitudeMode

getLookAtSimpleExtension

public java.util.List<java.lang.Object> getLookAtSimpleExtension()
See Also:
lookAtSimpleExtension

getLookAtObjectExtension

public java.util.List<AbstractObject> getLookAtObjectExtension()
See Also:
lookAtObjectExtension

hashCode

public int hashCode()
Overrides:
hashCode in class AbstractView

equals

public boolean equals(java.lang.Object obj)
Overrides:
equals in class AbstractView

setLookAtSimpleExtension

public void setLookAtSimpleExtension(java.util.List<java.lang.Object> lookAtSimpleExtension)
Parameters:
lookAtSimpleExtension -
See Also:
lookAtSimpleExtension

addToLookAtSimpleExtension

public LookAt addToLookAtSimpleExtension(java.lang.Object lookAtSimpleExtension)
add a value to the lookAtSimpleExtension property collection

Parameters:
lookAtSimpleExtension - Objects of the following type are allowed in the list: Object
Returns:
true (as general contract of Collection.add).

setLookAtObjectExtension

public void setLookAtObjectExtension(java.util.List<AbstractObject> lookAtObjectExtension)
Parameters:
lookAtObjectExtension -
See Also:
lookAtObjectExtension

addToLookAtObjectExtension

public LookAt addToLookAtObjectExtension(AbstractObject lookAtObjectExtension)
add a value to the lookAtObjectExtension property collection

Parameters:
lookAtObjectExtension - Objects of the following type are allowed in the list: AbstractObject
Returns:
true (as general contract of Collection.add).

setObjectSimpleExtension

public void setObjectSimpleExtension(java.util.List<java.lang.Object> objectSimpleExtension)
Overrides:
setObjectSimpleExtension in class AbstractView
See Also:
objectSimpleExtension

addToObjectSimpleExtension

public LookAt addToObjectSimpleExtension(java.lang.Object objectSimpleExtension)
Description copied from class: AbstractObject
add a value to the objectSimpleExtension property collection

Overrides:
addToObjectSimpleExtension in class AbstractView
Parameters:
objectSimpleExtension - Objects of the following type are allowed in the list: Object
Returns:
true (as general contract of Collection.add).

setAbstractViewSimpleExtension

public void setAbstractViewSimpleExtension(java.util.List<java.lang.Object> abstractViewSimpleExtension)
Description copied from class: AbstractView
Sets the value of the abstractViewSimpleExtension property Objects of the following type(s) are allowed in the list List.

Note:

This method does not make use of the fluent pattern.If you would like to make it fluent, use AbstractView.withAbstractViewSimpleExtension(java.util.List) instead.

Overrides:
setAbstractViewSimpleExtension in class AbstractView
See Also:
abstractViewSimpleExtension

addToAbstractViewSimpleExtension

public LookAt addToAbstractViewSimpleExtension(java.lang.Object abstractViewSimpleExtension)
Description copied from class: AbstractView
add a value to the abstractViewSimpleExtension property collection

Overrides:
addToAbstractViewSimpleExtension in class AbstractView
Parameters:
abstractViewSimpleExtension - Objects of the following type are allowed in the list: Object
Returns:
true (as general contract of Collection.add).

setAbstractViewObjectExtension

public void setAbstractViewObjectExtension(java.util.List<AbstractObject> abstractViewObjectExtension)
Description copied from class: AbstractView
Sets the value of the abstractViewObjectExtension property Objects of the following type(s) are allowed in the list List.

Note:

This method does not make use of the fluent pattern.If you would like to make it fluent, use AbstractView.withAbstractViewObjectExtension(java.util.List) instead.

Overrides:
setAbstractViewObjectExtension in class AbstractView
See Also:
abstractViewObjectExtension

addToAbstractViewObjectExtension

public LookAt addToAbstractViewObjectExtension(AbstractObject abstractViewObjectExtension)
Description copied from class: AbstractView
add a value to the abstractViewObjectExtension property collection

Overrides:
addToAbstractViewObjectExtension in class AbstractView
Parameters:
abstractViewObjectExtension - Objects of the following type are allowed in the list: <AbstractObjectJAXBElement<TimeSpanJAXBElement<TimeStamp
Returns:
true (as general contract of Collection.add).

withLongitude

public LookAt withLongitude(double longitude)
fluent setter

Parameters:
longitude - required parameter
See Also:
setLongitude(double)

withLatitude

public LookAt withLatitude(double latitude)
fluent setter

Parameters:
latitude - required parameter
See Also:
setLatitude(double)

withAltitude

public LookAt withAltitude(double altitude)
fluent setter

Parameters:
altitude - required parameter
See Also:
setAltitude(double)

withHeading

public LookAt withHeading(double heading)
fluent setter

Parameters:
heading - required parameter
See Also:
setHeading(double)

withTilt

public LookAt withTilt(double tilt)
fluent setter

Parameters:
tilt - required parameter
See Also:
setTilt(double)

withRange

public LookAt withRange(double range)
fluent setter

Parameters:
range - required parameter
See Also:
setRange(double)

withAltitudeMode

public LookAt withAltitudeMode(AltitudeMode altitudeMode)
fluent setter

Parameters:
altitudeMode - required parameter
See Also:
#setAltitudeMode(Object)

withLookAtSimpleExtension

public LookAt withLookAtSimpleExtension(java.util.List<java.lang.Object> lookAtSimpleExtension)
fluent setter

Parameters:
lookAtSimpleExtension - required parameter
See Also:
#setLookAtSimpleExtension(List)

withLookAtObjectExtension

public LookAt withLookAtObjectExtension(java.util.List<AbstractObject> lookAtObjectExtension)
fluent setter

Parameters:
lookAtObjectExtension - required parameter
See Also:
#setLookAtObjectExtension(List)

withObjectSimpleExtension

public LookAt withObjectSimpleExtension(java.util.List<java.lang.Object> objectSimpleExtension)
Description copied from class: AbstractObject
fluent setter

Overrides:
withObjectSimpleExtension in class AbstractView
Parameters:
objectSimpleExtension - required parameter
See Also:
#setObjectSimpleExtension(List)

withId

public LookAt withId(java.lang.String id)
Description copied from class: AbstractObject
fluent setter

Overrides:
withId in class AbstractView
Parameters:
id - required parameter
See Also:
AbstractObject.setId(String)

withTargetId

public LookAt withTargetId(java.lang.String targetId)
Description copied from class: AbstractObject
fluent setter

Overrides:
withTargetId in class AbstractView
Parameters:
targetId - required parameter
See Also:
AbstractObject.setTargetId(String)

withAbstractViewSimpleExtension

public LookAt withAbstractViewSimpleExtension(java.util.List<java.lang.Object> abstractViewSimpleExtension)
Description copied from class: AbstractView
fluent setter

Overrides:
withAbstractViewSimpleExtension in class AbstractView
Parameters:
abstractViewSimpleExtension - required parameter
See Also:
#setAbstractViewSimpleExtension(List)

withAbstractViewObjectExtension

public LookAt withAbstractViewObjectExtension(java.util.List<AbstractObject> abstractViewObjectExtension)
Description copied from class: AbstractView
fluent setter

Overrides:
withAbstractViewObjectExtension in class AbstractView
Parameters:
abstractViewObjectExtension - required parameter
See Also:
#setAbstractViewObjectExtension(List)

clone

public LookAt clone()
Overrides:
clone in class AbstractView