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


ITinSurface3.Extract Method (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Geodatabase > ESRI.ArcGIS.GeoDatabase > Interfaces > IT > ITinSurface3 Interface > ITinSurface3.Extract Method
ArcGIS Developer Help

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
);
[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 bool bAllowEdgeSwapping [in]
bAllowEdgeSwapping is a parameter of type bool

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. The drawback is the natural neighbors interpolator can't be used on a constrained TIN. If the input is already constrained this property has no effect; the result will be constrained.

bAllowEdgeSwapping is used to control the quality of fit between the input and output surfaces when both are delaunay conforming. This means the input must be delaunay and bConstrainedDelaunay is set to FALSE. If these conditions are met, setting bAllowEdgeSwapping to FALSE will force a best fit match between the surfaces at the expense of the output having nodes added where necessary to enforce that match. Setting it to TRUE will permit some differences between the input and output surfaces. Relaxing the need for an exact match has the benefit of requiring less nodes be added to the output TIN.

Notes:

See Also

ITinSurface3 Interface