ITinAdvanced.ConvertToPolygons Method

Converts similar triangles to a polygon feature class.

[Visual Basic .NET]
Public Sub ConvertToPolygons ( _
    ByVal pFeatureClass As IFeatureClass, _
    ByVal pFilter As ITinDynamicFilter, _
    ByVal bStopAtEnforcedEdge As Boolean, _
    [ByRef pFieldName As Object] _
)

[C#]
public void ConvertToPolygons (
    IFeatureClass pFeatureClass,
    ITinDynamicFilter pFilter,
    bool bStopAtEnforcedEdge,
    ref object pFieldName
);

[C++]
HRESULT ConvertToPolygons(
  IFeatureClass* pFeatureClass,
  ITinDynamicFilter* pFilter,
  VARIANT_BOOL bStopAtEnforcedEdge,
  VARIANT* pFieldName
);

[C++]
Parameters
pFeatureClass 
  pFeatureClass is a parameter of type IFeatureClass
pFilter [in]
  pFilter is a parameter of type ITinDynamicFilter
bStopAtEnforcedEdge [in]
  bStopAtEnforcedEdge is a parameter of type VARIANT_BOOL
pFieldName [optional]
  pFieldName 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

Converts a TIN to a polygon based feature class. Contiguous clusters of triangles that fall into the same class, as defined by the passed filter, define the polygons.

FeatureClass must be a 2D polygon feature class. This is the target for the output polygons.

The filter needs to implement ITinDynamicFilter. Examples of these are TinValueFilter and TinTriangleFilter. Through use of these filters you can classify triangles based on a variety of attributes including, but not limited to, tag value, slope, and aspect. Contiguous clusters of triangles belonging to the same class are grouped into polygons and written to the feature class. If the ActiveBound for either of these filters is set to esriTinUniqueValue it means contiguous triangles with identical values will be extracted as polygons - for all unique values (with the exception of zero if ITinValueFilter2.ZeroTagValueExcluded is set to TRUE).

If the StopAtEnforcedEdges Boolean is set to TRUE then adjacent clusters of triangles belonging to the same class, but separated by enforced edges (breaklines), will be output as separate polygons.

Polygon class codes are written to a field that is added to the feature class. It is named Code by default but you can use the optional FieldName argument to give it a different name.

Do not have WorkspaceEdit turned on as this member needs to add a field to the output feature class, which is a schema edit operation that WorkspaceEdit does not permit.

See Also