TMapObjectStructure.GetNearestPoint

Модуль: MapObject
Класс: TMapObjectStructure

Найти ближайшую точку объекта относительно заданной точки

Объявление

function GetNearestPoint(x,y,Delta: double;
	 var nSubObject, LastPointNumber: integer;
	 var aResultX, aResultY, aDistance: double;
	 aConstrainMode: TConstrainMode = cmOnlySegment;
	 aCheckVertexMode: TCheckVertexMode = cvmVertexSnap;
	 SearchRadius: double = -1; NearestPoints: PArrayMapObjectPoints = nil;
	 NearestPointsMaxCount: integer = 0): integer;

Параметры

x
координата исходной точки по горизонтали
y
координата исходной точки по вертикали
Delta
погрешность поиска
nSubObject
номер подобъекта (возвращаемый параметр)
LastPointNumber
номер начальной узловой точки отрезка, на котором найдена ближайшая точка на полилинии (возвращаемый параметр)
aResultX
координата ближайшей точки на полилинии по горизонтали (возвращаемый параметр)
aResultY
координата ближайшей точки на полилинии по вертикали (возвращаемый параметр)
aDistance
расстояние до ближайшей точки на полилинии (возвращаемый параметр)
aConstrainMode
режим ограничения поиска точки на отрезке (по умолчанию cmOnlySegment)
aCheckVertexMode
вариант поиска узловых точек, по умолчанию cvmVertexSnap
SearchRadius
радиус поиска, если < 0, то радиус поиска не ограничен (по умолчанию -1)
NearestPoints
указатель на упорядоченный по возрастанию динамический массив ближайших точек (по умолчанию nil)
NearestPointsMaxCount
максимальный размер динамический массив ближайших точек (по умолчанию 0)

Возвращает

<0
ближайшая точка на полилинии не найдена
0
ближайшая точка на полилинии найдена и совпадает с узловой точкой
1
ближайшая точка на полилинии найдена и находится на отрезке между узловыми точками

Описание

Искомая точка может как совпадать с одной из узловых точек, так и находиться на отрезке между узловыми точками (номер начальной точки отрезка - LastPointNumber)

Смотри также

GetNearestPoint
Найти ближайшую точку объекта относительно заданной точки
GetLengthToNearestPoint
Найти расстояние до ближайшей точки объекта относительно заданной точки