ArcObjects Library Reference (GeoDatabase)  

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#]

Optional Values

pFieldName   To indicate that this parameter is undefined, first define a variable object Missing = Type.Missing; then pass this in as ref Missing.
[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

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

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

ITinAdvanced Interface