This document is archived and information here might be outdated. Recommended version. |
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
);
[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*
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.