|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.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 problemspublic 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 problemsMethod Detail |
---|
public static String getClsid()
public boolean equals(Object o)
equals
in class Object
public int hashCode()
hashCode
in class Object
public String getUsage() throws IOException, AutomationException
getUsage
in interface IVerticalCoordinateSystem
getUsage
in interface IVerticalCoordinateSystemGEN
IOException
- 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 IVerticalCoordinateSystem
getDatum
in interface IVerticalCoordinateSystemGEN
IOException
- 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 IVerticalCoordinateSystem
getCoordinateUnit
in interface IVerticalCoordinateSystemGEN
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setCoordinateUnit(ILinearUnit unit) throws IOException, AutomationException
setCoordinateUnit
in interface IVerticalCoordinateSystem
setCoordinateUnit
in interface IVerticalCoordinateSystemGEN
unit
- 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 IVerticalCoordinateSystem
getVerticalShift
in interface IVerticalCoordinateSystemGEN
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setVerticalShift(double vshift) throws IOException, AutomationException
setVerticalShift
in interface IVerticalCoordinateSystem
setVerticalShift
in interface IVerticalCoordinateSystemGEN
vshift
- 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 IVerticalCoordinateSystem
getPositiveDirection
in interface IVerticalCoordinateSystemGEN
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 IVerticalCoordinateSystemGEN
parameters
- 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 IVerticalCoordinateSystem
pd
- 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 IVerticalCoordinateSystem
parameters
- 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 ISpatialReferenceInfo
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public String getAlias() throws IOException, AutomationException
getAlias
in interface ISpatialReferenceInfo
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public String getAbbreviation() throws IOException, AutomationException
getAbbreviation
in interface ISpatialReferenceInfo
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public String getRemarks() throws IOException, AutomationException
getRemarks
in interface ISpatialReferenceInfo
IOException
- 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 ISpatialReferenceInfo
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getESRISpatialReferenceSize() throws IOException, AutomationException
getESRISpatialReferenceSize
in interface IESRISpatialReference
getESRISpatialReferenceSize
in interface IESRISpatialReferenceGEN
getESRISpatialReferenceSize
in interface IESRISpatialReferenceGEN2
IOException
- 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 IESRISpatialReference
importFromESRISpatialReference
in interface IESRISpatialReferenceGEN
importFromESRISpatialReference
in interface IESRISpatialReferenceGEN2
str
- 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 IESRISpatialReference
exportToESRISpatialReference
in interface IESRISpatialReferenceGEN
str
- 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 IESRISpatialReferenceGEN2
str
- 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 IVerticalCoordinateSystemEdit
name
- 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 IClone
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void assign(IClone src) throws IOException, AutomationException
assign
in interface IClone
src
- 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 IClone
other
- 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 IClone
other
- 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 IPersist
pClassID
- 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 IPersistStream
IOException
- 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 IPersistStream
pstm
- 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 IPersistStream
pstm
- 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 IPersistStream
pcbSize
- 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 ISupportErrorInfo
riid
- 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 ISpatialReferenceAuthority
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public String getVersion() throws IOException, AutomationException
getVersion
in interface ISpatialReferenceAuthority
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getCode() throws IOException, AutomationException
getCode
in interface ISpatialReferenceAuthority
IOException
- 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 ISpatialReferenceAuthority
authorityName
- 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 Externalizable
IOException
public void readExternal(ObjectInput in) throws IOException, ClassNotFoundException
readExternal
in interface Externalizable
IOException
ClassNotFoundException
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |