TMapObjectStructure.GetLengthToNearestPoint

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

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

Объявление

function GetLengthToNearestPoint(x,y,Delta: double;
	 var nSubObject, LastPointNumber: integer;
	 var aResultX, aResultY, aDistance, aLength: double;
	 aCheckVertexMode: TCheckVertexMode): integer;

Параметры

x
координата исходной точки по горизонтали
y
координата исходной точки по вертикали
Delta
погрешность поиска
nSubObject
номер подобъекта (возвращаемый параметр)
LastPointNumber
номер начальной узловой точки отрезка, на котором найдена ближайшая точка на полилинии (возвращаемый параметр)
aResultX
координата ближайшей точки на полилинии по горизонтали (возвращаемый параметр)
aResultY
координата ближайшей точки на полилинии по вертикали (возвращаемый параметр)
aDistance
расстояние до ближайшей точки на полилинии (возвращаемый параметр)
aLength
расстояние вдоль полилинии от точки с номером n0 в буфере до ближайшей точки на полилинии (возвращаемый параметр)
aCheckVertexMode
вариант поиска узловых точек, по умолчанию cvmVertexSnap

Возвращает

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

Описание

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

Смотри также

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