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


IDynamicSurface2.InterpolateFeatureClass Method (ArcObjects .NET 10.4 SDK)
ArcObjects Library Reference (GeoDatabaseExtensions)  

IDynamicSurface2.InterpolateFeatureClass Method

Interpolates z values for features.

[Visual Basic .NET]
Public Sub InterpolateFeatureClass ( _
    ByVal pInFeatureClass As IFeatureClass, _
    ByVal pFilter As IQueryFilter, _
    ByVal Resolution As Double, _
    ByVal Type As esriSurfaceInterpolationType, _
    ByVal pOutFeatureClass As IFeatureClass, _
    ByVal pTrackCancel As ITrackCancel, _
    [ByRef pStepSize As Object] _
)
[C#]
public void InterpolateFeatureClass (
    IFeatureClass pInFeatureClass,
    IQueryFilter pFilter,
    double Resolution,
    esriSurfaceInterpolationType Type,
    IFeatureClass pOutFeatureClass,
    ITrackCancel pTrackCancel,
    ref object pStepSize
);
[C#]

Optional Values

pStepSize   To indicate that this parameter is undefined, first define a variable object Missing=Type.Missing; then pass this in as ref Missing.
[C++]
HRESULT InterpolateFeatureClass(
  IFeatureClass* pInFeatureClass,
  IQueryFilter* pFilter,
  double Resolution,
  esriSurfaceInterpolationType Type,
  IFeatureClass* pOutFeatureClass,
  ITrackCancel* pTrackCancel,
  VARIANT* pStepSize
);
[C++]

Parameters pInFeatureClass [in]
pInFeatureClass is a parameter of type IFeatureClass pFilter [in]
pFilter is a parameter of type IQueryFilter Resolution [in] Resolution is a parameter of type double Type [in]
Type is a parameter of type esriSurfaceInterpolationType pOutFeatureClass [in]
pOutFeatureClass is a parameter of type IFeatureClass pTrackCancel [in]
pTrackCancel is a parameter of type ITrackCancel pStepSize [optional] pStepSize is a parameter of type VARIANT
To indicate this parameter is undefined pass a reference to a VARIANT with type VT_ERROR and scode value of DISP_E_PARAMNOTFOUND.

Product Availability

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

Description

InterpolateFeatureClass interpolates heights for shapes from an input feature class into a new feature class. The output will contain 3D geometry.

pInFeatureClass contains the input features. The shape types supported are points, multipoints, polylines, and polygons.

pFilter is a query filter used on the input features. It may be set to NULL ('Nothing n VB).

Resolution controls which pyramid level of the terrain to use as a surface. Depending on the type of filter used to generate the terrain pyramid, resolution represents either the z-tolerance or window size of the desired pyramid level. Pass a value of 0.0 to use the full resolution surface.

Type is used to control which interpolant is applied; linear or natural neighbors.

pOutFeatureClass is where features are written. It must be z-enabled (i.e.; IGeometryDef.HasZ=TRUE). Attribute fields and values will be copied from the input to the output. Input features that fall completely off the surface will not be written to the output.

pTrackCancel supports process interruption. This can be set to NULL ('Nothing' in VB).

stepSize is used to densify input polylines and polygon boundaries. If stepsize is omitted input polylines and polygon boundaries will be densified where they intersect terrain triangle edges. Typically, stepSize should be omitted when using linear interpolation because the 'natural' densification applied with triangle edges is sufficient to capture what information is available in the surface.

 

See Also

IDynamicSurface2 Interface