com.esri.core.geometry
Class Unit

java.lang.Object
  com.esri.core.geometry.Unit

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

AngularUnit, AreaUnit, LinearUnit

public abstract class Unit
extends Object
implements Serializable

A base class for units.

See Also:

Serialized Form

Nested Class Summary

static class

Unit.UnitType Unit type (linear, angular, or area)

Constructor Summary

Unit()

Method Summary

static void	convertUnits(double[] valueIn, int countIn, Unit unitFrom, Unit unitTo, double[] valueOut) Converts an array of values to new units of same UnitType.
static double	convertUnits(double valueIn, Unit unitFrom, Unit unitTo) Converts an input value to new units.
static Unit	create(int wkid) Create a unit class from the well-known id(wkid).
boolean	equals(Object other) Indicates if this unit is the same type (linear, angular, or area) and the same unit(meter, degree, acre, etc.)as another.
abstract String	getAbbreviation() Returns the abbreviated name of this unit.
abstract double	getConversionFactor(Unit destinationUnit) Returns a conversion factor from this unit to the destination unit.
abstract String	getDisplayName() Returns the display name of this unit.
abstract int	getID() Returns the unit well-known ID.
abstract String	getName() Returns the canonical name of the unit as defined in Projection Engine.
abstract String	getPluralDisplayName() Returns the display name of this unit.
double	getUnitToBaseFactor() the conversion factor from this unit to the base unit.
abstract Unit.UnitType	getUnitType() Returns the unit type.
int	hashCode()

Methods inherited from class java.lang.Object

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

Constructor Detail

Unit

public Unit()

Method Detail

getUnitType

public abstract Unit.UnitType getUnitType()

Returns the unit type.

create

public static Unit create(int wkid)

Create a unit class from the well-known id(wkid). The list of codes for common wkids can be found in the AngularUnit.Code interface, the LinearUnit.Code interface, and the AreaUnit.Code interface.

Parameters:

wkid - The well known ID.

Returns:

The unit object of type angular, area, or linear.

getName

public abstract String getName()

Returns the canonical name of the unit as defined in Projection Engine. (ex. for German Meter the projection engine canonical string value is METER_GERMAN)

Returns:

A string representation of Projection Engine unit name.

getID

public abstract int getID()

Returns the unit well-known ID. The ID value is a positive number for the units with well known IDs, and 0 for the custom and area units.

Returns:

Integer value for wkid.

getDisplayName

public abstract String getDisplayName()

Returns the display name of this unit.

Returns:

A string value of unit display name.

getPluralDisplayName

public abstract String getPluralDisplayName()

Returns the display name of this unit.

Returns:

string value of plural display name

getAbbreviation

public abstract String getAbbreviation()

Returns the abbreviated name of this unit.

Returns:

A string value of abbreviation for unit.

getConversionFactor

public abstract double getConversionFactor(Unit destinationUnit)

Returns a conversion factor from this unit to the destination unit. To convert a value V from this units to the dst units.

Parameters:

destinationUnit - The destination unit.

Returns:

A double conversion factor.

convertUnits

public static double convertUnits(double valueIn,
                                  Unit unitFrom,
                                  Unit unitTo)

Converts an input value to new units.

Parameters:

valueIn - The value to be converted from unitFrom to unitTo.

unitFrom - The units to convert from.

unitTo - The units to convert to.

Returns:

A converted value as double.

convertUnits

public static void convertUnits(double[] valueIn,
                                int countIn,
                                Unit unitFrom,
                                Unit unitTo,
                                double[] valueOut)

Converts an array of values to new units of same UnitType.

Parameters:

valueIn - The value to converted from.

countIn - The count for the to converted values.

unitFrom - The unit to convert from.

unitTo - The unit to convert to.

valueOut - the value to convert to.

getUnitToBaseFactor

public double getUnitToBaseFactor()

the conversion factor from this unit to the base unit. for example: to SI meter for linear units, to radian for angular, and to SI square meter for area units.

equals

public boolean equals(Object other)

Indicates if this unit is the same type (linear, angular, or area) and the same unit(meter, degree, acre, etc.)as another.

Overrides:

equals in class Object

Parameters:

other - The other object.

hashCode

public int hashCode()

Overrides:

hashCode in class Object