ISurface.GetProfile Method

Returns a polyline with z values interpolated from the surface.

[Visual Basic .NET]
Public Sub GetProfile ( _
    ByVal pShape As IGeometry, _
    ByRef ppProfile As IGeometry, _
    [ByRef pStepSize As Object] _
)

[C#]
public void GetProfile (
    IGeometry pShape,
    ref IGeometry ppProfile,
    ref object pStepSize
);

[C++]
HRESULT GetProfile(
  IGeometry* pShape,
  IGeometry** ppProfile,
  VARIANT* pStepSize
);

[C++]
Parameters
pShape [in]
  pShape is a parameter of type IGeometry
ppProfile [out]
  ppProfile is a parameter of type IGeometry
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

Description

Takes an input polyline or polygon, interpolates heights for it from the surface, and outputs the result as 3D geometry.

The input geometry should be polyline or polygon based. Portions of the input not falling within the interpolation zone of the surface will be clipped. A Null pointer ('Nothing' in Visual Basic) is returned when the input falls entirely off the surface.

If specified, the input geometry will be densified by the stepSize. This takes place before interpolating heights from the surface. The densification ensures no two vertices are spaced more than stepSize apart.

Notes:

• On rasters, bilinear interpolation is used.
• If the surface is a raster stepSize should be considered. Generally, the smaller the interval the more detail that gets captured (unless smaller than 1/2 cellsize), but at an increased cost in processing time and size of resulting geometry. The default stepSize for raster based surface is set equal to the cellsize.
• On TINs the method of interpolation is controlled by ITinSurface3.InterpolationMethod.
• On TINs, if the interpolation meethod is linear, ITinSurface3.ProfileWeedTolerance may be useful in preventing oversampled output.
• On TINs, if the interpolation method is linear, the stepSize argument isn't very important since the default sampling scheme of using input vertices and triangle edge intersections is sufficient to capture all surface information. The use of stepSize is more relevant when the interpolation method is something other than linear.

See Also