com.esri.arcgis.geodatabaseextensions
Interface ITerrainEdit

All Superinterfaces:
Serializable
All Known Subinterfaces:
ITerrainEdit2, ITerrainEdit3
All Known Implementing Classes:
ITerrainEdit2Proxy, ITerrainEdit3Proxy, ITerrainEditProxy, Terrain

public interface ITerrainEdit
extends Serializable

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

Superseded By

ITerrainEdit2

Description

The ITerrainEdit interface is used to add or remove references to participating feature classes, control pyramid level definitions, and to (re)construct the terrain when necessary.

Product Availability

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


Method Summary
 void addDataSource(ITerrainDataSource pDataSource)
          Adds a reference to a feature class.
 void addDataSourceData(int index, IEnvelope pAOI, IFeatureClass pInFC, ITrackCancel pTrackCancel)
          Appends measurements to a terrain data source (feature class).
 void addPyramidLevel(ITerrainPyramidLevel pPyramidLevel)
          Adds a pyramid level.
 void build(ITrackCancel pTrackCancel)
          Constructs the terrain.
 void changeMaxScale(int index, int newScale)
          Modifies the largest display scale used for a particular level of a terrain pyramid.
 void changeResolutionBounds(int index, double lowerBound, double upperBound)
          Change the resolution bounds of a data source.
 void deleteDataSourceData(int index, IEnvelope pAOI, ITrackCancel pTrackCancel)
          Removes measurements from a terrain data source (feature class).
 void removeDataSource(int index)
          Removes reference to a participating feature class.
 void removePyramidLevel(int index)
          Removes a pyramid level.
 void replaceDataSourceData(int index, IEnvelope pAOI, IFeatureClass pInFC, ITrackCancel pTrackCancel)
          Replaces measurements from a terrain data source (feature class) with measurements in another feature class.
 

Method Detail

addDataSource

void addDataSource(ITerrainDataSource pDataSource)
                   throws IOException,
                          AutomationException
Adds a reference to a feature class.

Description

Adding a TerrainDataSource will invalidate the terrain and require a build. See ITerrainEdit.Build.

Product Availability

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

Parameters:
pDataSource - A reference to a com.esri.arcgis.geodatabaseextensions.ITerrainDataSource (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

removeDataSource

void removeDataSource(int index)
                      throws IOException,
                             AutomationException
Removes reference to a participating feature class.

Description

Removing a data source will invalidate the terrain and require a build. See ITerrainEdit.Build.

Product Availability

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

Parameters:
index - The index (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addPyramidLevel

void addPyramidLevel(ITerrainPyramidLevel pPyramidLevel)
                     throws IOException,
                            AutomationException
Adds a pyramid level.

Description

A terrain has a pyramid. The pyramid is comprised of one or more pyramid levels. The definition for each level is added by this function. You must have at least one pyramid level defined for a terrain before it can be built. Instantiate a pyramid level definition using the TerrainPyramidLevelZTolerance coclass.

Product Availability

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

Parameters:
pPyramidLevel - A reference to a com.esri.arcgis.geodatabaseextensions.ITerrainPyramidLevel (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

removePyramidLevel

void removePyramidLevel(int index)
                        throws IOException,
                               AutomationException
Removes a pyramid level.

Product Availability

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

Parameters:
index - The index (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

changeMaxScale

void changeMaxScale(int index,
                    int newScale)
                    throws IOException,
                           AutomationException
Modifies the largest display scale used for a particular level of a terrain pyramid.

Description

A reference scale is associated with each terrain pyramid level. This is the maximum display scale at which a pyramid level is used when displaying a terrain in a map. At a larger display scale (i.e. more zoomed in) a more accurate pyramid is used.

The input index represents the pyramid level desired, from finer to coarser resolution, excluding the full resolution level. So, index 0 refers to the pyramid level with the smallest ZTolerance that is greater than 0.0. The valid index range is 0 to ITerrain.ZToleranceCount-1.

The value passed for newScale is the denominator of the scale. For example, to define a pyramid used for displays at scales up to 1:24000 pass a value of 24000.

Modifying the maximum scale for a pyramid does not necessitate a rebuild of the terrain.

Product Availability

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

Parameters:
index - The index (in)
newScale - The newScale (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

changeResolutionBounds

void changeResolutionBounds(int index,
                            double lowerBound,
                            double upperBound)
                            throws IOException,
                                   AutomationException
Change the resolution bounds of a data source.

Product Availability

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

Parameters:
index - The index (in)
lowerBound - The lowerBound (in)
upperBound - The upperBound (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

deleteDataSourceData

void deleteDataSourceData(int index,
                          IEnvelope pAOI,
                          ITrackCancel pTrackCancel)
                          throws IOException,
                                 AutomationException
Removes measurements from a terrain data source (feature class).

Description

The input index is the terrain data source index of the embedded feature class. Valid values range from 0 to ITerrain.DataSourceCount-1.

The pAOI argument is the area of interest envelope that's used to indicate where to remove measurements.

pTrackCancel is a pointer to a CancelTracker object.

Notes

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)
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.

addDataSourceData

void addDataSourceData(int index,
                       IEnvelope pAOI,
                       IFeatureClass pInFC,
                       ITrackCancel pTrackCancel)
                       throws IOException,
                              AutomationException
Appends measurements to a terrain data source (feature class).

Description

The input index is the terrain data source index of the target embedded feature class. Valid values range from 0 to ITerrain.DataSourceCount-1.

The pAOI argument is the area of interest envelope that's used as a filter when pulling measurements from the input feature class. It can be set to a NULL pointer (i.e. 'Nothing' in VB) in which case the extent of the input feature class is used.

pInFC is a pointer to the input feature class from which measurements will be added. The feature class shape type must be point or multipoint.

pTrackCancel is a pointer to a CancelTracker object.

Notes

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)
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.

replaceDataSourceData

void replaceDataSourceData(int index,
                           IEnvelope pAOI,
                           IFeatureClass pInFC,
                           ITrackCancel pTrackCancel)
                           throws IOException,
                                  AutomationException
Replaces measurements from a terrain data source (feature class) with measurements in another feature class.

Description

The input index is the terrain data source index of the embedded feature class. Valid values range from 0 to ITerrain.DataSourceCount-1.

The pAOI argument is the area of interest envelope that's used to indicate where measurements are to be replaced.

pInFC is a pointer to the input feature class from which measurements will be taken. The feature class shape type must be point or multipoint.

pTrackCancel is a pointer to a CancelTracker object.

Notes

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)
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.

build

void build(ITrackCancel pTrackCancel)
           throws IOException,
                  AutomationException
Constructs the terrain.

Description

Build (re)constructs the terrain as necessary. Depending on what types of edits have taken place different levels of build may be required. Some forms require a full rebuild and others just partial.

Add/Remove ZTolerance - full
Add/Remove TerrainDataSource - partial for area covered by data source measurements
ChangeMaxZScale - none
Edit of data source feature class geometry - partial for area covered by feature edits

Product Availability

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

Parameters:
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.