ITinFeatureEdit.ConvertToPolygons Method

Converts qualified triangles to a polygon feature class.

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

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

[C++]
HRESULT ConvertToPolygons(
  IFeatureClass* pFeatureClass,
  ITinDynamicFilter* pFilter,
  VARIANT_BOOL bStopAtEnforcedEdge,
  VARIANT_BOOL bSkipDensifiedNodes,
  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
bSkipDensifiedNodes [in]
  bSkipDensifiedNodes 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

Extracts embedded TIN polygons and writes them out to the specified feature class.

The specified feature class must exist and be polygon based.

If the feature class is Z enabled the polygons written to it will be 3D (the boundary vertices will have Z's), otherwise they will be 2D.

The specified filter must support triangles and implement ITinDynamicFilter. For example, you can use a TinTriangleFilter to extract areas of like slope or aspect or a TinValueFilter to extract areas based on triangle tag values. 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).

The option to stop at enforced edges means that breakline edges act as polygon barriers/boundaries. For example, a set of contiguous triangles tagged with the code to represent 'building footprint' will be output as two polygons if a breakline separates them. This way, two adjacent buildings can remain distinct from one another.

The option to skip densification nodes is for excluding points added by the triangulator to breaklines in order to make them Delaunay conforming. This option only works on TINs that have been created/edited in memory without having been saved to disk.

A field will be added to the feature class and is used to store a numeric code for the output features. In the case of edge type, a value of 1 is used for soft breaklines and 2 for hard. The added field will be called 'Value' or 'Code' (depending on filter) unless you provide a different name via the optional field name argument.

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

See Also