|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
public interface ITerrainEdit
Provides access to members used to modify and build a terrain.
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.
| 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 |
|---|
void addDataSource(ITerrainDataSource pDataSource)
throws IOException,
AutomationException
Adding a TerrainDataSource will invalidate the terrain and require a build. See ITerrainEdit.Build.
pDataSource - A reference to a com.esri.arcgis.geodatabaseextensions.ITerrainDataSource (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
void removeDataSource(int index)
throws IOException,
AutomationException
Removing a data source will invalidate the terrain and require a build. See ITerrainEdit.Build.
index - The index (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
void addPyramidLevel(ITerrainPyramidLevel pPyramidLevel)
throws IOException,
AutomationException
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.
pPyramidLevel - A reference to a com.esri.arcgis.geodatabaseextensions.ITerrainPyramidLevel (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
void removePyramidLevel(int index)
throws IOException,
AutomationException
index - The index (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
void changeMaxScale(int index,
int newScale)
throws IOException,
AutomationException
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.
index - The index (in)newScale - The newScale (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
void changeResolutionBounds(int index,
double lowerBound,
double upperBound)
throws IOException,
AutomationException
index - The index (in)lowerBound - The lowerBound (in)upperBound - The upperBound (in)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
void deleteDataSourceData(int index,
IEnvelope pAOI,
ITrackCancel pTrackCancel)
throws IOException,
AutomationException
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
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)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
void addDataSourceData(int index,
IEnvelope pAOI,
IFeatureClass pInFC,
ITrackCancel pTrackCancel)
throws IOException,
AutomationException
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
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)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
void replaceDataSourceData(int index,
IEnvelope pAOI,
IFeatureClass pInFC,
ITrackCancel pTrackCancel)
throws IOException,
AutomationException
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
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)
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
void build(ITrackCancel pTrackCancel)
throws IOException,
AutomationException
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
pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)
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 | ||||||||