|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.esri.arcgis.geodatabaseextensions.TerrainAsciiDataImporter
public class TerrainAsciiDataImporter
Esri Terrain ASCII Data Importer object.
The ITerrainAsciiDataImporter interface is inherited from ITerrainDataImporter and adds an ASCII file specific property.
Constructor Summary | |
---|---|
TerrainAsciiDataImporter()
Constructs a TerrainAsciiDataImporter using ArcGIS Engine. |
|
TerrainAsciiDataImporter(Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts. TerrainAsciiDataImporter theTerrainAsciiDataImporter = (TerrainAsciiDataImporter) obj; |
Method Summary | |
---|---|
void |
addFile(String fileName)
Include a specific file to be loaded upon Import. |
void |
addFolder(String folderName,
String fileExtension,
boolean bRecursive)
Include a folder, and potentially subfolders, to be loaded upon import. |
boolean |
equals(Object o)
Compare this object with another |
void |
esri_import(IFeatureClass pOutputFeatureClass,
double tileSize,
double zFactor,
IEnvelope pAOI,
ITrackCancel pTrackCancel,
int[] pcOutsidePoints)
Loads the specified data, based on the current properties, into the target feature class. |
static String |
getClsid()
getClsid. |
IEnvelope |
getDataExtent(ISpatialReference pTargetSpatialReference)
The XYZ extent of data contained in files/folders to be added. |
int |
getDecimalPointType()
ASCII data decimal point type. |
int |
getFileFormat()
The format of the data to be imported. |
int |
getMaxShapePointCount()
The maximum number of points loaded into individual multipoint shapes. |
double |
getPointCount()
The number of points in the files/folders to be added. |
int |
hashCode()
the hashcode for this object |
void |
overwriteMaxShapePointCount(int newCount)
Changes the default maximum number of points loaded into individual multipoint shapes. |
void |
setDecimalPointType(int pType)
ASCII data decimal point type. |
void |
setEmpty()
Clears all properties. |
void |
setFileFormat(int pFormat)
The format of the data to be imported. |
void |
setSourceDataSpatialReference(ISpatialReference pSpatialRef)
Set source data's spatial reference. |
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 TerrainAsciiDataImporter() throws IOException, UnknownHostException
IOException
- if there are interop problems
UnknownHostException
- if there are interop problemspublic TerrainAsciiDataImporter(Object obj) throws IOException
TerrainAsciiDataImporter theTerrainAsciiDataImporter = (TerrainAsciiDataImporter) obj;
obj
to TerrainAsciiDataImporter
.
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 void setSourceDataSpatialReference(ISpatialReference pSpatialRef) throws IOException, AutomationException
setSourceDataSpatialReference
in interface ITerrainDataImporter
pSpatialRef
- A reference to a com.esri.arcgis.geometry.ISpatialReference (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setEmpty() throws IOException, AutomationException
SetEmpty clears all the properties but keeps the object alive. Use this when needing to clear the file or folder lists of the importer while in a loop. Keep in the mind the other properties will also need to be reset. Nevertheless, this is less expensive than instantiating the object repeatedly.
setEmpty
in interface ITerrainDataImporter
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getMaxShapePointCount() throws IOException, AutomationException
The importer writes out multipoint records. The MaxShapePointCount represents the largest number of points an individual multipoint record can contain. The default is 5000. Use OverwriteMaxShapePointCount to change this value.
getMaxShapePointCount
in interface ITerrainDataImporter
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void overwriteMaxShapePointCount(int newCount) throws IOException, AutomationException
This will reset the MaxShapePointCount in case you don't want to use the default of 5000.
overwriteMaxShapePointCount
in interface ITerrainDataImporter
newCount
- The newCount (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void addFile(String fileName) throws IOException, AutomationException
The importer supports the input of one or more files at a time. Call AddFile, and repeat as necessary, to handle individual files. Provide the full path. Call SetEmpty to clear this list.
addFile
in interface ITerrainDataImporter
fileName
- The fileName (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void addFolder(String folderName, String fileExtension, boolean bRecursive) throws IOException, AutomationException
The importer supports the input of one or more folders worth of files at a time. You can call AddFolder repeatedly. Call SetEmpty to clear this list.
fileExtension is the suffix of the file(s), excluding the dot ('.'). Only files with this suffix in the selected folder(s) will be read.
bRecursive is a boolean to indicate whether or not to recurse below the specified folders into their subfolders to look for more files.
addFolder
in interface ITerrainDataImporter
folderName
- The folderName (in)fileExtension
- The fileExtension (in)bRecursive
- The bRecursive (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public IEnvelope getDataExtent(ISpatialReference pTargetSpatialReference) throws IOException, AutomationException
Returns the data extent of points in the files referenced by the importer. See AddFile and AddFolder.
LAS format LIDAR files contain the data extent in the header. From them, the extent can be extracted quickly. ASCII files, on the other hand, must be scanned to discover the extent. The time this will take is proportional to the amount of data to scan through.
getDataExtent
in interface ITerrainDataImporter
pTargetSpatialReference
- A reference to a com.esri.arcgis.geometry.ISpatialReference (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public double getPointCount() throws IOException, AutomationException
Returns the number of points in the files referenced by the importer. See AddFile and AddFolder.
For LAS data the desired return numbers and/or class codes, as set by ITerrainLasDataImporter, will be taken into consideration. You must include some returns via ITerrainLasDataImporter.AddReturnNumber. The LAS specification records the number of points by return in the header so getting counts by return will be fast. On the other hand, if class codes are specified (see ITerrainLasDataImporter.AddClassCodes) the files must be scanned to determine the count. The time this will take is proportional to the amount of data to scan through.
Introduced in LAS version 1.1 is a Witheld flag as a point property. GetPointCount does not take this flag into consideration when totaling points.
getPointCount
in interface ITerrainDataImporter
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void esri_import(IFeatureClass pOutputFeatureClass, double tileSize, double zFactor, IEnvelope pAOI, ITrackCancel pTrackCancel, int[] pcOutsidePoints) throws IOException, AutomationException
esri_import
in interface ITerrainDataImporter
pOutputFeatureClass
- A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)tileSize
- The tileSize (in)zFactor
- The zFactor (in)pAOI
- A reference to a com.esri.arcgis.geometry.IEnvelope (in)pTrackCancel
- A reference to a com.esri.arcgis.system.ITrackCancel (in)pcOutsidePoints
- The pcOutsidePoints (out: use single element array)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setFileFormat(int pFormat) throws IOException, AutomationException
setFileFormat
in interface ITerrainAsciiDataImporter
pFormat
- A com.esri.arcgis.geodatabaseextensions.esriTerrainAsciiDataFormatType constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getFileFormat() throws IOException, AutomationException
The supported file formats are esriTerrainAsciiDataFormatXYZ, esriTerrainAsciiDataFormatGenerate, and esriTerrainAsciiFormatXYZI.
If the format is XYZI the target feature class must have a BLOB type field named 'Intensity'. This will be used to hold the intensity values. The TerrainBlobReader can be used to interpret the values placed in the BLOBs. The Intensity field of the resulting feature class can also be included in a terrain dataset if the feature class were embedded. If the intensity values in the file are of no interest, and should be ignored, then specify the format as XYZ. In this case, the importer will not require the Intensity field and the intensity values in the file(s) will be skipped.
getFileFormat
in interface ITerrainAsciiDataImporter
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setDecimalPointType(int pType) throws IOException, AutomationException
setDecimalPointType
in interface ITerrainAsciiDataImporter2
pType
- A com.esri.arcgis.geodatabaseextensions.esriTerrainDecimalSeparatorType constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getDecimalPointType() throws IOException, AutomationException
Specifies whether the symbol used to mark the boundary between the integer and the fractional parts of a decimal numeral is a point or a comma. The default is point.
getDecimalPointType
in interface ITerrainAsciiDataImporter2
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |