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
- Найти расстояние до ближайшей точки объекта относительно заданной точки