DBidentifyPointsInObjectUsingKnots

Look sharp for co-ordinates.

In the object object all points which lie in the surroundings from (x, y) are identified. In detail the following actions are explained:

If toleranz 0 are, the point which lies to the point (x, y) most near is returned. By the call must stand in anzahl at least 1, so that generally a point can be stored away. If no points are found in the object, is returned in anzahl 0, but stands in anzahl 1 and the first element in the field points it is booked with the pointer on this point. Is toleranz >0, all points which have a distance from less than toleranz to (x, y) are searched. It is initialized anzahl before the call with 0, the points are only counted and their number is written in anzahl. Is anzahl >0, are written first anzahl points in the field points and the number of the found points is returned in anzahl, was never given, nevertheless, more than for the call there.

Parametre

object (POBJECT) [IN]

The object whose points should be identified.

x (STANDS IN) [IN]

X co-ordinate of the authoritative point.

y (STANDS IN) [IN]

Y co-ordinate of the authoritative point

toleranz (STANDS IN) [IN]

Distance around the authoritative point in which the points should be found. If toleranz=0 is, the next point is determined if toleranz> 0 are, all points whose distance from (x, y) is not greater than toleranz are determined. Is toleranz< 0, no point can be found.

anzahl (int *) [IN / OUT]

IN: Number of the points in the field points which fit there at most. If more points are found, are not returned supernumerary. Is anzahl = 0, the points are only counted.

OUT: Number of the really returned points. This is with toleranz = 0 always 0 or 1.

points (T_PPOINT *) [IN / OUT]

Pointer on a field which should take up the pointers of the points which are found with identifying. If the points are only counted, this pointer is irrelevant. But he must point at a field with enough storage space.

typeSelect (int) [IN]

Gives which element types are considered. In these variables become all constants TYPE_SELECT _??? the geodert which should be enclosed in the search. If all element types should be considered, the constant TYPE_SELECT_ALL can be also used.

parameterList (PIDENTIFY_PARAMETER) [IN]

The structure IDENTIFY_PARAMETER contains a list all DKY, DKA and KEY values. The values can be generated before with the routine SYSmakeParameterList.

Result

---

Constants

TYPE_SELECT_STRING

TYPE_SELECT_TEXT

TYPE_SELECT_POINTELEMENT

TYPE_SELECT_SYMBOL

TYPE_SELECT_ALL

Declaration

#include "database.h"

void DLLENTRY DBidentifyPointsInObjectUsingKnots (

POBJECT object,

STAND-IN x,

STAND-IN y,

STAND-IN toleranz,

int * anzahl,

T_PPOINT * points,

int typeSelect

PIDENTIFY_PARAMETER parameterlist

);

Related functions

DBidentifyPointsInObjectUsingPath