DBidentifyObjectUsingKnots |
Top Previous Next |
Look sharp for co-ordinates. In the selection amount of the data bank root 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 selection list, 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 root (PROOT) [IN] The data bank whose points should be identified. The points are searched in the selection amount. 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_ELIPSE TYPE_SELECT_SYMBOL TYPE_SELECT_ALL Declaration #include "database.h"
void DLLENTRY DBidentifyObjectUsingKnots ( PROOT root, STAND-IN x, STAND-IN y, STAND-IN toleranz, int * anzahl, T_PPOINT * points, int typeSelect, PIDENTIFY_PARAMETER parameterlist );
|