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


ISurface.Contour Method (ArcObjects .NET 10.7 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Geodatabase > ESRI.ArcGIS.GeoDatabase > Interfaces > IS > ISurface Interface > ISurface.Contour Method
ArcGIS Developer Help

ISurface.Contour Method

Output contours based on the specified root value and interval.

[Visual Basic .NET]
Public Sub Contour ( _
    ByVal referenceContourHeight As Double, _
    ByVal interval As Double, _
    ByVal pFeatureClass As IFeatureClass, _
    ByVal FieldName As String, _
    ByVal digitsAfterDecimalPoint As Integer _
)
[C#]
public void Contour (
    double referenceContourHeight,
    double interval,
    IFeatureClass pFeatureClass,
    string FieldName,
    int digitsAfterDecimalPoint
);
[C++]
HRESULT Contour(
  double referenceContourHeight,
  double interval,
  IFeatureClass* pFeatureClass,
  BSTR FieldName,
  long digitsAfterDecimalPoint
);
[C++]
Parameters
referenceContourHeight [in]

referenceContourHeight is a parameter of type double interval [in]
interval is a parameter of type double pFeatureClass
pFeatureClass is a parameter of type IFeatureClass* FieldName [in]
FieldName is a parameter of type BSTR digitsAfterDecimalPoint [in]
digitsAfterDecimalPoint is a parameter of type long

Product Availability

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

Description

Creates contours, based on a specified interval, sending the ouput to a polyline based feature class.

The rootHeight is the height from which potential contours are generated, both above and below, at the specified interval. It does not mean minimum contour. Rather it permits you to have contours that aren't based on 0.0. For example, if you want a 5 unit contour interval, but need them at heights of -8, -3, 2, 7, and 12 you'd provide a rootHeight of -3 or 2, or even -13. Note the root height need not be a height within the surface z range. You can use any value but only those contours that fall within the surface's z range will be created. The default rootHeight is 0.0.

The interval defines at what frequency, in height, the contours will be generated. Smaller intervals produce more contours.

Contours will be written to the specified 2D polyline feature class. It should be an empty feature class and is typically created immediately before calling Contour.

Do not have WorkspaceEdit turned on as this member needs to add a field to the feature class, a scheme editing operation not supported by WorkspaceEdit.

fieldHeight is used to name the field added to the feature class to store each contour's height.

digitsAfterDecimalPoint controls the precision of the output height values. Use a value of 0 if you want heights recorded as integers, as is likely when both the rootHeight and interval values are integers.

See Also

ISurface Interface