ITinFeatureEdit.ClusterPoints Method

Finds a cluster of nodes, each node in the group has at least one neighbor, to which the distance is smaller, or equal to, the specified value.

[Visual Basic .NET]
Public Function ClusterPoints ( _
    ByVal pSeed As ITinNode, _
    ByVal spacing As Double, _
    ByVal pFilter As ITinFilter _
) As IEnumTinNode

[C#]
public IEnumTinNode ClusterPoints (
    ITinNode pSeed,
    double spacing,
    ITinFilter pFilter
);

[C++]
HRESULT ClusterPoints(
  ITinNode* pSeed,
  double spacing,
  ITinFilter* pFilter,
  IEnumTinNode** ppNodes
);

[C++]

Parameters
pSeed [in]

  pSeed is a parameter of type ITinNode
spacing [in]
  spacing is a parameter of type double
pFilter [in]

  pFilter is a parameter of type ITinFilter
ppNodes [out, retval]

  ppNodes is a parameter of type IEnumTinNode

Product Availability

Description

Returns a node enumerator which represents the set wherein all members have at least one neighboring node that passes through the filter (optional) and is less than, or equal to, the spacing distance away from another in the set. The search for the set starts with the seed node and expands outward.

Use of a filter is optional. A NULL pointer (or 'Nothing' in VB) can be used to skip it. When used, the filter must be a type supported by nodes. Examples include TinValueFilter and TinNodeSourceFilter.

The clustering works in an iterative fashion. First, all nodes connected by triangle edges to the seed node are evaluated. Those that are within the specified distance, and satisfy the filter (if used), are included in the set. The operation is then repeated on the nodes just added. This continues until no more nodes are found.

See Also