ucar.unidata.view.geoloc

Class GlobeDisplay

java.lang.Object

ucar.visad.display.DisplayMaster

ucar.unidata.view.geoloc.NavigatedDisplay

ucar.unidata.view.geoloc.GlobeDisplay

public class GlobeDisplay
extends NavigatedDisplay

Provides a navigated globe for displaying geolocated data. Any displayable data must be able to map to RealType.Latitude, RealType.Longitude and/or RealType.Altitude.

Version:

$Revision: 1.49 $ $Date: 2007/07/31 15:11:25 $

Author:

Don Murray

Nested Class Summary

Nested classes/interfaces inherited from class ucar.unidata.view.geoloc.NavigatedDisplay

NavigatedDisplay.VerticalMapSet

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	BOTTOM_VIEW_NAME Bottom View name
static double	EARTH_RADIUS Earth Radius (m)
static java.lang.String	EAST_VIEW_NAME East View name
static java.lang.String	NORTH_VIEW_NAME North View name
static java.lang.String	SOUTH_VIEW_NAME South View name
static java.lang.String	TOP_VIEW_NAME Top View name
static java.lang.String	WEST_VIEW_NAME West View name

Fields inherited from class ucar.unidata.view.geoloc.NavigatedDisplay

BOTTOM_VIEW, CLIP_BACK_DEFAULT, CLIP_BACK_PERSPECTIVE, CLIP_FRONT_DEFAULT, CLIP_FRONT_PERSPECTIVE, CURSOR_ALTITUDE, CURSOR_LATITUDE, CURSOR_LONGITUDE, defaultClipDistanceBack, defaultClipDistanceFront, EAST_VIEW, MODE_2D, MODE_2Din3D, MODE_3D, NORTH_VIEW, SOUTH_VIEW, TOP_VIEW, WEST_VIEW

Fields inherited from class ucar.visad.display.DisplayMaster

behavior, defaultMouseFunctions, log_, POINT_MODE

Constructor Summary

Constructors

Constructor and Description
GlobeDisplay() Constructs a new GlobeDisplay.
GlobeDisplay(boolean offscreen, java.awt.Dimension dimension, java.awt.GraphicsDevice screen) Constructs a new GlobeDisplay.

Method Summary

Modifier and Type	Method and Description
void	addKeyboardBehavior(visad.KeyboardBehavior behavior) Add a keyboard behavior for this display
void	addVerticalMap(visad.RealType newVertType) Add a new mapping of this type to the vertical coordinate
void	centerAndZoom(visad.georef.EarthLocation el, visad.Real altitude, double zoomFactor, boolean animated, boolean northUp) Center and zoom to a particular point
void	checkClipDistance() If we are in perspective view then set the clip distance shorter
protected void	cursorChange() Handles a change to the cursor position.
protected void	cursorMoved() Handles a change to the cursor position.
void	enableClipping(boolean clip) Enable clipping of data at the box edges
protected visad.ScalarMap	getAltitudeMap() Accessor method for the ScalarMap for Altitude
java.lang.String	getBottomViewName() Accessor method.
visad.DisplayRealType	getDisplayAltitudeType() Accessor method for the DisplayAltitudeType
visad.CoordinateSystem	getDisplayCoordinateSystem() Get the display coordinate system that turns lat/lon/alt to x/y/z
visad.DisplayRealType	getDisplayLatitudeType() Accessor method for the DisplayLatitudeType
visad.DisplayRealType	getDisplayLongitudeType() Accessor method for the DisplayLongitudeType
visad.DisplayTupleType	getDisplayTupleType() Accessor method for the DisplayTupleType.
visad.georef.EarthLocation	getEarthLocation(double x, double y, double z, boolean setZToZeroIfOverhead) Get the EarthLocation of a point in XYZ space
java.lang.String	getEastViewName() Accessor method.
java.awt.geom.Rectangle2D.Double	getLatLonBox() Get the latlon box of the displayed area.
java.lang.String	getNorthViewName() Accessor method.
java.lang.String	getSouthViewName() Accessor method.
visad.RealTuple	getSpatialCoordinates(visad.georef.EarthLocation el) Returns the spatial (XYZ) coordinates of the particular EarthLocation
double[]	getSpatialCoordinates(visad.georef.EarthLocation el, double[] xyz, double altitude) Returns the spatial (XYZ) coordinates of the particular EarthLocation
double[]	getSpatialCoordinatesFromScreen(int x, int y, double zDepth) Get spatial coordinates from screen
boolean	getStereoAvailable() Determine if this MapDisplay can do stereo.
java.lang.String	getTopViewName() Accessor method.
javax.media.j3d.View	getView() Get the View
visad.georef.EarthLocation	getViewPointEarthLocation() Get the viewpoint earth location
java.lang.String	getWestViewName() Accessor method.
protected void	initializeClass() Initialize the class.
static void	main(java.lang.String[] args) test by running java ucar.unidata.view.geoloc.NavigatedDisplay
protected void	pointerMoved(int x, int y) Handles a change in the position of the mouse-pointer.
void	removeVerticalMap(visad.RealType vertType) Remove a new mapping of this type to the vertical coordinate
void	resetClipDistance(double scale) Zoom in on the display
void	resetScaleTranslate() Reset the scale translate
visad.georef.EarthLocation	screenToEarthLocation(int x, int y) Get the earth coordinates from the screen coordinates
void	setClipDistanceFront(double value) Set the front clip distance
void	setEyePosition(double position) Method for setting the eye position for a 3D stereo view.
void	setMapArea(ucar.unidata.geoloc.ProjectionRect mapArea) Set the map area to be displayed in the box.
void	setMapProjection(visad.georef.MapProjection mapProjection) Define the map projection using a MapProjection type CoordinateSystem.
void	setPerspectiveView(boolean perspectiveView) Set the view to perspective or parallel if this is a 3D display.
void	setVerticalRange(double min, double max) Set the range of the vertical coordinate
void	setVerticalRangeUnit(visad.Unit newUnit) Set the Unit of the vertical range
void	setView(int view) Set the view for 3D.

Methods inherited from class ucar.unidata.view.geoloc.NavigatedDisplay

animateMatrix, animateMatrix, animateMatrix, animateMatrix, applyRotation, center, center, center, center, centerAndZoom, destroy, enableRubberBanding, getAnimationStringOn, getAutoRotate, getBoxVisible, getCenterPoint, getClipDistanceBack, getClipDistanceFront, getCursorAltitude, getCursorLatitude, getCursorLongitude, getDisplayMode, getEarthLocation, getEarthLocation, getEarthLocation, getIsAnimating, getLatLonBox, getLatLonRect, getNavigationToolBar, getNavigationToolBar, getRay, getRayDirection, getRayPositionAtZ, getRotation, getRubberBandBox, getScaledValue, getScalesVisible, getScreenCenter, getScreenCenterBottom, getScreenCenterLeft, getScreenCenterRight, getScreenCenterTop, getScreenCoordinates, getScreenCoordinates, getScreenLowerLeft, getScreenLowerRight, getScreenSidesCoordinates, getScreenUpperLeft, getScreenUpperRight, getSpatialCoordinates, getSpatialCoordinatesFromScreen, getVerticalRange, getVerticalRangeUnit, getVerticalRangeVisible, getVisadBox, init, isClippingEnabled, isPerspectiveView, moveToScreen, moveToScreen, moveToScreen, rotateFaster, rotateSlower, rotateView, rotateView, setAnimationStringOn, setAutoRotate, setBoxVisible, setClipDistanceBack, setCursorAltitude, setCursorLatitude, setCursorLongitude, setCursorStringOn, setForeground, setMapProjection, setPolygonOffset, setPolygonOffsetFactor, setRotateDelay, setRotationMultiplierMatrix, setRubberBandBox, setScalesVisible, setVerticalMapUnit, setVerticalRangeVisible, setView, updateLocation

Methods inherited from class ucar.visad.display.DisplayMaster

addDisplayable, addDisplayListener, addPropertyChangeListener, addPropertyChangeListener, addScalarMap, addScalarMaps, addVetoableChangeListener, addVetoableChangeListener, buildAnimationSet, dataChange, draw, ensureInactive, equals, finalize, firePropertyChange, firePropertyChange, getAnimationSetFromDisplayables, getAnimationStringVisible, getBackground, getComponent, getDestroyed, getDisplay, getDisplayableCount, getDisplayables, getDisplayables, getDisplayAspect, getDisplayComponent, getDisplayScale, getForeground, getImage, getMouseBehavior, getMouseFunctionMap, getOffscreenDimension, getProjectionMatrix, getSavedProjectionMatrix, getScale, getScreenBounds, getWaitMessageVisible, handleMouseWheelMoved, hashCode, indexOf, init, is3D, isActive, isPointMode, printMatrix, printMe, rebuild, rebuildDisplay, reDisplayAll, removeDisplayable, removeDisplayables, removePropertyChangeListener, removePropertyChangeListener, removeScalarMap, removeScalarMaps, removeVetoableChangeListener, removeVetoableChangeListener, replaceScalarMap, reScale, resetMouseFunctions, resetProjection, rotate, rotateX, rotateY, rotateZ, saveCurrentDisplay, saveCurrentDisplay, saveCurrentDisplay, saveProjection, setActive, setAnimation, setAnimationStringVisible, setBackground, setDefaultMouseFunctions, setDisplayables, setDisplayables, setDisplayActive, setDisplayAspect, setDisplayInactive, setKeyboardBehavior, setKeyboardEventMap, setKeyboardEventMap, setMouseFunctions, setOffscreenDimension, setPointMode, setProjectionMatrix, setRebuildNecessary, setWaitMessageVisible, setWheelEventMap, translate, zoom, zoom

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

BOTTOM_VIEW_NAME

public static java.lang.String BOTTOM_VIEW_NAME

Bottom View name

NORTH_VIEW_NAME

public static java.lang.String NORTH_VIEW_NAME

North View name

EAST_VIEW_NAME

public static java.lang.String EAST_VIEW_NAME

East View name

TOP_VIEW_NAME

public static java.lang.String TOP_VIEW_NAME

Top View name

SOUTH_VIEW_NAME

public static java.lang.String SOUTH_VIEW_NAME

South View name

WEST_VIEW_NAME

public static java.lang.String WEST_VIEW_NAME

West View name

EARTH_RADIUS

public static final double EARTH_RADIUS

Earth Radius (m)

See Also:

Constant Field Values

Constructor Detail

GlobeDisplay

public GlobeDisplay()
             throws visad.VisADException,
                    java.rmi.RemoteException

Constructs a new GlobeDisplay.

Throws:

visad.VisADException - Couldn't create necessary VisAD object

java.rmi.RemoteException - Couldn't create a remote object

GlobeDisplay

public GlobeDisplay(boolean offscreen,
                    java.awt.Dimension dimension,
                    java.awt.GraphicsDevice screen)
             throws visad.VisADException,
                    java.rmi.RemoteException

Constructs a new GlobeDisplay.

Parameters:

offscreen - true for an offscreen display

dimension - size of the display

screen - screen device

Throws:

visad.VisADException - Couldn't create necessary VisAD object

java.rmi.RemoteException - Couldn't create a remote object

Method Detail

initializeClass

protected void initializeClass()
                        throws visad.VisADException,
                               java.rmi.RemoteException

Initialize the class.

Overrides:

initializeClass in class NavigatedDisplay

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - VisAD problem

getTopViewName

public java.lang.String getTopViewName()

Accessor method.

Overrides:

getTopViewName in class NavigatedDisplay

Returns:

name for this view

getBottomViewName

public java.lang.String getBottomViewName()

Accessor method.

Overrides:

getBottomViewName in class NavigatedDisplay

Returns:

name for this view

getNorthViewName

public java.lang.String getNorthViewName()

Accessor method.

Overrides:

getNorthViewName in class NavigatedDisplay

Returns:

name for this view

getEastViewName

public java.lang.String getEastViewName()

Accessor method.

Overrides:

getEastViewName in class NavigatedDisplay

Returns:

name for this view

getSouthViewName

public java.lang.String getSouthViewName()

Accessor method.

Overrides:

getSouthViewName in class NavigatedDisplay

Returns:

name for this view

getWestViewName

public java.lang.String getWestViewName()

Accessor method.

Overrides:

getWestViewName in class NavigatedDisplay

Returns:

name for this view

addKeyboardBehavior

public void addKeyboardBehavior(visad.KeyboardBehavior behavior)

Add a keyboard behavior for this display

Overrides:

addKeyboardBehavior in class DisplayMaster

Parameters:

behavior - behavior to add

cursorMoved

protected void cursorMoved()
                    throws visad.VisADException,
                           java.rmi.RemoteException

Handles a change to the cursor position.

Overrides:

cursorMoved in class NavigatedDisplay

Throws:

visad.VisADException - VisAD failure.

java.rmi.RemoteException - Java RMI failure.

screenToEarthLocation

public visad.georef.EarthLocation screenToEarthLocation(int x,
                                                        int y)
                                                 throws visad.VisADException

Get the earth coordinates from the screen coordinates

Overrides:

screenToEarthLocation in class NavigatedDisplay

Parameters:

x - screen x position

y - screen y position

Returns:

corresponding earth location

Throws:

visad.VisADException - problem getting coordinates

pointerMoved

protected void pointerMoved(int x,
                            int y)
                     throws visad.UnitException,
                            visad.VisADException,
                            java.rmi.RemoteException

Handles a change in the position of the mouse-pointer. For this implementation, it will only list the

Overrides:

pointerMoved in class NavigatedDisplay

Parameters:

x - x mouse location

y - y mouse location

Throws:

java.rmi.RemoteException - Java RMI problem

visad.UnitException - Unit conversion problem

visad.VisADException - VisAD problem

resetClipDistance

public void resetClipDistance(double scale)

Zoom in on the display

Overrides:

resetClipDistance in class NavigatedDisplay

Parameters:

scale - x zoom factor ( > 1 = zoom in, 1 > zoom > 0 = zoom out). using 2.0 and .5 seems to work well.

setMapArea

public void setMapArea(ucar.unidata.geoloc.ProjectionRect mapArea)
                throws visad.VisADException,
                       java.rmi.RemoteException

Set the map area to be displayed in the box. Does nothing at this point.

Overrides:

setMapArea in class NavigatedDisplay

Parameters:

mapArea - ProjectionRect describing the map area to be displayed

Throws:

visad.VisADException - invalid navigation or VisAD error

java.rmi.RemoteException - Couldn't create a remote object

setMapProjection

public void setMapProjection(visad.georef.MapProjection mapProjection)
                      throws visad.VisADException,
                             java.rmi.RemoteException

Define the map projection using a MapProjection type CoordinateSystem. Implementation will be subclass dependent.

Specified by:

setMapProjection in class NavigatedDisplay

Parameters:

mapProjection - map projection coordinate system

Throws:

visad.VisADException - Couldn't create necessary VisAD object

java.rmi.RemoteException - Couldn't create a remote object

getDisplayLatitudeType

public visad.DisplayRealType getDisplayLatitudeType()

Accessor method for the DisplayLatitudeType

Specified by:

getDisplayLatitudeType in class NavigatedDisplay

Returns:

DisplayRealType for Latitude mapping

getDisplayLongitudeType

public visad.DisplayRealType getDisplayLongitudeType()

Accessor method for the DisplayLongitudeType

Specified by:

getDisplayLongitudeType in class NavigatedDisplay

Returns:

DisplayRealType for Longitude mapping

getDisplayAltitudeType

public visad.DisplayRealType getDisplayAltitudeType()

Accessor method for the DisplayAltitudeType

Specified by:

getDisplayAltitudeType in class NavigatedDisplay

Returns:

DisplayRealType for Altitude mapping

getDisplayTupleType

public visad.DisplayTupleType getDisplayTupleType()

Accessor method for the DisplayTupleType.

Returns:

the tuple of DisplayRealTypes

getAltitudeMap

protected visad.ScalarMap getAltitudeMap()

Accessor method for the ScalarMap for Altitude

Specified by:

getAltitudeMap in class NavigatedDisplay

Returns:

the altitude ScalarMap

cursorChange

protected void cursorChange()
                     throws visad.VisADException,
                            java.rmi.RemoteException

Handles a change to the cursor position.

Throws:

visad.VisADException - VisAD failure.

java.rmi.RemoteException - Java RMI failure.

resetScaleTranslate

public void resetScaleTranslate()
                         throws visad.VisADException,
                                java.rmi.RemoteException

Reset the scale translate

Overrides:

resetScaleTranslate in class NavigatedDisplay

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - matrix problem

setView

public void setView(int view)

Set the view for 3D. The views are based on the original display as follows:

                        NORTH
                      _________
                    W |       | E
                    E |  TOP  | A
                    S | MOTTOB| S
                    T |_______| T
                        SOUTH
 

Specified by:

setView in class NavigatedDisplay

Parameters:

view - one of the static view fields (NORTH_VIEW, SOUTH_VIEW, .. etc). In this display, NORTH is the Western Hemisphere, SOUTH is the Eastern Hemisphere, EAST is the Pacific region and WEST is the Atlantic Region

enableClipping

public void enableClipping(boolean clip)

Enable clipping of data at the box edges

Overrides:

enableClipping in class NavigatedDisplay

Parameters:

clip - true to turn clipping on, otherwise off

getView

public javax.media.j3d.View getView()

Get the View

Overrides:

getView in class NavigatedDisplay

Returns:

the View

setPerspectiveView

public void setPerspectiveView(boolean perspectiveView)

Set the view to perspective or parallel if this is a 3D display.

Overrides:

setPerspectiveView in class NavigatedDisplay

Parameters:

perspectiveView - true for perspective view

getEarthLocation

public visad.georef.EarthLocation getEarthLocation(double x,
                                                   double y,
                                                   double z,
                                                   boolean setZToZeroIfOverhead)

Get the EarthLocation of a point in XYZ space

Specified by:

getEarthLocation in class NavigatedDisplay

Parameters:

x - x coord.

y - y coord.

z - z coord.

setZToZeroIfOverhead - If in the overhead view then set Z to 0

Returns:

point in lat/lon/alt space.

centerAndZoom

public void centerAndZoom(visad.georef.EarthLocation el,
                          visad.Real altitude,
                          double zoomFactor,
                          boolean animated,
                          boolean northUp)
                   throws visad.VisADException,
                          java.rmi.RemoteException

Center and zoom to a particular point

Overrides:

centerAndZoom in class NavigatedDisplay

Parameters:

el - the earth location

altitude - the altitude

zoomFactor - zoom factor

animated - true to animate

northUp - rotate so north is up

Throws:

java.rmi.RemoteException - Couldn't create a remote object

visad.VisADException - Couldn't create necessary VisAD object

getSpatialCoordinatesFromScreen

public double[] getSpatialCoordinatesFromScreen(int x,
                                                int y,
                                                double zDepth)

Get spatial coordinates from screen

Overrides:

getSpatialCoordinatesFromScreen in class NavigatedDisplay

Parameters:

x - screen X

y - screen Y

zDepth - the z depth

Returns:

the coordinates

getSpatialCoordinates

public visad.RealTuple getSpatialCoordinates(visad.georef.EarthLocation el)

Returns the spatial (XYZ) coordinates of the particular EarthLocation

Specified by:

getSpatialCoordinates in class NavigatedDisplay

Parameters:

el - earth location (lat/lon/alt) to translate

Returns:

RealTuple of display coordinates.

getSpatialCoordinates

public double[] getSpatialCoordinates(visad.georef.EarthLocation el,
                                      double[] xyz,
                                      double altitude)
                               throws visad.VisADException,
                                      java.rmi.RemoteException

Returns the spatial (XYZ) coordinates of the particular EarthLocation

Specified by:

getSpatialCoordinates in class NavigatedDisplay

Parameters:

el - earth location (lat/lon/alt) to translate

xyz - Where to put the value

altitude - the altitude

Returns:

The xyz array

Throws:

java.rmi.RemoteException - On badness

visad.VisADException - On badness

addVerticalMap

public void addVerticalMap(visad.RealType newVertType)
                    throws visad.VisADException,
                           java.rmi.RemoteException

Add a new mapping of this type to the vertical coordinate

Overrides:

addVerticalMap in class NavigatedDisplay

Parameters:

newVertType - RealType of map

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - VisAD problem

removeVerticalMap

public void removeVerticalMap(visad.RealType vertType)
                       throws visad.VisADException,
                              java.rmi.RemoteException

Remove a new mapping of this type to the vertical coordinate

Overrides:

removeVerticalMap in class NavigatedDisplay

Parameters:

vertType - RealType of map

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - VisAD problem

setVerticalRangeUnit

public void setVerticalRangeUnit(visad.Unit newUnit)
                          throws visad.VisADException,
                                 java.rmi.RemoteException

Set the Unit of the vertical range

Overrides:

setVerticalRangeUnit in class NavigatedDisplay

Parameters:

newUnit - unit of range

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - VisAD problem

setVerticalRange

public void setVerticalRange(double min,
                             double max)
                      throws visad.VisADException,
                             java.rmi.RemoteException

Set the range of the vertical coordinate

Overrides:

setVerticalRange in class NavigatedDisplay

Parameters:

min - minimum value for vertical axis

max - maximum value for vertical axis

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - VisAD problem

getStereoAvailable

public boolean getStereoAvailable()

Determine if this MapDisplay can do stereo.

Overrides:

getStereoAvailable in class DisplayMaster

Returns:

true if the graphics device can do stereo

setEyePosition

public void setEyePosition(double position)

Method for setting the eye position for a 3D stereo view.

Overrides:

setEyePosition in class DisplayMaster

Parameters:

position - x position of each eye (left negative, right positive).

getLatLonBox

public java.awt.geom.Rectangle2D.Double getLatLonBox()
                                              throws visad.VisADException,
                                                     java.rmi.RemoteException

Get the latlon box of the displayed area. This checks to see if the globe is sort of fully zoomed out. If it is then it returns an earth spanning bbox

Overrides:

getLatLonBox in class NavigatedDisplay

Returns:

lat lon box or null if it can't be determined

Throws:

java.rmi.RemoteException - On badness

visad.VisADException - On badness

getDisplayCoordinateSystem

public visad.CoordinateSystem getDisplayCoordinateSystem()

Get the display coordinate system that turns lat/lon/alt to x/y/z

Overrides:

getDisplayCoordinateSystem in class NavigatedDisplay

Returns:

the coordinate system (may be null)

getViewPointEarthLocation

public visad.georef.EarthLocation getViewPointEarthLocation()

Get the viewpoint earth location

Returns:

the location

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception

test by running java ucar.unidata.view.geoloc.NavigatedDisplay

Parameters:

args - not used

Throws:

java.lang.Exception - problem creating the display

setClipDistanceFront

public void setClipDistanceFront(double value)

Set the front clip distance

Overrides:

setClipDistanceFront in class NavigatedDisplay

Parameters:

value - clip distance

checkClipDistance

public void checkClipDistance()

If we are in perspective view then set the clip distance shorter