com.esri.arcgis.geodatabaseextensions
Interface ITerrainEdit3

All Superinterfaces:

ITerrainEdit, ITerrainEdit2, Serializable

All Known Implementing Classes:

ITerrainEdit3Proxy, Terrain

public interface ITerrainEdit3
extends ITerrainEdit2, Serializable

Provides access to members used to modify and build a terrain.

Product Availability

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

Method Summary

void	addDataSourceData2(int index, String pointCountFieldName, IGeometry pAOI, IFeatureClass pInFC, ITrackCancel pTrackCancel) Appends measurements to terrain data source (feature class).
void	calculateFieldStatistics(int index, IStringArray pFieldNames, ITrackCancel pTrackCancel) Calculate Terrain blob field statistics of the specified embedded data source.
void	changeUsageInOverview(int index, boolean bApply) Change the ApplyToOverviewTerrain property of the specified data source.
void	deleteDataSourceData2(int index, String pointCountFieldName, IGeometry pAOI, ITrackCancel pTrackCancel) Removes measurements from a terrain data source (feature class).
void	deleteDataSourceDataByFC(int index, String pointCountFieldName, IFeatureClass pFC, boolean bSparseData, ITrackCancel pTrackCancel) Removes measurements from a terrain data source (feature class).
void	replaceDataSourceData2(int index, String pointCountFieldName, IGeometry pAOI, IFeatureClass pInFC, ITrackCancel pTrackCancel) Replaces measurements from a terrain data source (feature class) with measurements in another feature class.

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

updateExtent

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

addDataSource, addDataSourceData, addPyramidLevel, build, changeMaxScale, changeResolutionBounds, deleteDataSourceData, removeDataSource, removePyramidLevel, replaceDataSourceData

Method Detail

changeUsageInOverview

void changeUsageInOverview(int index,
                           boolean bApply)
                           throws IOException,
                                  AutomationException

Change the ApplyToOverviewTerrain property of the specified data source.

Description

Used to add or remove a feature class from participation in the terrain's overview.

index indicates which feature class to modify. The index must refer to a polyline or polygon based feature class as these are the types of features which have an option of being in the overview. Points and multipoints always participate in the overview.

Set bApply to TRUE to have the feature class participate in the overview and FALSE if not.

Product Availability

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

Parameters:

index - The index (in)

bApply - The bApply (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

deleteDataSourceDataByFC

void deleteDataSourceDataByFC(int index,
                              String pointCountFieldName,
                              IFeatureClass pFC,
                              boolean bSparseData,
                              ITrackCancel pTrackCancel)
                              throws IOException,
                                     AutomationException

Removes measurements from a terrain data source (feature class).

Product Availability

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

Parameters:

index - The index (in)

pointCountFieldName - The pointCountFieldName (in)

pFC - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)

bSparseData - The bSparseData (in)

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

deleteDataSourceData2

void deleteDataSourceData2(int index,
                           String pointCountFieldName,
                           IGeometry pAOI,
                           ITrackCancel pTrackCancel)
                           throws IOException,
                                  AutomationException

Removes measurements from a terrain data source (feature class).

Description

Used to delete points from a terrain dataset.

index is used to indicate which data source to delete points from. The data source must be a multipoint or point based feature class. It can be embedded or referenced.

pAOI is an envelope or polygon used to define an area of interest. Points inside pAOI will be deleted.

pTrackCancel is a reference to a CancelTracker to support progress reporting and the ability to halt the process. To bypass this feature pass a NULL pointer.

Notes:

The terrain will need to be rebuilt after calling this method.

A call should be made to ITerrainEdit2.UpdateExtent if extent in XY or Z has shrunk.

Product Availability

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

Parameters:

index - The index (in)

pointCountFieldName - The pointCountFieldName (in)

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

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addDataSourceData2

void addDataSourceData2(int index,
                        String pointCountFieldName,
                        IGeometry pAOI,
                        IFeatureClass pInFC,
                        ITrackCancel pTrackCancel)
                        throws IOException,
                               AutomationException

Appends measurements to terrain data source (feature class).

Description

Used to append points to a feature class that participates in the terrain.

index indicates which data source will be appended to. The data source must be a multipoint or point based feature class. It can be embedded or referenced.

pAOI is an envelope or polygon used to control the which points from pInFC get appended. pAOI can be NULL in which case all data from pInFC will be appended.

pInFC is the source of data that will be appended. It must be a multipoint or point based feature class.

pTrackCancel is a reference to a CancelTracker to support progress reporting and the ability to halt the process. To bypass this feature pass a NULL pointer.

Notes:

Attributes from the input are conditionally appended to the target feature class. If there's a match in field names between the input and output the values will be brought over.

The terrain will need to be rebuilt after calling this method.

Product Availability

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

Parameters:

index - The index (in)

pointCountFieldName - The pointCountFieldName (in)

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

pInFC - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

replaceDataSourceData2

void replaceDataSourceData2(int index,
                            String pointCountFieldName,
                            IGeometry pAOI,
                            IFeatureClass pInFC,
                            ITrackCancel pTrackCancel)
                            throws IOException,
                                   AutomationException

Replaces measurements from a terrain data source (feature class) with measurements in another feature class.

Description

Used to replace points from one feature class that participates in the terrain with points from another feature class.

index is used to indicate which data source will be modifed. The data source must be a multipoint or point based feature class. It can be embedded or referenced.

pAOI is an envelope or polygon used to define the area of interest. First, points inside pAOI will be removed from the terrain data source. Then, those points or multipoint vertices from pInFC that are inside pAOI get appended. pAOI can be NULL in which case all the points from the terrain data source will be deleted before appending all the points from pInFC.

pInFC is the source of data that will be appended. It must be a multipoint or point based feature class.

pTrackCancel is a reference to a CancelTracker to support progress reporting and the ability to halt the process. To bypass this feature pass a NULL pointer.

Notes:

Attributes from the input are conditionally appended to the target feature class. If there's a match in field names between the input and output the values will be brought over.

The terrain will need to be rebuilt after calling this method.

May require call to ITerrainEdit2.UpdateExtent if extent in XY or Z has shrunk.

Product Availability

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

Parameters:

index - The index (in)

pointCountFieldName - The pointCountFieldName (in)

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

pInFC - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

calculateFieldStatistics

void calculateFieldStatistics(int index,
                              IStringArray pFieldNames,
                              ITrackCancel pTrackCancel)
                              throws IOException,
                                     AutomationException

Calculate Terrain blob field statistics of the specified embedded data source.

Description

Calculates basic statistical information for attributes stored in embedded feature classes. The statistics are saved with the terrain and can be retrieved with ITerrainEmbeddedDataSource2.GetFieldStatistics or ITerrainEmbeddedDataSource2.GetReservedFieldStatistics.

index indicates which feature class to calculate statistics for. The index must refer to an embedded feature class.

pFieldNames indicates the fields for which statistics will be calculated. If you pass a NULL for the StrArray statistics will be calculated for all fields.

pTrackCancel is a reference to a CancelTracker to support progress reporting and the ability to halt the process. To bypass this feature pass a NULL pointer.

Notes:

This method should also be used to re-calculate existing attribute statistics when needed (e.g., due to edits). Find out if the statistics for a field are outdated with ITerrainFieldStatistics.NeedsUpdate.

Product Availability

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

Parameters:

index - The index (in)

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

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.