TatukGIS-TGIS_LayerVector-LocateEx

时间:2023-03-09 05:08:12
TatukGIS-TGIS_LayerVector-LocateEx

方法原型:

function LocateEx(const _ptg: TGIS_Point; const _prec: Double; const _uid: Integer; var _dist: Double; var _part: Integer; var _proj: TGIS_Point; const _visible: Boolean): TGIS_Shape;

参数

Parameters

Description

const _ptg: TGIS_Point

reference point /searching point/ in a lyer;

if the layer has been attached to the Viewer then expected _ptg units are in a Viewer coordinate space;

otherwise expected _ptg units are in a Layer coordinate space

const _prec: Double

precision /not a longer distance than/; point inside a polygon is always not greater than _dist;

if _prec is less then 0, then being outside/inside polygon means the same; _prec units are calculated same way as _ptg

const _uid: Integer

Uid of reference shape or -1; thanks to this, is possible to find nearest shape, excluding shape given by _uid.

var _dist: Double

reached distance between _pt and shape in Result;

for points inside the polygon (if _prec >= 0) the distance will be multiply by 0.95 (to prefer points inside the polygon)

but will not be bigger then _prec; for point distance will be multiplied by 0.9 to prefer points over lines and polygons

_dist units are calculated same way as _ptg

var _part: Integer

number of the part closest to a given point  

var _proj: TGIS_Point

point projected to the nearest element of a shape

const _visible: Boolean

if true the only visible shapes will be evaluated; shapes turned of by query of hidden will be ignored