BasicView (NASA WorldWind)

java.lang.Object
- gov.nasa.worldwind.avlist.AVListImpl
- - gov.nasa.worldwind.WWObjectImpl
  - - gov.nasa.worldwind.view.BasicView

All Implemented Interfaces:

AVList, MessageListener, Restorable, View, WWObject, java.beans.PropertyChangeListener, java.util.EventListener

Direct Known Subclasses:

BasicFlyView, BasicOrbitView
```
public class BasicView
extends WWObjectImpl
implements View
```
A base class from which View implementations can be derived. Currently BasicFlyView and BasicOrbitView are both derived from BasicView BasicView models the view in terms of a geographic position, and a pitch, heading, and roll. It provides a mapping from that geocentric view model to a 3D graphics modelview matrix. BasicView also manages the projection matrix via a Frustum.
The view model is based on

Field Summary

Fields
Modifier and Type	Field and Description
`protected static int`	`COLLISION_NUM_ITERATIONS`
`protected static double`	`COLLISION_THRESHOLD`
`protected DrawContext`	`dc`
`protected static double`	`DEFAULT_DEPTH_RESOLUTION` The views's default worst-case depth resolution, in meters.
`protected boolean`	`detectCollisions`
`protected Position`	`eyePosition`
`protected double`	`farClipDistance`
`protected Angle`	`fieldOfView` The field of view in degrees.
`protected Frustum`	`frustum`
`protected Globe`	`globe`
`protected boolean`	`hadCollisions`
`protected Angle`	`heading`
`protected double`	`horizonDistance`
`protected Vec4`	`lastEyePoint`
`protected Position`	`lastEyePosition`
`protected Vec4`	`lastForwardVector`
`protected Frustum`	`lastFrustumInModelCoords`
`protected Vec4`	`lastUpVector`
`protected static double`	`MINIMUM_FAR_DISTANCE`
`protected static double`	`MINIMUM_NEAR_DISTANCE`
`protected Matrix`	`modelview`
`protected Matrix`	`modelviewInv`
`protected double`	`nearClipDistance`
`protected Angle`	`pitch`
`protected Matrix`	`projection`
`protected Angle`	`roll`
`protected ViewInputHandler`	`viewInputHandler`
`protected ViewPropertyLimits`	`viewLimits`
`protected java.awt.Rectangle`	`viewport`
`protected long`	`viewStateID` Identifier for the modelview matrix state.

Fields inherited from interface gov.nasa.worldwind.View
VIEW_STOPPED

Constructor Summary

Constructors
Constructor and Description

BasicView()
Construct a BasicView

Constructors
Constructor and Description
`BasicView()` Construct a BasicView

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`addAnimator(Animator animator)` Add an animator to the this View.
`void`	`apply(DrawContext dc)` Calculates and applies this `View's` internal state to the graphics context in the specified `dc`.
`protected Position`	`computeEyePositionFromModelview()`
`protected double`	`computeFarClipDistance()`
`protected double`	`computeFarDistance(Position eyePosition)`
`protected double`	`computeHorizonDistance()`
`protected double`	`computeHorizonDistance(Position eyePosition)`
`protected double`	`computeNearClipDistance()`
`protected double`	`computeNearDistance(Position eyePosition)`
`double`	`computePixelSizeAtDistance(double distance)` Computes the dimension (in meters) that a screen pixel would cover at a given distance from the eye point (also in meters).
`Position`	`computePositionFromScreenPoint(double x, double y)` Computes the intersection of a line originating from the eye point and passing through (x, y) with the `Globe`.
`Line`	`computeRayFromScreenPoint(double x, double y)` Computes a line, in model coordinates, originating from the eye point, and passing through the point contained by (x, y) on the `View's` projection plane (or after projection into model space).
`void`	`copyViewState(View view)` Copy the state of the given `View`.
`protected void`	`doApply(DrawContext dc)`
`protected void`	`doGetRestorableState(RestorableSupport rs, RestorableSupport.StateObject context)`
`protected void`	`doRestoreState(RestorableSupport rs, RestorableSupport.StateObject context)`
`Vec4`	`getCenterPoint()` Gets the center point of the view.
`Position`	`getCenterPosition()`
`Vec4`	`getCurrentEyePoint()` Returns the most up-to-date location of the eye in cartesian coordinates.
`Position`	`getCurrentEyePosition()` Returns the current geographic coordinates of this view's eye position, as determined from this view's current parameters.
`Vec4`	`getCurrentForwardVector()` Returns the most up-to-date forward vector.
`DrawContext`	`getDC()`
`Vec4`	`getEyePoint()` Returns the location of the eye in cartesian coordinates.
`Position`	`getEyePosition()` Returns the current geographic coordinates of this view's eye position, as computed for the most recent model traversal.
`double`	`getFarClipDistance()` Returns the far clipping plane distance, in eye coordinates.
`Angle`	`getFieldOfView()` Returns the horizontal field-of-view angle (the angle of visibility), or null if the implementation does not support a field-of-view.
`Vec4`	`getForwardVector()` Returns the forward axis in cartesian coordinates.
`Frustum`	`getFrustum()` Returns the viewing `Frustum` in eye coordinates.
`Frustum`	`getFrustumInModelCoordinates()` Returns the viewing `Frustum` in model coordinates.
`Globe`	`getGlobe()` Gets the globe associated with this view.
`Angle`	`getHeading()` Returns the view's current heading.
`double`	`getHorizonDistance()` Returns the horizon distance for this view's most recently used eye position.
`Matrix`	`getModelviewMatrix()` Returns the modelview matrix.
`double`	`getNearClipDistance()` Returns the near clipping plane distance, in eye coordinates.
`Angle`	`getPitch()` Returns the view's current pitch.
`Matrix`	`getProjectionMatrix()` Gets the projection matrix.
`java.lang.String`	`getRestorableState()` Returns an XML document string describing the object's state.
`Angle`	`getRoll()` Returns this View's current roll.
`Vec4`	`getUpVector()` Returns the up axis in cartesian coordinates.
`ViewInputHandler`	`getViewInputHandler()` Gets the `ViewInputHandler` being used to map input events to `View` controls.
`java.awt.Rectangle`	`getViewport()` Returns the bounds (x, y, width, height) of the viewport.
`ViewPropertyLimits`	`getViewPropertyLimits()` Get the `ViewPropertyLimits` for this view.
`long`	`getViewStateID()` Get an identifier for the current state of the modelview matrix.
`void`	`goTo(Position position, double distance)` Animate to the specified position.
`boolean`	`hadCollisions()`
`boolean`	`isAnimating()` Determine if there are any animations active in the `View`.
`boolean`	`isDetectCollisions()`
`static void`	`loadGLViewState(DrawContext dc, Matrix modelview, Matrix projection)` Sets the the opengl modelview and projection matrices to the given matrices.
`void`	`popReferenceCenter(DrawContext dc)` Removes the model-view matrix on top of the matrix stack, and restores the original matrix.
`Vec4`	`project(Vec4 modelPoint)` Maps a `Point` in model (cartesian) coordinates to a `Point` in screen coordinates.
`Vec4`	`project(Vec4 point, Matrix modelview, Matrix projection, java.awt.Rectangle viewport)` Transforms the specified object coordinates into window coordinates using the given modelview and projection matrices, and viewport.
`Matrix`	`pushReferenceCenter(DrawContext dc, Vec4 referenceCenter)` Defines and applies a new model-view matrix in which the world origin is located at `referenceCenter`.
`void`	`restoreState(java.lang.String stateInXml)` Restores the object's state to what is described in the specified XML document string.
`void`	`setDetectCollisions(boolean detectCollisions)`
`void`	`setEyePosition(Position eyePosition)` Sets the geographic position of the eye.
`protected void`	`setFarClipDistance(double clipDistance)`
`void`	`setFieldOfView(Angle fieldOfView)` Sets the horizontal field-of-view angle (the angle of visibility) to the specified `fieldOfView`.
`void`	`setGlobe(Globe globe)` Set the globe associated with this view.
`void`	`setHeading(Angle heading)` Sets the heading of the view.
`protected void`	`setNearClipDistance(double clipDistance)`
`void`	`setOrientation(Position eyePosition, Position centerPosition)` Sets the location of the eye, and the center of the screen in geographic coordinates.
`void`	`setPitch(Angle pitch)` Sets the pitch of the view.
`Matrix`	`setReferenceCenter(DrawContext dc, Vec4 referenceCenter)` Sets the reference center matrix without pushing the stack.
`void`	`setRoll(Angle roll)` Set the roll of the view.
`void`	`setViewInputHandler(ViewInputHandler viewInputHandler)`
`protected void`	`setViewState(ViewUtil.ViewState modelCoords)`
`void`	`stopAnimations()` Stops any animations that are active in this `View`
`void`	`stopMovement()` Stops any movement associated with this `View`.
`Vec4`	`unProject(Vec4 windowPoint)` Maps a `Point` in screen coordinates to a `Point` in model coordinates.
`Vec4`	`unProject(Vec4 windowPoint, Matrix modelview, Matrix projection, java.awt.Rectangle viewport)` Maps the given window coordinates into model coordinates using the given matrices and viewport.
`protected void`	`updateModelViewStateID()` Update the modelview state identifier.

Methods inherited from class gov.nasa.worldwind.WWObjectImpl
onMessage, propertyChange

Methods inherited from class gov.nasa.worldwind.avlist.AVListImpl
addPropertyChangeListener, addPropertyChangeListener, clearList, copy, firePropertyChange, firePropertyChange, getBooleanValue, getBooleanValue, getChangeSupport, getDoubleValue, getDoubleValue, getEntries, getIntegerValue, getIntegerValue, getLongValue, getLongValue, getRestorableStateForAVPair, getStringValue, getStringValue, getStringValue, getValue, getValues, hasKey, removeKey, removePropertyChangeListener, removePropertyChangeListener, setValue, setValues

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface gov.nasa.worldwind.avlist.AVList
addPropertyChangeListener, addPropertyChangeListener, clearList, copy, firePropertyChange, firePropertyChange, getEntries, getStringValue, getValue, getValues, hasKey, removeKey, removePropertyChangeListener, removePropertyChangeListener, setValue, setValues

Methods inherited from interface java.beans.PropertyChangeListener
propertyChange

Methods inherited from interface gov.nasa.worldwind.event.MessageListener
onMessage

- Field Detail
  - COLLISION_NUM_ITERATIONS
```
protected static final int COLLISION_NUM_ITERATIONS
```
    See Also:
    
    Constant Field Values
  - COLLISION_THRESHOLD
```
protected static final double COLLISION_THRESHOLD
```
    See Also:
    
    Constant Field Values
  - dc
```
protected DrawContext dc
```
  - DEFAULT_DEPTH_RESOLUTION
```
protected static final double DEFAULT_DEPTH_RESOLUTION
```
    The views's default worst-case depth resolution, in meters. May be specified in the WorldWind configuration file as the gov.nasa.worldwind.avkey.DepthResolution property. The default if not specified in the configuration is 3.0 meters.
  - detectCollisions
```
protected boolean detectCollisions
```
  - eyePosition
```
protected Position eyePosition
```
  - farClipDistance
```
protected double farClipDistance
```
  - fieldOfView
```
protected Angle fieldOfView
```
    The field of view in degrees.
  - frustum
```
protected Frustum frustum
```
  - globe
```
protected Globe globe
```
  - hadCollisions
```
protected boolean hadCollisions
```
  - heading
```
protected Angle heading
```
  - horizonDistance
```
protected double horizonDistance
```
  - lastEyePoint
```
protected Vec4 lastEyePoint
```
  - lastEyePosition
```
protected Position lastEyePosition
```
  - lastForwardVector
```
protected Vec4 lastForwardVector
```
  - lastFrustumInModelCoords
```
protected Frustum lastFrustumInModelCoords
```
  - lastUpVector
```
protected Vec4 lastUpVector
```
  - MINIMUM_FAR_DISTANCE
```
protected static final double MINIMUM_FAR_DISTANCE
```
    See Also:
    
    Constant Field Values
  - MINIMUM_NEAR_DISTANCE
```
protected static final double MINIMUM_NEAR_DISTANCE
```
    See Also:
    
    Constant Field Values
  - modelview
```
protected Matrix modelview
```
  - modelviewInv
```
protected Matrix modelviewInv
```
  - nearClipDistance
```
protected double nearClipDistance
```
  - pitch
```
protected Angle pitch
```
  - projection
```
protected Matrix projection
```
  - roll
```
protected Angle roll
```
  - viewInputHandler
```
protected ViewInputHandler viewInputHandler
```
  - viewLimits
```
protected ViewPropertyLimits viewLimits
```
  - viewport
```
protected java.awt.Rectangle viewport
```
  - viewStateID
```
protected long viewStateID
```
    Identifier for the modelview matrix state. This number is incremented when one of the fields that affects the modelview matrix is set.
- Constructor Detail
  - BasicView
```
public BasicView()
```
    Construct a BasicView
- Method Detail
  - addAnimator
```
public void addAnimator(Animator animator)
```
    Add an animator to the this View. The View does not start the animator.
    
    Specified by:
    
    addAnimator in interface View
    
    Parameters:
    
    animator - the Animator to be added
  - apply
```
public void apply(DrawContext dc)
```
    Description copied from interface: View
    
    Calculates and applies this View's internal state to the graphics context in the specified dc. All subsequently rendered objects use this new state. Upon return, the OpenGL graphics context reflects the values of this view, as do any computed values of the view, such as the modelview matrix, projection matrix and viewing frustum.
    
    Specified by:
    
    apply in interface View
    
    Parameters:
    
    dc - the current WorldWind DrawContext on which View will apply its state.
  - computeEyePositionFromModelview
```
protected Position computeEyePositionFromModelview()
```
  - computeFarClipDistance
```
protected double computeFarClipDistance()
```
  - computeFarDistance
```
protected double computeFarDistance(Position eyePosition)
```
  - computeHorizonDistance
```
protected double computeHorizonDistance()
```
  - computeHorizonDistance
```
protected double computeHorizonDistance(Position eyePosition)
```
  - computeNearClipDistance
```
protected double computeNearClipDistance()
```
  - computeNearDistance
```
protected double computeNearDistance(Position eyePosition)
```
  - computePixelSizeAtDistance
```
public double computePixelSizeAtDistance(double distance)
```
    Description copied from interface: View
    
    Computes the dimension (in meters) that a screen pixel would cover at a given distance from the eye point (also in meters). The distance is interpreted as the linear distance between the eye point and the world point in question. This computation assumes that pixels dimensions are square, and therefore returns a single dimension.
    
    Specified by:
    
    computePixelSizeAtDistance in interface View
    
    Parameters:
    
    distance - the distance in meters from the eye point. This value must be positive but is otherwise unbounded.
    
    Returns:
    
    the dimension of a pixel in meters at the given distance.
  - computePositionFromScreenPoint
```
public Position computePositionFromScreenPoint(double x,
                                               double y)
```
    Description copied from interface: View
    
    Computes the intersection of a line originating from the eye point and passing through (x, y) with the Globe. Only the ellipsoid itself is considered; terrain elevations are not incorporated.
    
    Specified by:
    
    computePositionFromScreenPoint in interface View
    
    Parameters:
    
    x - the horizontal coordinate originating from the left side of View's projection plane.
    
    y - the vertical coordinate originating from the top of View's projection plane.
    
    Returns:
    
    the point on the surface in polar coordinates.
  - computeRayFromScreenPoint
```
public Line computeRayFromScreenPoint(double x,
                                      double y)
```
    Description copied from interface: View
    
    Computes a line, in model coordinates, originating from the eye point, and passing through the point contained by (x, y) on the View's projection plane (or after projection into model space).
    
    Specified by:
    
    computeRayFromScreenPoint in interface View
    
    Parameters:
    
    x - the horizontal coordinate originating from the left side of View's projection plane.
    
    y - the vertical coordinate originating from the top of View's projection plane.
    
    Returns:
    
    a line beginning at the View's eye point and passing through (x, y) transformed into model space.
  - copyViewState
```
public void copyViewState(View view)
```
    Description copied from interface: View
    
    Copy the state of the given View.
    
    Specified by:
    
    copyViewState in interface View
    
    Parameters:
    
    view - The View whose state is to be copied.
  - doApply
```
protected void doApply(DrawContext dc)
```
  - doGetRestorableState
```
protected void doGetRestorableState(RestorableSupport rs,
                                    RestorableSupport.StateObject context)
```
  - doRestoreState
```
protected void doRestoreState(RestorableSupport rs,
                              RestorableSupport.StateObject context)
```
  - getCenterPoint
```
public Vec4 getCenterPoint()
```
    Description copied from interface: View
    
    Gets the center point of the view.
    
    Specified by:
    
    getCenterPoint in interface View
    
    Returns:
    
    the center point of the view if that point is on the globe, otherwise, return null
  - getCenterPosition
```
public Position getCenterPosition()
```
  - getCurrentEyePoint
```
public Vec4 getCurrentEyePoint()
```
    Description copied from interface: View
    
    Returns the most up-to-date location of the eye in cartesian coordinates. Unlike View.getEyePosition() and View.getEyePoint(), getCurrentEyePoint will return the View's immediate position.
    
    Specified by:
    
    getCurrentEyePoint in interface View
    
    Returns:
    
    Vec4 of the eye.
  - getCurrentEyePosition
```
public Position getCurrentEyePosition()
```
    Description copied from interface: View
    
    Returns the current geographic coordinates of this view's eye position, as determined from this view's current parameters.
    Note: The value returned is not necessarily the value specified to View.setEyePosition(gov.nasa.worldwind.geom.Position) but is the eye position corresponding to this view's current parameters.
    
    Specified by:
    
    getCurrentEyePosition in interface View
    
    Returns:
    
    the position of the eye corresponding to the current parameters of this view.
  - getCurrentForwardVector
```
public Vec4 getCurrentForwardVector()
```
    Returns the most up-to-date forward vector. Unlike getForwardVector(), this method will return the View's immediate forward vector.
    
    Returns:
    
    Vec4 of the forward axis.
  - getDC
```
public DrawContext getDC()
```
  - getEyePoint
```
public Vec4 getEyePoint()
```
    Description copied from interface: View
    
    Returns the location of the eye in cartesian coordinates. This value is computed in the most recent call to apply.
    
    Specified by:
    
    getEyePoint in interface View
    
    Returns:
    
    Vec4 of the eye.
  - getEyePosition
```
public Position getEyePosition()
```
    Description copied from interface: View
    
    Returns the current geographic coordinates of this view's eye position, as computed for the most recent model traversal.
    Note: The value returned is not necessarily the value specified to View.setEyePosition(gov.nasa.worldwind.geom.Position) but is the eye position corresponding to this view's most recently applied state.
    
    Specified by:
    
    getEyePosition in interface View
    
    Returns:
    
    the position of the eye corresponding to the most recent application of this view, or null if the view has not yet been applied.
  - getFarClipDistance
```
public double getFarClipDistance()
```
    Description copied from interface: View
    
    Returns the far clipping plane distance, in eye coordinates. Implementations of the View interface are not required to have a method for setting the near and far distance. Applications that need to control the near and far clipping distances can derive from BasicOrbitView or BasicFlyView
    
    Specified by:
    
    getFarClipDistance in interface View
    
    Returns:
    
    far clipping plane distance, in eye coordinates.
  - getFieldOfView
```
public Angle getFieldOfView()
```
    Description copied from interface: View
    
    Returns the horizontal field-of-view angle (the angle of visibility), or null if the implementation does not support a field-of-view.
    
    Specified by:
    
    getFieldOfView in interface View
    
    Returns:
    
    Angle of the horizontal field-of-view, or null if none exists.
  - getForwardVector
```
public Vec4 getForwardVector()
```
    Description copied from interface: View
    
    Returns the forward axis in cartesian coordinates. This value is computed in the most recent call to apply.
    
    Specified by:
    
    getForwardVector in interface View
    
    Returns:
    
    Vec4 of the forward axis.
  - getFrustum
```
public Frustum getFrustum()
```
    Description copied from interface: View
    
    Returns the viewing Frustum in eye coordinates. The Frustum is the portion of viewable space defined by three sets of parallel 'clipping' planes. This value is computed in the most recent call to apply.
    
    Specified by:
    
    getFrustum in interface View
    
    Returns:
    
    viewing Frustum in eye coordinates.
  - getFrustumInModelCoordinates
```
public Frustum getFrustumInModelCoordinates()
```
    Description copied from interface: View
    
    Returns the viewing Frustum in model coordinates. Model coordinate frustums are useful for performing visibility tests against world geometry. This frustum has the same shape as the frustum returned in getFrustum, but it has been transformed into model space. This value is computed in the most recent call to apply.
    
    Specified by:
    
    getFrustumInModelCoordinates in interface View
    
    Returns:
    
    viewing Frustum in model coordinates.
  - getGlobe
```
public Globe getGlobe()
```
    Description copied from interface: View
    
    Gets the globe associated with this view. The Globe is updated at the beginning of each frame, during View.apply(). View.getGlobe() returns null if called before the first invocation of View.apply().
    
    Specified by:
    
    getGlobe in interface View
    
    Returns:
    
    the globe being rendered by this view, or null before the first invocation of View.apply().
  - getHeading
```
public Angle getHeading()
```
    Description copied from interface: View
    
    Returns the view's current heading.
    
    Specified by:
    
    getHeading in interface View
    
    Returns:
    
    Angle of the view's heading.
  - getHorizonDistance
```
public double getHorizonDistance()
```
    Description copied from interface: View
    
    Returns the horizon distance for this view's most recently used eye position. The eye position changes when this view changes, so the horizon distance also changes when this view changes. The value returned is the value used during the most recent model traversal.
    
    Specified by:
    
    getHorizonDistance in interface View
    
    Returns:
    
    the horizon position, in meters, or 0 if this view has not yet been applied.
  - getModelviewMatrix
```
public Matrix getModelviewMatrix()
```
    Description copied from interface: View
    
    Returns the modelview matrix. The modelview matrix transforms model coordinates to eye coordinates. This matrix is constructed using the model space translation and orientation specific to each the implementation. This value is computed in the most recent call to apply.
    
    Specified by:
    
    getModelviewMatrix in interface View
    
    Returns:
    
    the current model-view matrix.
  - getNearClipDistance
```
public double getNearClipDistance()
```
    Description copied from interface: View
    
    Returns the near clipping plane distance, in eye coordinates. Implementations of the View interface are not required to have a method for setting the near and far distance. Applications that need to control the near and far clipping distances can derive from BasicOrbitView or BasicFlyView
    
    Specified by:
    
    getNearClipDistance in interface View
    
    Returns:
    
    near clipping plane distance, in eye coordinates.
  - getPitch
```
public Angle getPitch()
```
    Description copied from interface: View
    
    Returns the view's current pitch.
    
    Specified by:
    
    getPitch in interface View
    
    Returns:
    
    Angle of the view's pitch.
  - getProjectionMatrix
```
public Matrix getProjectionMatrix()
```
    Description copied from interface: View
    
    Gets the projection matrix. The projection matrix transforms eye coordinates to screen coordinates. This matrix is constructed using the projection parameters specific to each implementation of View. The method View.getFrustum() returns the geometry corresponding to this matrix. This value is computed in the most recent call to apply.
    
    Specified by:
    
    getProjectionMatrix in interface View
    
    Returns:
    
    the current projection matrix.
  - getRestorableState
```
public java.lang.String getRestorableState()
```
    Description copied from interface: Restorable
    
    Returns an XML document string describing the object's state. This state can be restored later by calling restoreState and passing the XML document.
    
    Specified by:
    
    getRestorableState in interface Restorable
    
    Returns:
    
    an XML document string describing the object's state.
  - getRoll
```
public Angle getRoll()
```
    Description copied from interface: View
    
    Returns this View's current roll.
    
    Specified by:
    
    getRoll in interface View
    
    Returns:
    
    Angle of the view's roll.
  - getUpVector
```
public Vec4 getUpVector()
```
    Description copied from interface: View
    
    Returns the up axis in cartesian coordinates. This value is computed in the most recent call to apply.
    
    Specified by:
    
    getUpVector in interface View
    
    Returns:
    
    Vec4 of the up axis.
  - getViewInputHandler
```
public ViewInputHandler getViewInputHandler()
```
    Description copied from interface: View
    
    Gets the ViewInputHandler being used to map input events to View controls.
    
    Specified by:
    
    getViewInputHandler in interface View
    
    Returns:
    
    the ViewInputHandler being used to map input events to View controls.
  - getViewport
```
public java.awt.Rectangle getViewport()
```
    Description copied from interface: View
    
    Returns the bounds (x, y, width, height) of the viewport. The implementation will configure itself to render in this viewport. This value is computed in the most recent call to apply.
    
    Specified by:
    
    getViewport in interface View
    
    Returns:
    
    the Rectangle of the viewport.
  - getViewPropertyLimits
```
public ViewPropertyLimits getViewPropertyLimits()
```
    Description copied from interface: View
    
    Get the ViewPropertyLimits for this view.
    
    Specified by:
    
    getViewPropertyLimits in interface View
    
    Returns:
    
    the ViewPropertyLimits for this view.
  - getViewStateID
```
public long getViewStateID()
```
    Get an identifier for the current state of the modelview matrix. The modelview matrix transforms model coordinates to eye coordinates. This identifier can be used to determine if the view has changed state since a previous frame.
    
    Specified by:
    
    getViewStateID in interface View
    
    Returns:
    
    an identifier for the current modelview matrix state.
  - goTo
```
public void goTo(Position position,
                 double distance)
```
    Description copied from interface: View
    
    Animate to the specified position. The implementation is expected to animate the View to look at the given position from the given elevation.
    
    Specified by:
    
    goTo in interface View
    
    Parameters:
    
    position - The position to animate to.
    
    distance - The elevation to look at the position from.
  - hadCollisions
```
public boolean hadCollisions()
```
  - isAnimating
```
public boolean isAnimating()
```
    Description copied from interface: View
    
    Determine if there are any animations active in the View.
    
    Specified by:
    
    isAnimating in interface View
    
    Returns:
    
    true if there are active animations, false otherwise.
  - isDetectCollisions
```
public boolean isDetectCollisions()
```
  - loadGLViewState
```
public static void loadGLViewState(DrawContext dc,
                                   Matrix modelview,
                                   Matrix projection)
```
    Sets the the opengl modelview and projection matrices to the given matrices.
    
    Parameters:
    
    dc - the drawing context
    
    modelview - the modelview matrix
    
    projection - the projection matrix
  - popReferenceCenter
```
public void popReferenceCenter(DrawContext dc)
```
    Removes the model-view matrix on top of the matrix stack, and restores the original matrix.
    
    Specified by:
    
    popReferenceCenter in interface View
    
    Parameters:
    
    dc - the current WorldWind drawing context on which the original matrix will be restored.
    
    Throws:
    
    java.lang.IllegalArgumentException - if dc is null, or if the Globe or GL instances in dc are null.
  - project
```
public Vec4 project(Vec4 modelPoint)
```
    Description copied from interface: View
    
    Maps a Point in model (cartesian) coordinates to a Point in screen coordinates. The returned x and y are relative to the lower left hand screen corner, while z is the screen depth-coordinate. If the model point cannot be successfully mapped, this will return null.
    
    Specified by:
    
    project in interface View
    
    Parameters:
    
    modelPoint - the model coordinate Point to project.
    
    Returns:
    
    the mapped screen coordinate Point.
  - project
```
public Vec4 project(Vec4 point,
                    Matrix modelview,
                    Matrix projection,
                    java.awt.Rectangle viewport)
```
    Transforms the specified object coordinates into window coordinates using the given modelview and projection matrices, and viewport.
    
    Parameters:
    
    point - The object coordinate to transform
    
    modelview - The modelview matrix
    
    projection - The projection matrix
    
    viewport - The viewport
    
    Returns:
    
    the transformed coordinates
  - pushReferenceCenter
```
public Matrix pushReferenceCenter(DrawContext dc,
                                  Vec4 referenceCenter)
```
    Description copied from interface: View
    
    Defines and applies a new model-view matrix in which the world origin is located at referenceCenter. Geometry rendered after a call to pushReferenceCenter should be transformed with respect to referenceCenter, rather than the canonical origin (0, 0, 0). Calls to pushReferenceCenter must be followed by popReferenceCenter after rendering is complete. Note that calls to View.getModelviewMatrix() will not return reference-center model-view matrix, but the original matrix.
    
    Specified by:
    
    pushReferenceCenter in interface View
    
    Parameters:
    
    dc - the current WorldWind drawing context on which new model-view state will be applied.
    
    referenceCenter - the location to become the new world origin.
    
    Returns:
    
    a new model-view matrix with origin is at referenceCenter, or null if this method failed.
  - restoreState
```
public void restoreState(java.lang.String stateInXml)
```
    Description copied from interface: Restorable
    
    Restores the object's state to what is described in the specified XML document string.
    
    Specified by:
    
    restoreState in interface Restorable
    
    Parameters:
    
    stateInXml - an XML document string describing an object's state.
  - setDetectCollisions
```
public void setDetectCollisions(boolean detectCollisions)
```
  - setEyePosition
```
public void setEyePosition(Position eyePosition)
```
    Description copied from interface: View
    
    Sets the geographic position of the eye.
    
    Specified by:
    
    setEyePosition in interface View
    
    Parameters:
    
    eyePosition - the eye position.
  - setFarClipDistance
```
protected void setFarClipDistance(double clipDistance)
```
  - setFieldOfView
```
public void setFieldOfView(Angle fieldOfView)
```
    Description copied from interface: View
    
    Sets the horizontal field-of-view angle (the angle of visibility) to the specified fieldOfView. This may be ignored if the implementation that do not support a field-of-view.
    
    Specified by:
    
    setFieldOfView in interface View
    
    Parameters:
    
    fieldOfView - the horizontal field-of-view angle.
  - setGlobe
```
public void setGlobe(Globe globe)
```
    Set the globe associated with this view. Note that the globe is reset each frame.
    
    Parameters:
    
    globe - New globe.
  - setHeading
```
public void setHeading(Angle heading)
```
    Description copied from interface: View
    
    Sets the heading of the view. The implementation may interpret this command in whatever way it chooses.
    
    Specified by:
    
    setHeading in interface View
    
    Parameters:
    
    heading - The direction to aim the view in degrees
  - setNearClipDistance
```
protected void setNearClipDistance(double clipDistance)
```
  - setOrientation
```
public void setOrientation(Position eyePosition,
                           Position centerPosition)
```
    Description copied from interface: View
    
    Sets the location of the eye, and the center of the screen in geographic coordinates. The implementation may interpret this command in whatever way it chooses, so long as the eye is placed at the specified eyePosition, and the center of the screen is the specified centerPosition. Specifically, implementations must determine what the up direction will be given these parameters, and apply these parameters in a meaningful way.
    
    Specified by:
    
    setOrientation in interface View
    
    Parameters:
    
    eyePosition - Position of they eye.
    
    centerPosition - Position of the screen center.
  - setPitch
```
public void setPitch(Angle pitch)
```
    Description copied from interface: View
    
    Sets the pitch of the view. The implementation may interpret pitch as it chooses
    
    Specified by:
    
    setPitch in interface View
    
    Parameters:
    
    pitch - The pitch of the view.
  - setReferenceCenter
```
public Matrix setReferenceCenter(DrawContext dc,
                                 Vec4 referenceCenter)
```
    Description copied from interface: View
    
    Sets the reference center matrix without pushing the stack.
    
    Specified by:
    
    setReferenceCenter in interface View
    
    Parameters:
    
    dc - the drawing context.
    
    referenceCenter - the new reference center
    
    Returns:
    
    a new model-view matrix with origin is at referenceCenter, or null if this method failed.
    
    See Also:
    
    View.pushReferenceCenter(gov.nasa.worldwind.render.DrawContext, gov.nasa.worldwind.geom.Vec4)
  - setRoll
```
public void setRoll(Angle roll)
```
    Description copied from interface: View
    
    Set the roll of the view. The implementation may interpret roll as it chooses.
    
    Specified by:
    
    setRoll in interface View
    
    Parameters:
    
    roll - New roll. May not be null.
  - setViewInputHandler
```
public void setViewInputHandler(ViewInputHandler viewInputHandler)
```
  - setViewState
```
protected void setViewState(ViewUtil.ViewState modelCoords)
```
  - stopAnimations
```
public void stopAnimations()
```
    Description copied from interface: View
    
    Stops any animations that are active in this View
    
    Specified by:
    
    stopAnimations in interface View
  - stopMovement
```
public void stopMovement()
```
    Description copied from interface: View
    
    Stops any movement associated with this View.
    
    Specified by:
    
    stopMovement in interface View
  - unProject
```
public Vec4 unProject(Vec4 windowPoint)
```
    Description copied from interface: View
    
    Maps a Point in screen coordinates to a Point in model coordinates. The input x and y are relative to the lower left hand screen corner, while z is the screen depth-coordinate. If the screen point cannot be successfully mapped, this will return null.
    
    Specified by:
    
    unProject in interface View
    
    Parameters:
    
    windowPoint - the window coordinate Point to project.
    
    Returns:
    
    the mapped screen coordinate Point.
  - unProject
```
public Vec4 unProject(Vec4 windowPoint,
                      Matrix modelview,
                      Matrix projection,
                      java.awt.Rectangle viewport)
```
    Maps the given window coordinates into model coordinates using the given matrices and viewport.
    
    Parameters:
    
    windowPoint - the window point
    
    modelview - the modelview matrix
    
    projection - the projection matrix
    
    viewport - the window viewport
    
    Returns:
    
    the unprojected point
  - updateModelViewStateID
```
protected void updateModelViewStateID()
```
    Update the modelview state identifier. This method should be called whenever one of the fields that affects the modelview matrix is changed.

Class BasicView

Field Summary

Fields inherited from interface gov.nasa.worldwind.View

Constructor Summary

Method Summary

Methods inherited from class gov.nasa.worldwind.WWObjectImpl

Methods inherited from class gov.nasa.worldwind.avlist.AVListImpl

Methods inherited from class java.lang.Object

Methods inherited from interface gov.nasa.worldwind.avlist.AVList

Methods inherited from interface java.beans.PropertyChangeListener

Methods inherited from interface gov.nasa.worldwind.event.MessageListener

Field Detail

COLLISION_NUM_ITERATIONS

COLLISION_THRESHOLD

dc

DEFAULT_DEPTH_RESOLUTION

detectCollisions

eyePosition

farClipDistance

fieldOfView

frustum

globe

hadCollisions

heading

horizonDistance

lastEyePoint

lastEyePosition

lastForwardVector

lastFrustumInModelCoords

lastUpVector

MINIMUM_FAR_DISTANCE

MINIMUM_NEAR_DISTANCE

modelview

modelviewInv

nearClipDistance

pitch

projection

roll

viewInputHandler

viewLimits

viewport

viewStateID

Constructor Detail

BasicView

Method Detail

addAnimator

apply

computeEyePositionFromModelview

computeFarClipDistance

computeFarDistance

computeHorizonDistance

computeHorizonDistance

computeNearClipDistance

computeNearDistance

computePixelSizeAtDistance

computePositionFromScreenPoint

computeRayFromScreenPoint

copyViewState

doApply

doGetRestorableState

doRestoreState

getCenterPoint

getCenterPosition

getCurrentEyePoint

getCurrentEyePosition

getCurrentForwardVector

getDC

getEyePoint

getEyePosition

getFarClipDistance

getFieldOfView

getForwardVector

getFrustum

getFrustumInModelCoordinates

getGlobe

getHeading

getHorizonDistance

getModelviewMatrix

getNearClipDistance

getPitch