ucar.unidata.view.geoloc

Class MapProjectionDisplay

java.lang.Object

ucar.visad.display.DisplayMaster

ucar.unidata.view.geoloc.NavigatedDisplay

ucar.unidata.view.geoloc.MapProjectionDisplay

Direct Known Subclasses:

MapProjectionDisplayJ2D, MapProjectionDisplayJ3D

public abstract class MapProjectionDisplay
extends NavigatedDisplay

Provides a navigated VisAD DisplayImpl for displaying data. The Projection or MapProjection provides the transformation from lat/lon space to xy space. There are three modes that can be used with this display - MODE_3D (Java 3D), MODE_2Din3D (2D in Java 3D), MODE_2D (Java 2D). Performance is better in Java 3D modes. In the 3D mode, RealType.Altitude is mapped to the display Z axis.

Any displayable data must be able to map to RealType.Latitude, RealType.Longitude and/or RealType.Altitude.

Author:

Don Murray

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	MapProjectionDisplay.MapProjection3DAdapter An adapter for visad.georef.MapProjection coordinate systems (ie: ones with * a reference of Lat/Lon).

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	CURSOR_BEARING The name of the bearing from center property.
static visad.RealType	CURSOR_BEARING_TYPE The bearing from center RealType.
static java.lang.String	CURSOR_RANGE The name of the range from center property.
static visad.RealType	CURSOR_RANGE_TYPE The range from center RealType.
static boolean	force2D flag for forcing 2D

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

BOTTOM_VIEW, BOTTOM_VIEW_NAME, CLIP_BACK_DEFAULT, CLIP_BACK_PERSPECTIVE, CLIP_FRONT_DEFAULT, CLIP_FRONT_PERSPECTIVE, CURSOR_ALTITUDE, CURSOR_LATITUDE, CURSOR_LONGITUDE, defaultClipDistanceBack, defaultClipDistanceFront, EAST_VIEW, EAST_VIEW_NAME, MODE_2D, MODE_2Din3D, MODE_3D, NORTH_VIEW, NORTH_VIEW_NAME, SOUTH_VIEW, SOUTH_VIEW_NAME, TOP_VIEW, TOP_VIEW_NAME, WEST_VIEW, WEST_VIEW_NAME

Fields inherited from class ucar.visad.display.DisplayMaster

behavior, defaultMouseFunctions, POINT_MODE

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	MapProjectionDisplay() Constructs an instance with the specified MapProjection
protected	MapProjectionDisplay(visad.georef.MapProjection projection, visad.DisplayImpl display) Constructs an instance with the specified MapProjection CoordinateSystem and display.

Method Summary

Modifier and Type	Method and Description
abstract void	addKeyboardBehavior(visad.KeyboardBehavior behavior) Add a KeyboardBehavior to this class
void	addVerticalMap(visad.RealType newVertType) Add a new mapping of this type to the vertical coordinate
protected void	cursorMoved() Handles a change to the cursor position.
void	destroy() Destroy this class
protected visad.ScalarMap	getAltitudeMap() Accessor method for the vertical coordinate ScalarMap (i.e., what getDisplayAltitudeType is mapped from).
visad.Real	getCursorBearing() Gets the cursor bearing from center property.
visad.Real	getCursorRange() Gets the cursor range from center property.
visad.DisplayRealType	getDisplayAltitudeType() Accessor method for the DisplayAltitudeType (i.e., what RealType.Altitude is mapped to).
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 (i.e., what RealType.Latitude is mapped to).
visad.DisplayRealType	getDisplayLongitudeType() Accessor method for the DisplayLongitudeType (i.e., what RealType.Longitude is mapped to).
visad.georef.EarthLocation	getEarthLocation(double x, double y, double z, boolean setZToZeroIfOverhead) Get the earth location from the VisAD xyz coodinates
static MapProjectionDisplay	getInstance(int mode) Get an instance of a MapProjectionDisplay using the mode specified and the default projection.
static MapProjectionDisplay	getInstance(visad.georef.MapProjection p, int mode) Get an instance of a MapProjectionDisplay using the mode specified and the MapProjection.
static MapProjectionDisplay	getInstance(visad.georef.MapProjection p, int mode, boolean offscreen, java.awt.Dimension dimension) Get an instance of a MapProjectionDisplay using the mode specified and the MapProjection.
static MapProjectionDisplay	getInstance(visad.georef.MapProjection p, int mode, boolean offscreen, java.awt.Dimension dimension, java.awt.GraphicsDevice screen) Get an instance of a MapProjectionDisplay using the mode specified and the MapProjection.
LatLonAxisScaleInfo	getLatScaleInfo() Gets the lat scale info.
LatLonAxisScaleInfo	getLonScaleInfo() Gets the lon scale info.
visad.georef.MapProjection	getMapProjection() Get the MapProjection that defines the xy mapping of this MapProjectionDisplay.
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[]	getVerticalRange() Get the range of the vertical coordinate (Altitude)
VertScaleInfo	getVertScaleInfo() Gets the vertical scale info.
protected void	init(visad.georef.MapProjection projection, visad.DisplayImpl display) Initializes an instance with the specified MapProjection CoordinateSystem and display.
protected void	initializeClass() Set up the display.
static void	main(java.lang.String[] args) test by running java ucar.unidata.view.geoloc.MapProjectionDisplay
protected static visad.georef.MapProjection	makeDefaultMapProjection() Make the default projection.
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
float[]	scaleVerticalValues(float[] altValues) Scale vertical values using the range of the vertical scalar map.
protected void	setCursorBearing(visad.Real bearing) Sets the cursor bearing (degrees) from center property.
protected void	setCursorRange(visad.Real range) Sets the cursor range from center property.
void	setLatScaleInfo(LatLonAxisScaleInfo axisScaleInfo) Sets the lat scale info.
void	setLonScaleInfo(LatLonAxisScaleInfo axisScaleInfo) Sets the lon scale info.
void	setMapArea(ucar.unidata.geoloc.ProjectionRect mapArea) Set the map area from the projection rectangle
void	setMapProjection(visad.georef.MapProjection mapProjection) Define the map projection using a MapProjection type CoordinateSystem
void	setMapProjection(visad.georef.MapProjection mapProjection, boolean resetDisplayProjMatrix) Define the map projection using a MapProjection type CoordinateSystem
void	setMapProjection(ucar.unidata.geoloc.ProjectionImpl projection) Define the map projection using a Projection interface
void	setMapRegion(visad.Gridded2DSet region) Set the map region to be displayed.
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	setVertScaleInfo(VertScaleInfo vertScaleInfo) Sets the vertical scale info.
void	setView(int view) Set the view for 3D.
protected void	updateLocation(visad.georef.EarthLocation el) Update lat/lon/alt properties with the EarthLocation.

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

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

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, getStereoAvailable, 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, setEyePosition, 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

CURSOR_BEARING

public static final java.lang.String CURSOR_BEARING

The name of the bearing from center property.

See Also:

Constant Field Values

CURSOR_RANGE

public static final java.lang.String CURSOR_RANGE

The name of the range from center property.

See Also:

Constant Field Values

force2D

public static boolean force2D

flag for forcing 2D

CURSOR_RANGE_TYPE

public static visad.RealType CURSOR_RANGE_TYPE

The range from center RealType.

CURSOR_BEARING_TYPE

public static visad.RealType CURSOR_BEARING_TYPE

The bearing from center RealType.

Constructor Detail

MapProjectionDisplay

protected MapProjectionDisplay()

Constructs an instance with the specified MapProjection

MapProjectionDisplay

protected MapProjectionDisplay(visad.georef.MapProjection projection,
                               visad.DisplayImpl display)
                        throws visad.VisADException,
                               java.rmi.RemoteException

Constructs an instance with the specified MapProjection CoordinateSystem and display.

Parameters:

projection - map projection CS

display - display to use

Throws:

visad.VisADException - Couldn't create necessary VisAD object

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

Method Detail

init

protected void init(visad.georef.MapProjection projection,
                    visad.DisplayImpl display)
             throws visad.VisADException,
                    java.rmi.RemoteException

Initializes an instance with the specified MapProjection CoordinateSystem and display.

Parameters:

projection - map projection CS

display - display to use

Throws:

visad.VisADException - Couldn't create necessary VisAD object

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

initializeClass

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

Set up the display. Any additional work should be done in a subclass's intializeClass() method, which should call super.initializeClass() first.

Overrides:

initializeClass in class NavigatedDisplay

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - VisAD problem

getInstance

public static MapProjectionDisplay getInstance(int mode)
                                        throws visad.VisADException,
                                               java.rmi.RemoteException

Get an instance of a MapProjectionDisplay using the mode specified and the default projection.

Parameters:

mode - mode to use

Returns:

a MapProjectionDisplay

Throws:

visad.VisADException - problem creating some VisAD object

java.rmi.RemoteException - problem creating remote object

getInstance

public static MapProjectionDisplay getInstance(visad.georef.MapProjection p,
                                               int mode)
                                        throws visad.VisADException,
                                               java.rmi.RemoteException

Get an instance of a MapProjectionDisplay using the mode specified and the MapProjection.

Parameters:

mode - mode to use

p - initial MapProjection for display

Returns:

a MapProjection display of the correct mode and projection

Throws:

visad.VisADException - problem creating some VisAD object

java.rmi.RemoteException - problem creating remote object

getInstance

public static MapProjectionDisplay getInstance(visad.georef.MapProjection p,
                                               int mode,
                                               boolean offscreen,
                                               java.awt.Dimension dimension)
                                        throws visad.VisADException,
                                               java.rmi.RemoteException

Get an instance of a MapProjectionDisplay using the mode specified and the MapProjection.

Parameters:

p - map projection

mode - mode

offscreen - true if offscreen

dimension - dimension of display

Returns:

the instance

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - problem creating the display or some component

getInstance

public static MapProjectionDisplay getInstance(visad.georef.MapProjection p,
                                               int mode,
                                               boolean offscreen,
                                               java.awt.Dimension dimension,
                                               java.awt.GraphicsDevice screen)
                                        throws visad.VisADException,
                                               java.rmi.RemoteException

Get an instance of a MapProjectionDisplay using the mode specified and the MapProjection.

Parameters:

p - map projection

mode - mode

offscreen - true if offscreen

dimension - dimension of display

screen - screen to display it on

Returns:

the instance

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - problem creating the display or some component

destroy

public void destroy()

Destroy this class

Overrides:

destroy in class NavigatedDisplay

addKeyboardBehavior

public abstract void addKeyboardBehavior(visad.KeyboardBehavior behavior)

Add a KeyboardBehavior to this class

Overrides:

addKeyboardBehavior in class DisplayMaster

Parameters:

behavior - behavior to add

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

setLatScaleInfo

public void setLatScaleInfo(LatLonAxisScaleInfo axisScaleInfo)
                     throws java.rmi.RemoteException,
                            visad.VisADException

Sets the lat scale info.

Parameters:

axisScaleInfo - the new lat scale info

Throws:

java.rmi.RemoteException - the remote exception

visad.VisADException - the vis ad exception

setLonScaleInfo

public void setLonScaleInfo(LatLonAxisScaleInfo axisScaleInfo)
                     throws java.rmi.RemoteException,
                            visad.VisADException

Sets the lon scale info.

Parameters:

axisScaleInfo - the new lon scale info

Throws:

java.rmi.RemoteException - the remote exception

visad.VisADException - the vis ad exception

getLatScaleInfo

public LatLonAxisScaleInfo getLatScaleInfo()

Gets the lat scale info.

Returns:

the lat scale info

getVertScaleInfo

public VertScaleInfo getVertScaleInfo()

Gets the vertical scale info.

Returns:

the vertical scale info

setVertScaleInfo

public void setVertScaleInfo(VertScaleInfo vertScaleInfo)
                      throws java.rmi.RemoteException,
                             visad.VisADException

Sets the vertical scale info.

Parameters:

vertScaleInfo - the new vertical scale info

Throws:

java.rmi.RemoteException - the remote exception

visad.VisADException - the vis ad exception

getLonScaleInfo

public LatLonAxisScaleInfo getLonScaleInfo()

Gets the lon scale info.

Returns:

the lon scale info

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

getVerticalRange

public double[] getVerticalRange()

Get the range of the vertical coordinate (Altitude)

Overrides:

getVerticalRange in class NavigatedDisplay

Returns:

array of {min, max} range.

setCursorRange

protected void setCursorRange(visad.Real range)
                       throws visad.VisADException,
                              java.rmi.RemoteException

Sets the cursor range from center property.

Parameters:

range - The cursor range from center.

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - VisAD problem

getCursorRange

public visad.Real getCursorRange()

Gets the cursor range from center property.

Returns:

The currently-selected range. May be null.

setCursorBearing

protected void setCursorBearing(visad.Real bearing)
                         throws visad.VisADException,
                                java.rmi.RemoteException

Sets the cursor bearing (degrees) from center property. This implementation uses a great circle distance.

Parameters:

bearing - The cursor bearing from center.

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - VisAD problem

getCursorBearing

public visad.Real getCursorBearing()

Gets the cursor bearing from center property.

Returns:

The currently-selected bearing. May be null.

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 |       | S
                    T |_______| T
                        SOUTH
 

Specified by:

setView in class NavigatedDisplay

Parameters:

view - one of the static view fields (NORTH_VIEW, SOUTH_VIEW, .. etc).

getDisplayLatitudeType

public visad.DisplayRealType getDisplayLatitudeType()

Accessor method for the DisplayLatitudeType (i.e., what RealType.Latitude is mapped to).

Specified by:

getDisplayLatitudeType in class NavigatedDisplay

Returns:

the DisplayRealType that RealType.Latitude is mapped to

getDisplayLongitudeType

public visad.DisplayRealType getDisplayLongitudeType()

Accessor method for the DisplayLongitudeType (i.e., what RealType.Longitude is mapped to).

Specified by:

getDisplayLongitudeType in class NavigatedDisplay

Returns:

the DisplayRealType that RealType.Longitude is mapped to

getDisplayAltitudeType

public visad.DisplayRealType getDisplayAltitudeType()

Accessor method for the DisplayAltitudeType (i.e., what RealType.Altitude is mapped to).

Specified by:

getDisplayAltitudeType in class NavigatedDisplay

Returns:

the DisplayRealType that RealType.Altitude is mapped to

getAltitudeMap

protected visad.ScalarMap getAltitudeMap()

Accessor method for the vertical coordinate ScalarMap (i.e., what getDisplayAltitudeType is mapped from).

Specified by:

getAltitudeMap in class NavigatedDisplay

Returns:

the ScalarMap that the vertical coordinate is mapped to

setMapProjection

public void setMapProjection(ucar.unidata.geoloc.ProjectionImpl projection)
                      throws visad.VisADException,
                             java.rmi.RemoteException

Define the map projection using a Projection interface

Overrides:

setMapProjection in class NavigatedDisplay

Parameters:

projection - Projection to use

Throws:

visad.VisADException - Couldn't create necessary VisAD object

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

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

setMapProjection

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

Define the map projection using a MapProjection type CoordinateSystem

Parameters:

mapProjection - map projection coordinate system

resetDisplayProjMatrix - yes/no change the current VisAD Display projection matrix when the map projection is changed.

Throws:

visad.VisADException - Couldn't create necessary VisAD object

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

getMapProjection

public visad.georef.MapProjection getMapProjection()

Get the MapProjection that defines the xy mapping of this MapProjectionDisplay.

Returns:

MapProjection being used.

setMapArea

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

Set the map area from the projection rectangle

Overrides:

setMapArea in class NavigatedDisplay

Parameters:

mapArea - map area as lat/lon lines

Throws:

java.rmi.RemoteException - problem setting remote data

visad.VisADException - problem creating VisAD data object

setMapRegion

public void setMapRegion(visad.Gridded2DSet region)
                  throws visad.VisADException,
                         java.rmi.RemoteException

Set the map region to be displayed. The MathType of the domain of the set must be either RealTupleType.SpatialCartesian2DTuple, RealTupleType.SpatialEarth2DTuple, or RealTupleType.LatitudeLongitudeTuple.

Parameters:

region - Gridded2DSet containing the range of for the axis.

Throws:

visad.VisADException - invalid domain or null set

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

scaleVerticalValues

public float[] scaleVerticalValues(float[] altValues)

Scale vertical values using the range of the vertical scalar map.

Parameters:

altValues - altitude map values

Returns:

z values (may transform in place);

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.

updateLocation

protected void updateLocation(visad.georef.EarthLocation el)
                       throws visad.VisADException,
                              java.rmi.RemoteException

Update lat/lon/alt properties with the EarthLocation.

Overrides:

updateLocation in class NavigatedDisplay

Parameters:

el - EarthLocation to use.

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - VisAD problem

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.

Overrides:

pointerMoved in class NavigatedDisplay

Parameters:

x - x mouse position

y - y mouse position

Throws:

java.rmi.RemoteException - Java RMI problem

visad.UnitException - Unit conversion problem

visad.VisADException - VisAD problem

getEarthLocation

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

Get the earth location from the VisAD xyz coodinates

Specified by:

getEarthLocation in class NavigatedDisplay

Parameters:

x - x

y - y

z - z

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

Returns:

corresponding EarthLocation

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 to transform

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 to transform

xyz - The in value to set. May be null.

altitude - altitude value

Returns:

xyz array

Throws:

java.rmi.RemoteException - Java RMI problem

visad.VisADException - VisAD problem

makeDefaultMapProjection

protected static visad.georef.MapProjection makeDefaultMapProjection()
                                                              throws visad.VisADException

Make the default projection.

Returns:

Default projectcion

Throws:

visad.VisADException - couldn't create MapProjection

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)

main

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

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

Parameters:

args - include an argument for a 3D display

Throws:

java.lang.Exception - problem creating the display