gov.nasa.worldwind.symbology.milstd2525
Class MilStd2525UnitsFormat

java.lang.Object
  gov.nasa.worldwind.avlist.AVListImpl
      gov.nasa.worldwind.util.UnitsFormat
          gov.nasa.worldwind.symbology.milstd2525.MilStd2525UnitsFormat

All Implemented Interfaces:

AVList

public class MilStd2525UnitsFormat
extends UnitsFormat

Units format configured to format locations and altitudes according to the defaults defined by MIL-STD-2525C.

Field Summary

Fields inherited from class gov.nasa.worldwind.util.UnitsFormat

ACRE, altitudeUnits, altitudeUnitsMultiplier, altitudeUnitsSymbol, areaUnits, areaUnitsMultiplier, areaUnitsSymbol, FEET, FORMAT_AREA, FORMAT_DECIMAL_DEGREES, FORMAT_EYE_ALTITUDE, FORMAT_HEADING, FORMAT_LENGTH, FORMAT_PITCH, FORMAT_TERRAIN_HEIGHT, FORMAT_UTM_EASTING, FORMAT_UTM_NORTHING, HECTARE, IMPERIAL_SYSTEM, KILOMETERS, LABEL_DATUM, LABEL_EYE_ALTITUDE, LABEL_HEADING, LABEL_LATITUDE, LABEL_LATLON_LAT, LABEL_LATLON_LON, LABEL_LONGITUDE, LABEL_PITCH, LABEL_TERRAIN_HEIGHT, LABEL_UTM_EASTING, LABEL_UTM_NORTHING, LABEL_UTM_ZONE, lengthUnits, lengthUnitsMultiplier, lengthUnitsSymbol, METERS, METRIC_SYSTEM, MILES, NAUTICAL_MILES, NL, showDMS, SQUARE_FEET, SQUARE_KILOMETERS, SQUARE_METERS, SQUARE_MILES, SQUARE_YARDS, SYMBOL_ACRE, SYMBOL_FEET, SYMBOL_HECTARE, SYMBOL_KILOMETERS, SYMBOL_METERS, SYMBOL_MILES, SYMBOL_NAUTICAL_MILES, SYMBOL_SQUARE_FEET, SYMBOL_SQUARE_KILOMETERS, SYMBOL_SQUARE_METERS, SYMBOL_SQUARE_MILES, SYMBOL_SQUARE_YARDS, SYMBOL_YARDS, YARDS

Constructor Summary

MilStd2525UnitsFormat()
Construct an instance that displays length in kilometers, area in square kilometers and angles in degrees, minutes, seconds.

MilStd2525UnitsFormat(String lengthUnits, String areaUnits)
Constructs an instance that display length and area in specified units, and angles in degrees, minutes, seconds.

MilStd2525UnitsFormat(String lengthUnits, String areaUnits, boolean showDMS)
Constructs an instance that display length and area in specified units, and angles in a specified format.

Method Summary

String	latitude(Angle angle) Format a latitude value.
String	latLon(LatLon latlon) Format angles of latitude and longitude according to the current angle format.
String	longitude(Angle angle) Format a longitude value.
void	setAltitudeUnits(String altitudeUnits) Specifies the units in which to display altitude values.
protected void	setDefaultLabels() Establishes the labels to use when displaying values other than length and area.

Methods inherited from class gov.nasa.worldwind.util.UnitsFormat

angle, angleNL, area, areaNL, eyeAltitude, eyeAltitudeNL, getAltitudeUnits, getAltitudeUnitsMultiplier, getAltitudeUnitsSymbol, getAreaUnits, getAreaUnitsMultiplier, getAreaUnitsSymbol, getAreaUnitsSystem, getFormat, getLabel, getLengthUnits, getLengthUnitsMultiplier, getLengthUnitsSymbol, getLengthUnitsSystem, heading, heading, headingNL, headingNL, isShowDMS, latitudeNL, latLonNL, length, lengthNL, longitudeNL, pitch, pitchNL, setAreaUnits, setDefaultFormats, setFormat, setLabel, setLengthUnits, setShowDMS, setUnitsSystem, terrainHeight, terrainHeightNL, utmEasting, utmEastingNL, utmNorthing, utmNorthingNL, utmZone, utmZoneNL

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

Constructor Detail

MilStd2525UnitsFormat

public MilStd2525UnitsFormat()

Construct an instance that displays length in kilometers, area in square kilometers and angles in degrees, minutes, seconds.

MilStd2525UnitsFormat

public MilStd2525UnitsFormat(String lengthUnits,
                             String areaUnits)

Constructs an instance that display length and area in specified units, and angles in degrees, minutes, seconds.

Parameters:

lengthUnits - the desired length units. Available length units are METERS, KILOMETERS, MILES, NAUTICAL_MILES, YARDS and FEETareaUnits - the desired area units. Available area units are SQUARE_METERS, SQUARE_KILOMETERS, HECTARE, ACRE, SQUARE_YARD and SQUARE_FEET.

Throws:

IllegalArgumentException - if either lengthUnits or areaUnits is null.

MilStd2525UnitsFormat

public MilStd2525UnitsFormat(String lengthUnits,
                             String areaUnits,
                             boolean showDMS)

Constructs an instance that display length and area in specified units, and angles in a specified format.

Parameters:

lengthUnits - the desired length units. Available length units are METERS, KILOMETERS, MILES, NAUTICAL_MILES, YARDS and FEETareaUnits - the desired area units. Available area units are SQUARE_METERS, SQUARE_KILOMETERS, HECTARE, ACRE, SQUARE_YARD and SQUARE_FEET.

showDMS - true if the desired angle format is degrees-minutes-seconds, false if the format is decimal degrees.

Throws:

IllegalArgumentException - if either lengthUnits or areaUnits is null.

Method Detail

latitude

public String latitude(Angle angle)

Format a latitude value. If this format is configured to show degrees, minutes, and seconds then the returned string will use the format "DDMMSS.S".

Overrides:

latitude in class UnitsFormat

Parameters:

angle - the angle to format.

Returns:

a string containing the formatted angle.

Throws:

IllegalArgumentException - if the angle is null.

latLon

public String latLon(LatLon latlon)

Format angles of latitude and longitude according to the current angle format.

The values are formatted using the current UnitsFormat.LABEL_LATLON_LAT, UnitsFormat.LABEL_LATLON_LON and angle format.

Overrides:

latLon in class UnitsFormat

Parameters:

latlon - the angles to format.

Returns:

a string containing the formatted angles.

longitude

public String longitude(Angle angle)

Format a longitude value. If this format is configured to show degrees, minutes, and seconds then the returned string will use the format "DDDMMSS.S".

Overrides:

longitude in class UnitsFormat

Parameters:

angle - the angle to format.

Returns:

a string containing the formatted angle.

Throws:

IllegalArgumentException - if the angle is null.

setAltitudeUnits

public void setAltitudeUnits(String altitudeUnits)

Specifies the units in which to display altitude values. Units subsequently formatted by the instance are converted from meters to the desired units prior to formatting.

Overrides:

setAltitudeUnits in class UnitsFormat

Parameters:

altitudeUnits - the desired altitude units. See UnitsFormat.UnitsFormat(String, String, boolean) for the list of those available.

setDefaultLabels

protected void setDefaultLabels()

Establishes the labels to use when displaying values other than length and area. A label is a string placed before the value and its units. Examples are Latitude 24.36, UTM Zone: 12, and Eye Altitude: 500 km, where the emphasized terms are the labels. Subclasses can override this method to establish labels other than the defaults. The default labels are drawn from the current message properties. The recognized labels are those indicated by the "LABEL_" constants defined by this class or by its subclasses.

Overrides:

setDefaultLabels in class UnitsFormat