com.esri.arcgis.geodatabaseextensions
Interface ITerrain2

All Superinterfaces:

ITerrain, Serializable

All Known Implementing Classes:

ITerrain2Proxy, Terrain

public interface ITerrain2
extends ITerrain, Serializable

Provides access to members used to acquire information about a Terrain and to retrieve DynamicSurface objects from which raster and TIN surfaces are made.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Method Summary

String	getEmbeddedDataSourceShapeFieldName() Returns the 'Shape' field name of the embedded data sources.
void	searchFromEmbeddedDataSource(int index, IEnvelope pAOI, double resolution, IStringArray pSubFields, IFeatureCursor[] ppCursor, ILongArray[] ppFieldIndices) Returns a Search Cursor on the specified embedded data source.

Methods inherited from interface com.esri.arcgis.geodatabaseextensions.ITerrain

createDynamicSurface, extractFromEmbeddedDataSource, getDataSource, getDataSourceCount, getDirtyTiles, getExtent, getFeatureDataset, getID, getMaxOverviewTerrainPoints, getMaxPointsPerShape, getName, getPointCount, getPyramidLevel, getPyramidLevelCount, getPyramidType, getSize, getSpatialReference, getTileSize, isDirty, isValid, queryTileInfo

Method Detail

getEmbeddedDataSourceShapeFieldName

String getEmbeddedDataSourceShapeFieldName()
                                           throws IOException,
                                                  AutomationException

Returns the 'Shape' field name of the embedded data sources.

Description

Returns the name of the shape field for any and all embedded feature classes in the terrain. They all use the same name.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:

The pName

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

searchFromEmbeddedDataSource

void searchFromEmbeddedDataSource(int index,
                                  IEnvelope pAOI,
                                  double resolution,
                                  IStringArray pSubFields,
                                  IFeatureCursor[] ppCursor,
                                  ILongArray[] ppFieldIndices)
                                  throws IOException,
                                         AutomationException

Returns a Search Cursor on the specified embedded data source.

Description

Index is used to indicate which feature class to search and retrieve records from. The index must reference and embedded multipoint feature class.

pAOI is an envelope representing the area of interest. This can be NULL, in which case the full extent of the terrain is used.

resolution is the z-tolerance or windowsize of the pyramid level to query records from. Ideally, the value provided should exactly match an existing pyramid level. If not, the next highest resolution level to the value specified will be used.

pSubFields is an array of field names for desired attributes. Use ITerrain2.GetEmbeddedDataSourceShapeFieldName for the shape field if you're interested in retrieving the geometry.

ppCursor is the output feature cursor.

ppFieldIndices is a LongArray containing the cursor field index values for the requested attributes, listed in the same order as provided in pSubFields.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:

index - The index (in)

pAOI - A reference to a com.esri.arcgis.geometry.IEnvelope (in)

resolution - The resolution (in)

pSubFields - A reference to a com.esri.arcgis.system.IStringArray (in)

ppCursor - A reference to a com.esri.arcgis.geodatabase.IFeatureCursor (out: use single element array)

ppFieldIndices - A reference to a com.esri.arcgis.system.ILongArray (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.