This document is archived and information here might be outdated.  Recommended version.


IDynamicSurface3.ContourList Method (ArcObjects .NET 10.4 SDK)
ArcObjects Library Reference (GeoDatabaseExtensions)  

IDynamicSurface3.ContourList Method

Generate contours of the terrain surface.

[Visual Basic .NET]
Public Sub ContourList ( _
    ByVal pAOI As IEnvelope, _
    ByVal Resolution As Double, _
    ByVal pBreaks As IDoubleArray, _
    ByVal pOutFeatureClass As IFeatureClass, _
    ByVal FieldName As String, _
    ByVal digitsAfterDecimalPoint As Integer, _
    ByVal pTrackCancel As ITrackCancel _
)
[C#]
public void ContourList (
    IEnvelope pAOI,
    double Resolution,
    IDoubleArray pBreaks,
    IFeatureClass pOutFeatureClass,
    string FieldName,
    int digitsAfterDecimalPoint,
    ITrackCancel pTrackCancel
);
[C++]
HRESULT ContourList(
  IEnvelope* pAOI,
  double Resolution,
  IDoubleArray* pBreaks,
  IFeatureClass* pOutFeatureClass,
  BSTR FieldName,
  long digitsAfterDecimalPoint,
  ITrackCancel* pTrackCancel
);
[C++]

Parameters pAOI [in]
pAOI is a parameter of type IEnvelope Resolution [in] Resolution is a parameter of type double pBreaks [in]
pBreaks is a parameter of type IDoubleArray pOutFeatureClass [in]
pOutFeatureClass is a parameter of type IFeatureClass FieldName [in] FieldName is a parameter of type BSTR digitsAfterDecimalPoint [in] digitsAfterDecimalPoint is a parameter of type long pTrackCancel [in]
pTrackCancel is a parameter of type ITrackCancel

Product Availability

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

Description

Generates contours at specified heights.

pAOI is the area of interest. This is the area that will be contoured. Pass a NULL pointer if you want the entire terrain to be contoured.

Resolution is used to indicate which pyramid level of the surface to use. This should match the resolution of an existing pyramid level. If there's not an exact match the next smaller resolution level (more detailed) that's actually in the terrain will be used.

pBreaks is an array containing the heights of the desired contours.

pOutFeatureClass is the target 2D polyline feature class where the contours will be written.

FieldName is the name of the field where the height for each contour is written. The field type can be long or double. If it's a long, the digitsAfterDecimalPoint parameter must be 0.

digitsAfterDecimalPoint controls the way contour heights are treated when the contour field type is a double. Use this to round to the nearest decimal. A zero must be used if the elevation field type is long.

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 height field must be type double.

Local pits at same height of contour may result in degenerate contours. Find and eliminate searching for 0 length lines in the resulting feature class.

This method honors setting for MinimizeResourceUsage.

See Also

IDynamicSurface3 Interface