ArcObjects Library Reference (GeoDatabase)  

ITinSurface3.Extract Method

Extract part of the TIN.

[Visual Basic .NET]
Public Function Extract ( _
    ByVal pBoundary As IPolygon, _
    ByVal boundaryEdgeType As esriTinEdgeType, _
    ByVal boundaryEdgeValue As Integer, _
    ByVal bConstrainedDelaunay As Boolean, _
    ByVal bAllowEdgeSwapping As Boolean _
) As ITin
[C#]
public ITin Extract (
    IPolygon pBoundary,
    esriTinEdgeType boundaryEdgeType,
    int boundaryEdgeValue,
    bool bConstrainedDelaunay,
    bool bAllowEdgeSwapping
);
[C++]
HRESULT Extract(
  IPolygon* pBoundary,
  esriTinEdgeType boundaryEdgeType,
  long boundaryEdgeValue,
  VARIANT_BOOL bConstrainedDelaunay,
  VARIANT_BOOL bAllowEdgeSwapping,
  ITin** ppSubTin
);
[C++]

Parameters

pBoundary [in]

  pBoundary is a parameter of type IPolygon

boundaryEdgeType [in]

  boundaryEdgeType is a parameter of type esriTinEdgeType

boundaryEdgeValue [in]   boundaryEdgeValue is a parameter of type long bConstrainedDelaunay [in]   bConstrainedDelaunay is a parameter of type VARIANT_BOOL bAllowEdgeSwapping [in]   bAllowEdgeSwapping is a parameter of type VARIANT_BOOL ppSubTin [out, retval]

  ppSubTin is a parameter of type ITin

Product Availability

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

Description

Extracts a subarea from the source TIN into a new TIN.

pBoundary is a polygon that defines the area to be extracted. This polygon will be profiled using linear interpolation on the source TIN. This profiled polygon, along with the data inside it from the source TIN, will then be used to construct the output TIN. If there's no overlap between the data area of the source TIN and the polygon the result will be NULL.

boundaryEdgeType is an esriTinEdgeType used to control whether the boundary polygon is enforced using hard, soft, or regular edges.

boundaryEdgeValue is the tag value associated with the boundary edges. Set this to 0 if you're not interested in using specific edge tag values.

bConstrainedDelaunay is used to control the type of output TIN when the input is delaunay conforming. In this case you have the option of keeping the result conforming or converting it to constrained. The benefit of having it constrained is you get a best fit match between input and output surface without the need to add densification points. If the input is already constrained this property has no effect; the result will be constrained.

Notes:

See Also

ITinSurface3 Interface