ITinNodeCollection.ConvertToVoronoiRegions Method

Writes the set of Voronoi polygons for each node to a feature class.

[Visual Basic .NET]
Public Sub ConvertToVoronoiRegions ( _
    ByVal pFeatureClass As IFeatureClass, _
    ByVal pFilter As ITinFilter, _
    ByVal pClippingPolygon As IPolygon, _
    ByVal indexFieldName As String, _
    ByVal tagFieldName As String _
)

[C#]
public void ConvertToVoronoiRegions (
    IFeatureClass pFeatureClass,
    ITinFilter pFilter,
    IPolygon pClippingPolygon,
    string indexFieldName,
    string tagFieldName
);

[C++]
HRESULT ConvertToVoronoiRegions(
  IFeatureClass* pFeatureClass,
  ITinFilter* pFilter,
  IPolygon* pClippingPolygon,
  BSTR indexFieldName,
  BSTR tagFieldName
);

[C++]

Parameters
pFeatureClass 

  pFeatureClass is a parameter of type IFeatureClass*
pFilter [in]

  pFilter is a parameter of type ITinFilter*
pClippingPolygon [in]

  pClippingPolygon is a parameter of type IPolygon*
indexFieldName [in]

  indexFieldName is a parameter of type BSTR
tagFieldName [in]

  tagFieldName is a parameter of type BSTR

Product Availability

Description

The FeatureClass should be an empty 2D polygon feature class. The Voronoi/Thiessen polygons will be written to it.

The Filter is used to determine which nodes to generate Voronoi/Thiessen polygons for. A Null pointer ('Nothing' in VisualBasic) can be passed in which case all nodes will be processed.

Output polygons will be intersected with the specified ClippingPolygon. A Null pointer ('Nothing' in VB) can be passed in which case a default polygon, which is a rectangulat bounding box that is slightly larger than the TINs FullExtent, will be used.

The indexFieldName is the name of the field added to the output feature class that's used to record the source node index for the polygon. If an empty string is passed the name "NodeIndex" is used as a default.

The tagFieldName is the name of the field added to the output feature class that's used to record the source node tag value for the polygon. If an empty string is passed the name "TagValue" is used as a default.

When constructing the TIN from a feature class it can be useful to specify the OIDField as the source of node tags. This way the output Voronoi/Thiessen polygons can be joined to the source features by associating the Thiessen polygon's TagField to the input feature's OIDField.

Since this method added fields to the specified feature class make sure WorkspaceEdit is off as it does not permit this type of schema modification.

See Also