de.micromata.opengis.kml.v_2_2_0

Class LookAt

java.lang.Object

de.micromata.opengis.kml.v_2_2_0.AbstractObject

de.micromata.opengis.kml.v_2_2_0.AbstractView

de.micromata.opengis.kml.v_2_2_0.LookAt

All Implemented Interfaces:

Cloneable

public class LookAt
extends AbstractView
implements 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

Fields

Modifier and Type	Field and Description
protected double	altitude Distance from the earth's surface, in meters.
protected AltitudeMode	altitudeMode AltitudeMode clampToGround, relativeToGround, absolute See Also: See and
protected double	heading Direction (azimuth) of the camera, in degrees.
protected double	latitude Latitude of the point the camera is looking at.
protected double	longitude Longitude of the point the camera is looking at.
protected List<AbstractObject>	lookAtObjectExtension
protected List<Object>	lookAtSimpleExtension
protected double	range (required) Distance in meters from the point specified by , , and to the LookAt position.
protected double	tilt Angle between the direction of the LookAt position and the normal to the surface of the earth.

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

Constructors

Constructor and Description
LookAt()

Method Summary

Methods

Modifier and Type	Method and Description
LookAt	addToAbstractViewObjectExtension(AbstractObject abstractViewObjectExtension) add a value to the abstractViewObjectExtension property collection
LookAt	addToAbstractViewSimpleExtension(Object abstractViewSimpleExtension) add a value to the abstractViewSimpleExtension property collection
LookAt	addToLookAtObjectExtension(AbstractObject lookAtObjectExtension) add a value to the lookAtObjectExtension property collection
LookAt	addToLookAtSimpleExtension(Object lookAtSimpleExtension) add a value to the lookAtSimpleExtension property collection
LookAt	addToObjectSimpleExtension(Object objectSimpleExtension) add a value to the objectSimpleExtension property collection
LookAt	clone()
boolean	equals(Object obj)
double	getAltitude()
AltitudeMode	getAltitudeMode()
double	getHeading()
double	getLatitude()
double	getLongitude()
List<AbstractObject>	getLookAtObjectExtension()
List<Object>	getLookAtSimpleExtension()
double	getRange()
double	getTilt()
int	hashCode()
void	setAbstractViewObjectExtension(List<AbstractObject> abstractViewObjectExtension) Sets the value of the abstractViewObjectExtension property Objects of the following type(s) are allowed in the list List.
void	setAbstractViewSimpleExtension(List<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(List<AbstractObject> lookAtObjectExtension)
void	setLookAtSimpleExtension(List<Object> lookAtSimpleExtension)
void	setObjectSimpleExtension(List<Object> objectSimpleExtension)
void	setRange(double value)
void	setTilt(double value)
LookAt	withAbstractViewObjectExtension(List<AbstractObject> abstractViewObjectExtension) fluent setter
LookAt	withAbstractViewSimpleExtension(List<Object> abstractViewSimpleExtension) fluent setter
LookAt	withAltitude(double altitude) fluent setter
LookAt	withAltitudeMode(AltitudeMode altitudeMode) fluent setter
LookAt	withHeading(double heading) fluent setter
LookAt	withId(String id) fluent setter
LookAt	withLatitude(double latitude) fluent setter
LookAt	withLongitude(double longitude) fluent setter
LookAt	withLookAtObjectExtension(List<AbstractObject> lookAtObjectExtension) fluent setter
LookAt	withLookAtSimpleExtension(List<Object> lookAtSimpleExtension) fluent setter
LookAt	withObjectSimpleExtension(List<Object> objectSimpleExtension) fluent setter
LookAt	withRange(double range) fluent setter
LookAt	withTargetId(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 List<Object> lookAtSimpleExtension

lookAtObjectExtension

protected List<AbstractObject> lookAtObjectExtension