|
NASA World Wind | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface ElevationModel
Provides the elevations a
Globe
or other object holding elevations.
An ElevationModel
often approximates elevations at multiple levels of spatial resolution. For any given
viewing position the model determines an appropriate target resolution. That target resolution may not be immediately
achievable, however, because the corresponding elevation data might not be locally available and must be retrieved
from a remote location. When this is the case, the Elevations
object returned for a sector holds the
resolution achievable with the data currently available. That resolution may not be the same as the target
resolution. The achieved resolution is made available in the interface.
Method Summary | |
---|---|
void |
composeElevations(Sector sector,
List<? extends LatLon> latlons,
int tileWidth,
double[] buffer)
|
boolean |
contains(Angle latitude,
Angle longitude)
Indicates whether a specified location is within the elevation model's domain. |
double |
getBestResolution(Sector sector)
Indicates the best resolution attainable for a specified sector. |
double |
getDetailHint(Sector sector)
Returns the detail hint associated with the specified sector. |
double |
getElevation(Angle latitude,
Angle longitude)
Returns the elevation at a specified location, or an unspecified value, typically zero, if an elevation cannot be determined. |
double |
getElevations(Sector sector,
List<? extends LatLon> latlons,
double targetResolution,
double[] buffer)
Returns the elevations of a collection of locations. |
long |
getExpiryTime()
Returns the current expiry time. |
double[] |
getExtremeElevations(Angle latitude,
Angle longitude)
Returns the minimum and maximum elevations at a specified location. |
double[] |
getExtremeElevations(Sector sector)
Returns the minimum and maximum elevations within a specified sector of the elevation model. |
double |
getMaxElevation()
Returns the maximum elevation contained in the elevevation model. |
double |
getMinElevation()
Returns the minimum elevation contained in the elevevation model. |
double |
getMissingDataSignal()
Returns the current missing-data sentinel. |
String |
getName()
Returns the elevation model's name, as specified in the most recent call to setName(java.lang.String) . |
double |
getUnmappedElevation(Angle latitude,
Angle longitude)
Returns the elevation at a specified location, but without mapping missing data to the elevation model's missing data replacement value. |
int |
intersects(Sector sector)
Indicates whether the elevation model corresponds to a specified sector. |
boolean |
isNetworkRetrievalEnabled()
Indicates whether the elevation model is allowed to retrieve data from the network. |
void |
setExpiryTime(long expiryTime)
Specifies the time of the elevation model's most recent dataset update. |
void |
setMissingDataSignal(double flag)
Specifies the value used to identify missing data in an elevation model. |
void |
setName(String name)
Set the elevation model's name. |
void |
setNetworkRetrievalEnabled(boolean networkRetrievalEnabled)
Controls whether the elevation model is allowed to retrieve data from the network. |
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.Restorable |
---|
getRestorableState, restoreState |
Method Detail |
---|
void composeElevations(Sector sector, List<? extends LatLon> latlons, int tileWidth, double[] buffer) throws Exception
Exception
boolean contains(Angle latitude, Angle longitude)
latitude
- the latitude of the location in question.longitude
- the longitude of the location in question.
double getBestResolution(Sector sector)
sector
- the sector in question. If null, the elevation model's best overall resolution is returned. This is
the best attainable at some> locations but not necessarily at all locations.
Double.MAX_VALUE
if the
sector does not intersect the elevation model.double getDetailHint(Sector sector)
sector
- the sector in question.
IllegalArgumentException
- if sector
is null.double getElevation(Angle latitude, Angle longitude)
latitude
- the latitude of the location in question.longitude
- the longitude of the location in question.
setMissingDataSignal(double)
double getElevations(Sector sector, List<? extends LatLon> latlons, double targetResolution, double[] buffer)
sector
- the sector in question.latlons
- the locations to return elevations for. A value of zero is returned if a location is
null.targetResolution
- the desired horizontal resolution, in radians, of the raster or other elevation sample
from which elevations are drawn. (To compute radians from a distance, divide the distance
by the radius of the globe, ensuring that both the distance and the radius are in the
same units.)buffer
- an array in which to place the returned elevations. The array must be pre-allocated and
contain at least as many elements as the list of locations.
Double.MAX_VALUE
if individual elevations cannot be
determined for any of the locations.#setMissingValueSentinel(Double)
long getExpiryTime()
double[] getExtremeElevations(Angle latitude, Angle longitude)
latitude
- the latitude of the location in question.longitude
- the longitude of the location in question.
double
array indicating the minimum and maximum elevations at the specified
location, respectively. These values are the global minimum and maximum if the local minimum and maximum
values are currently unknown.double[] getExtremeElevations(Sector sector)
sector
- the sector in question.
double
array indicating the sector's minimum and maximum elevations,
respectively. These elements are the global minimum and maximum if the local minimum and maximum values
are currently unknown.double getMaxElevation()
double getMinElevation()
double getMissingDataSignal()
String getName()
setName(java.lang.String)
.
double getUnmappedElevation(Angle latitude, Angle longitude)
latitude
- the latitude of the location for which to return the elevation.longitude
- the longitude of the location for which to return the elevation.
int intersects(Sector sector)
sector
- the sector in question.
boolean isNetworkRetrievalEnabled()
true
if the elevation model is enabled to retrieve network data, else false
.void setExpiryTime(long expiryTime)
expiryTime
- the expiry time of any cached data, expressed as a number of milliseconds beyond the epoch.for a description of milliseconds beyond the epoch.
void setMissingDataSignal(double flag)
flag
- a reference to the sentinel value. The default value is null, indicating that there is no
missing-data sentinel and all data entry values are considered valid.void setName(String name)
name
- the name to assign to the elevation model.void setNetworkRetrievalEnabled(boolean networkRetrievalEnabled)
networkRetrievalEnabled
- true
if network retrieval is allowed, else false
.
|
NASA World Wind | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |