|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Objectcom.esri.arcgis.geometry.VerticalCoordinateSystem
public class VerticalCoordinateSystem
Creates a vertical coordinate system.
A vertical coordinate system has two types. It can either be gravity-related, which requires a VerticalDatum; or ellipsoid/spheroid-based which requires a horizontal Datum. A horizontal Datum is the same as one used for a geographic coordinate system. It has a linear unit of measure. A VCS has two parameters. The positiveDirection value defines whether the vertical coordinate system has positive values 'up', for heights, or 'down', for depths. Use -1 for positive depths. The verticalShift parameter is a way to identify this VCS as offset from some other known surface. For example, you might know that a dataset's depths are referenced to mean lower low water (a tidal level). You might also know that for this dataset, mean lower low water is 1.23 meters 'down' from local mean sea level. The VCS could be defined for mean sea level but with a verticalShift of -1.23 to shift the 'zero' level to mean lower low water.
| Constructor Summary | |
|---|---|
VerticalCoordinateSystem()
Constructs a VerticalCoordinateSystem using ArcGIS Engine. |
|
VerticalCoordinateSystem(Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts. VerticalCoordinateSystem theVerticalCoordinateSystem = (VerticalCoordinateSystem) obj; |
|
| Method Summary | |
|---|---|
void |
assign(IClone src)
Assigns the properties of src to the receiver. |
void |
define(Object name,
Object alias,
Object abbreviation,
Object remarks,
Object useage,
Object hvDatum,
Object projectedUnit,
Object verticalShift,
Object positiveDirection)
Defines the properties of a vertical coordinate system. |
void |
define(String authorityName,
int authorityCode,
String authorityVersion)
Defines the authority-related metadata properties for this spatial reference object. |
boolean |
equals(Object o)
Compare this object with another |
IClone |
esri_clone()
Clones the receiver and assigns the result to *clone. |
void |
exportToESRISpatialReference(String[] str,
int[] cBytesWrote)
Exports this spatial reference component to a buffer. |
void |
exportToESRISpatialReference2(String[] str,
int[] cBytesWrote)
Exports this spatial reference component to a buffer. |
String |
getAbbreviation()
The abbreviated name of this spatial reference component. |
String |
getAlias()
The alias of this spatial reference component. |
String |
getAuthorityName()
The name of the defining authority for this object. |
void |
getClassID(GUID[] pClassID)
getClassID |
static String |
getClsid()
getClsid. |
int |
getCode()
The code identifying this object relative to its authority. |
ILinearUnit |
getCoordinateUnit()
The linear unit of measure for the vertical coordinate system. |
IHVDatum |
getDatum()
The vertical or horizontal datum of the vertical coordinate system. |
int |
getESRISpatialReferenceSize()
The number of bytes required to hold the persistant representation of this spatial reference component. |
int |
getFactoryCode()
The factory code (WKID) of the spatial reference. |
String |
getName()
The name of this spatial reference component. |
void |
getParameters(IParameter[] parameters)
Gets the vertical coordinate system parameters. |
void |
getParameters(IParameter[][] parameters)
Retrieves the PositiveDirection and VerticalShift parameters into an array. |
int |
getPositiveDirection()
A parameter that determines whether the coordinate system is positive 'up' or 'down'. |
String |
getRemarks()
The comment string of this spatial reference component. |
void |
getSizeMax(_ULARGE_INTEGER[] pcbSize)
getSizeMax |
String |
getUsage()
The usage notes of a vertical coordinate system. |
String |
getVersion()
The version of this spatial reference object. |
double |
getVerticalShift()
An offset parameter that changes the origin of the vertical coordinate system. |
int |
hashCode()
the hashcode for this object |
void |
importFromESRISpatialReference(String str,
int[] cBytesRead)
Defines this spatial reference component from the specified ESRISpatialReference buffer. |
void |
interfaceSupportsErrorInfo(GUID riid)
interfaceSupportsErrorInfo |
void |
isDirty()
isDirty |
boolean |
isEqual(IClone other)
Indicates if the receiver and other have the same properties. |
boolean |
isIdentical(IClone other)
Indicates if the receiver and other are the same object. |
void |
load(IStream pstm)
load |
void |
readExternal(ObjectInput in)
|
void |
save(IStream pstm,
int fClearDirty)
save |
void |
setCoordinateUnit(ILinearUnit unit)
The linear unit of measure for the vertical coordinate system. |
void |
setPositiveDirection(int pd)
The positive direction of the z coordinates. |
void |
setVerticalShift(double vshift)
An offset parameter that changes the origin of the vertical coordinate system. |
void |
writeExternal(ObjectOutput out)
|
| Methods inherited from class java.lang.Object |
|---|
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
| Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef |
|---|
getJintegraDispatch, release |
| Constructor Detail |
|---|
public VerticalCoordinateSystem()
throws IOException,
UnknownHostException
IOException - if there are interop problems
UnknownHostException - if there are interop problems
public VerticalCoordinateSystem(Object obj)
throws IOException
VerticalCoordinateSystem theVerticalCoordinateSystem = (VerticalCoordinateSystem) obj;
obj to VerticalCoordinateSystem.
obj - an object returned from ArcGIS Engine or Server
IOException - if there are interop problems| Method Detail |
|---|
public static String getClsid()
public boolean equals(Object o)
equals in class Objectpublic int hashCode()
hashCode in class Object
public String getUsage()
throws IOException,
AutomationException
getUsage in interface IVerticalCoordinateSystemgetUsage in interface IVerticalCoordinateSystemGENIOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public IHVDatum getDatum()
throws IOException,
AutomationException
Retrieves the vertical or horizontal datum of the vertical coordinate system as IHVDatum.
getDatum in interface IVerticalCoordinateSystemgetDatum in interface IVerticalCoordinateSystemGENIOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public ILinearUnit getCoordinateUnit()
throws IOException,
AutomationException
The unit of measure of the vertical coordinate system. The unit is always be a linear unit such as meters.
getCoordinateUnit in interface IVerticalCoordinateSystemgetCoordinateUnit in interface IVerticalCoordinateSystemGENIOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void setCoordinateUnit(ILinearUnit unit)
throws IOException,
AutomationException
setCoordinateUnit in interface IVerticalCoordinateSystemsetCoordinateUnit in interface IVerticalCoordinateSystemGENunit - A reference to a com.esri.arcgis.geometry.ILinearUnit (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public double getVerticalShift()
throws IOException,
AutomationException
The verticalShift parameter is a way to identify this VCS as offset from some other known surface. For example, you might know that a dataset's depths are referenced to mean lower low water (a tidal level). You might also know that for this dataset, mean lower low water is 1.23 meters 'down' from local mean sea level. The VCS could be defined for mean sea level but with a verticalShift of -1.23 to shift the 'zero' level to mean lower low water.
getVerticalShift in interface IVerticalCoordinateSystemgetVerticalShift in interface IVerticalCoordinateSystemGENIOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void setVerticalShift(double vshift)
throws IOException,
AutomationException
setVerticalShift in interface IVerticalCoordinateSystemsetVerticalShift in interface IVerticalCoordinateSystemGENvshift - The vshift (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public int getPositiveDirection()
throws IOException,
AutomationException
The positiveDirection value defines whether the vertical coordinate system has positive values 'up', for heights, or 'down', for depths. Use -1 for positive depths.
getPositiveDirection in interface IVerticalCoordinateSystemgetPositiveDirection in interface IVerticalCoordinateSystemGENIOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void getParameters(IParameter[][] parameters)
throws IOException,
AutomationException
Returns the PositiveDirection and VerticalShift parameters in an array of IParameters.
getParameters in interface IVerticalCoordinateSystemGENparameters - A reference to a com.esri.arcgis.geometry.IParameter array (in/out: use single element array)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void setPositiveDirection(int pd)
throws IOException,
AutomationException
setPositiveDirection in interface IVerticalCoordinateSystempd - The pd (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void getParameters(IParameter[] parameters)
throws IOException,
AutomationException
Returns the PositiveDirection and VerticalShift parameters in an array of IParameters.
getParameters in interface IVerticalCoordinateSystemparameters - A reference to a com.esri.arcgis.geometry.IParameter (out: use single element array)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public String getName()
throws IOException,
AutomationException
getName in interface ISpatialReferenceInfoIOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public String getAlias()
throws IOException,
AutomationException
getAlias in interface ISpatialReferenceInfoIOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public String getAbbreviation()
throws IOException,
AutomationException
getAbbreviation in interface ISpatialReferenceInfoIOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public String getRemarks()
throws IOException,
AutomationException
getRemarks in interface ISpatialReferenceInfoIOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public int getFactoryCode()
throws IOException,
AutomationException
The factory code is an integer identifier that is unique by projection engine object type, such as a projected coordinate system. You can use a factory code in the ISpatialReferenceFactory::CreateProjectedCoordinateSystem method for example. If you create a custom projected coordinate system, the factory code is zero.
getFactoryCode in interface ISpatialReferenceInfoIOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public int getESRISpatialReferenceSize()
throws IOException,
AutomationException
getESRISpatialReferenceSize in interface IESRISpatialReferencegetESRISpatialReferenceSize in interface IESRISpatialReferenceGENgetESRISpatialReferenceSize in interface IESRISpatialReferenceGEN2IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void importFromESRISpatialReference(String str,
int[] cBytesRead)
throws IOException,
AutomationException
importFromESRISpatialReference in interface IESRISpatialReferenceimportFromESRISpatialReference in interface IESRISpatialReferenceGENimportFromESRISpatialReference in interface IESRISpatialReferenceGEN2str - The str (in)cBytesRead - The cBytesRead (out: use single element array)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void exportToESRISpatialReference(String[] str,
int[] cBytesWrote)
throws IOException,
AutomationException
exportToESRISpatialReference in interface IESRISpatialReferenceexportToESRISpatialReference in interface IESRISpatialReferenceGENstr - The str (out: use single element array)cBytesWrote - The cBytesWrote (out: use single element array)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void exportToESRISpatialReference2(String[] str,
int[] cBytesWrote)
throws IOException,
AutomationException
exportToESRISpatialReference2 in interface IESRISpatialReferenceGEN2str - The str (out: use single element array)cBytesWrote - The cBytesWrote (out: use single element array)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void define(Object name,
Object alias,
Object abbreviation,
Object remarks,
Object useage,
Object hvDatum,
Object projectedUnit,
Object verticalShift,
Object positiveDirection)
throws IOException,
AutomationException
The Define method allows you to create a custom vertical coordinate system (VCS). You can use ISpatialReferenceFactory3 to create the predefined objects you need to define a VCS or use the various Edit interfaces to create custom objects.
A vertical coordinate system has two types. It can either be gravity-related, which requires a VerticalDatum; or ellipsoid/spheroid-based which requires a horizontal Datum. A horizontal Datum is the same as one used for a geographic coordinate system. You will also need a (linear) projectedUnit object. A VCS has two parameters. The positiveDirection value defines whether the vertical coordinate system has positive values 'up', heights, or 'down', depths. Use -1 for positive depths. The verticalShift parameter is a way to identify this VCS as offset from some other known surface. For example, you might know that a dataset's depths are referenced to mean lower low water (a tidal level). You might also know that for this dataset, mean lower low water is 1.23 meters below local mean sea level. The VCS could be defined for mean sea level but with a verticalShift of -1.23.
define in interface IVerticalCoordinateSystemEditname - A Variant (in, optional, pass null if not required)alias - A Variant (in, optional, pass null if not required)abbreviation - A Variant (in, optional, pass null if not required)remarks - A Variant (in, optional, pass null if not required)useage - A Variant (in, optional, pass null if not required)hvDatum - A Variant (in, optional, pass null if not required)projectedUnit - A Variant (in, optional, pass null if not required)verticalShift - A Variant (in, optional, pass null if not required)positiveDirection - A Variant (in, optional, pass null if not required)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public IClone esri_clone()
throws IOException,
AutomationException
esri_clone in interface ICloneIOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void assign(IClone src)
throws IOException,
AutomationException
assign in interface IClonesrc - A reference to a com.esri.arcgis.system.IClone (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public boolean isEqual(IClone other)
throws IOException,
AutomationException
IsEqual returns True if the receiver and the source have the same properties. Note, this does not imply that the receiver and the source reference the same object.
isEqual in interface ICloneother - A reference to a com.esri.arcgis.system.IClone (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public boolean isIdentical(IClone other)
throws IOException,
AutomationException
IsIdentical returns true if the receiver and the source reference the same object.
isIdentical in interface ICloneother - A reference to a com.esri.arcgis.system.IClone (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void getClassID(GUID[] pClassID)
throws IOException,
AutomationException
IPersist is a Microsoft interface. Please refer to MSDN for information about this interface.
getClassID in interface IPersistpClassID - A Structure: com.esri.arcgis.support.ms.stdole.GUID (out: use single element array)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void isDirty()
throws IOException,
AutomationException
IPersistStream is a Microsoft interface. Please refer to MSDN for information about this interface.
isDirty in interface IPersistStreamIOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void load(IStream pstm)
throws IOException,
AutomationException
IPersistStream is a Microsoft interface. Please refer to MSDN for information about this interface.
load in interface IPersistStreampstm - A reference to a com.esri.arcgis.system.IStream (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void save(IStream pstm,
int fClearDirty)
throws IOException,
AutomationException
IPersistStream is a Microsoft interface. Please refer to MSDN for information about this interface.
save in interface IPersistStreampstm - A reference to a com.esri.arcgis.system.IStream (in)fClearDirty - The fClearDirty (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void getSizeMax(_ULARGE_INTEGER[] pcbSize)
throws IOException,
AutomationException
IPersistStream is a Microsoft interface. Please refer to MSDN for information about this interface.
getSizeMax in interface IPersistStreampcbSize - A Structure: com.esri.arcgis.system._ULARGE_INTEGER (out: use single element array)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void interfaceSupportsErrorInfo(GUID riid)
throws IOException,
AutomationException
Indicates whether the interface supports IErrorInfo.
interfaceSupportsErrorInfo in interface ISupportErrorInforiid - A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public String getAuthorityName()
throws IOException,
AutomationException
getAuthorityName in interface ISpatialReferenceAuthorityIOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public String getVersion()
throws IOException,
AutomationException
getVersion in interface ISpatialReferenceAuthorityIOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public int getCode()
throws IOException,
AutomationException
getCode in interface ISpatialReferenceAuthorityIOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void define(String authorityName,
int authorityCode,
String authorityVersion)
throws IOException,
AutomationException
define in interface ISpatialReferenceAuthorityauthorityName - The authorityName (in)authorityCode - The authorityCode (in)authorityVersion - The authorityVersion (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
public void writeExternal(ObjectOutput out)
throws IOException
writeExternal in interface ExternalizableIOException
public void readExternal(ObjectInput in)
throws IOException,
ClassNotFoundException
readExternal in interface ExternalizableIOException
ClassNotFoundException
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||