de.micromata.opengis.kml.v_2_2_0
Class ViewVolume

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

public class ViewVolume
extends AbstractObject
implements java.lang.Cloneable

Defines how much of the current scene is visible. Specifying the field of view is analogous to specifying the lens opening in a physical camera. A small field of view, like a telephoto lens, focuses on a small part of the scene. A large field of view, like a wide-angle lens, focuses on a large part of the scene.


Field Summary
protected  double bottomFov
          
protected  double leftFov
          
protected  double near
          
protected  double rightFov
          
protected  double topFov
          
protected  java.util.List<AbstractObject> viewVolumeObjectExtension
          
protected  java.util.List<java.lang.Object> viewVolumeSimpleExtension
           
 
Fields inherited from class de.micromata.opengis.kml.v_2_2_0.AbstractObject
id, objectSimpleExtension, targetId
 
Constructor Summary
ViewVolume()
           
 
Method Summary
 ViewVolume addToObjectSimpleExtension(java.lang.Object objectSimpleExtension)
          add a value to the objectSimpleExtension property collection
 ViewVolume addToViewVolumeObjectExtension(AbstractObject viewVolumeObjectExtension)
          add a value to the viewVolumeObjectExtension property collection
 ViewVolume addToViewVolumeSimpleExtension(java.lang.Object viewVolumeSimpleExtension)
          add a value to the viewVolumeSimpleExtension property collection
 ViewVolume clone()
           
 boolean equals(java.lang.Object obj)
           
 double getBottomFov()
           
 double getLeftFov()
           
 double getNear()
           
 double getRightFov()
           
 double getTopFov()
           
 java.util.List<AbstractObject> getViewVolumeObjectExtension()
           
 java.util.List<java.lang.Object> getViewVolumeSimpleExtension()
           
 int hashCode()
           
 void setBottomFov(double value)
           
 void setLeftFov(double value)
           
 void setNear(double value)
           
 void setObjectSimpleExtension(java.util.List<java.lang.Object> objectSimpleExtension)
           
 void setRightFov(double value)
           
 void setTopFov(double value)
           
 void setViewVolumeObjectExtension(java.util.List<AbstractObject> viewVolumeObjectExtension)
           
 void setViewVolumeSimpleExtension(java.util.List<java.lang.Object> viewVolumeSimpleExtension)
           
 ViewVolume withBottomFov(double bottomFov)
          fluent setter
 ViewVolume withId(java.lang.String id)
          fluent setter
 ViewVolume withLeftFov(double leftFov)
          fluent setter
 ViewVolume withNear(double near)
          fluent setter
 ViewVolume withObjectSimpleExtension(java.util.List<java.lang.Object> objectSimpleExtension)
          fluent setter
 ViewVolume withRightFov(double rightFov)
          fluent setter
 ViewVolume withTargetId(java.lang.String targetId)
          fluent setter
 ViewVolume withTopFov(double topFov)
          fluent setter
 ViewVolume withViewVolumeObjectExtension(java.util.List<AbstractObject> viewVolumeObjectExtension)
          fluent setter
 ViewVolume withViewVolumeSimpleExtension(java.util.List<java.lang.Object> viewVolumeSimpleExtension)
          fluent setter
 
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

leftFov

protected double leftFov

Angle, in degrees, between the camera's viewing direction and the left side of the view volume.


rightFov

protected double rightFov

Angle, in degrees, between the camera's viewing direction and the right side of the view volume.


bottomFov

protected double bottomFov

Angle, in degrees, between the camera's viewing direction and the bottom side of the view volume.


topFov

protected double topFov

Angle, in degrees, between the camera's viewing direction and the top side of the view volume.


near

protected double near

Angle, in degrees, between the camera's viewing direction and the left side of the view volume. Angle, in degrees, between the camera's viewing direction and the right side of the view volume. Angle, in degrees, between the camera's viewing direction and the bottom side of the view volume. Angle, in degrees, between the camera's viewing direction and the top side of the view volume. Measurement in meters along the viewing direction from the camera viewpoint to the PhotoOverlay shape.

Measurement in meters along the viewing direction from the camera viewpoint to the PhotoOverlay shape.

The field of view for a PhotoOverlay is defined by four planes, each of which is specified by an angle relative to the view vector. These four planes define the top, bottom, left, and right sides of the field of view, which has the shape of a truncated pyramid, as shown here:

The following diagrams show the four field-of-view angles within this pyramid:

The following diagrams show the four field-of-view angles within this pyramid:


viewVolumeSimpleExtension

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

viewVolumeObjectExtension

protected java.util.List<AbstractObject> viewVolumeObjectExtension

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

ViewVolume

public ViewVolume()
Method Detail

getLeftFov

public double getLeftFov()
Returns:
possible object is Double
See Also:
leftFov

setLeftFov

public void setLeftFov(double value)
Parameters:
value - allowed object is Double
See Also:
leftFov

getRightFov

public double getRightFov()
Returns:
possible object is Double
See Also:
rightFov

setRightFov

public void setRightFov(double value)
Parameters:
value - allowed object is Double
See Also:
rightFov

getBottomFov

public double getBottomFov()
Returns:
possible object is Double
See Also:
bottomFov

setBottomFov

public void setBottomFov(double value)
Parameters:
value - allowed object is Double
See Also:
bottomFov

getTopFov

public double getTopFov()
Returns:
possible object is Double
See Also:
topFov

setTopFov

public void setTopFov(double value)
Parameters:
value - allowed object is Double
See Also:
topFov

getNear

public double getNear()
Returns:
possible object is Double
See Also:
near

setNear

public void setNear(double value)
Parameters:
value - allowed object is Double
See Also:
near

getViewVolumeSimpleExtension

public java.util.List<java.lang.Object> getViewVolumeSimpleExtension()
See Also:
viewVolumeSimpleExtension

getViewVolumeObjectExtension

public java.util.List<AbstractObject> getViewVolumeObjectExtension()
See Also:
viewVolumeObjectExtension

hashCode

public int hashCode()
Overrides:
hashCode in class AbstractObject

equals

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

setViewVolumeSimpleExtension

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

addToViewVolumeSimpleExtension

public ViewVolume addToViewVolumeSimpleExtension(java.lang.Object viewVolumeSimpleExtension)
add a value to the viewVolumeSimpleExtension property collection

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

setViewVolumeObjectExtension

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

addToViewVolumeObjectExtension

public ViewVolume addToViewVolumeObjectExtension(AbstractObject viewVolumeObjectExtension)
add a value to the viewVolumeObjectExtension property collection

Parameters:
viewVolumeObjectExtension - 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 AbstractObject
See Also:
objectSimpleExtension

addToObjectSimpleExtension

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

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

withLeftFov

public ViewVolume withLeftFov(double leftFov)
fluent setter

Parameters:
leftFov - required parameter
See Also:
setLeftFov(double)

withRightFov

public ViewVolume withRightFov(double rightFov)
fluent setter

Parameters:
rightFov - required parameter
See Also:
setRightFov(double)

withBottomFov

public ViewVolume withBottomFov(double bottomFov)
fluent setter

Parameters:
bottomFov - required parameter
See Also:
setBottomFov(double)

withTopFov

public ViewVolume withTopFov(double topFov)
fluent setter

Parameters:
topFov - required parameter
See Also:
setTopFov(double)

withNear

public ViewVolume withNear(double near)
fluent setter

Parameters:
near - required parameter
See Also:
setNear(double)

withViewVolumeSimpleExtension

public ViewVolume withViewVolumeSimpleExtension(java.util.List<java.lang.Object> viewVolumeSimpleExtension)
fluent setter

Parameters:
viewVolumeSimpleExtension - required parameter
See Also:
#setViewVolumeSimpleExtension(List)

withViewVolumeObjectExtension

public ViewVolume withViewVolumeObjectExtension(java.util.List<AbstractObject> viewVolumeObjectExtension)
fluent setter

Parameters:
viewVolumeObjectExtension - required parameter
See Also:
#setViewVolumeObjectExtension(List)

withObjectSimpleExtension

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

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

withId

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

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

withTargetId

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

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

clone

public ViewVolume clone()
Overrides:
clone in class AbstractObject