api:dk11:python:tatukgis.pdk.tgis_layervector.locateex_tgis_point_double_tgis_uid_double_integer_tgis_point_boolean
Table of Contents
TGIS_LayerVector.LocateEx(TGIS_Point, float, TGIS_Uid, float, int, TGIS_Point, bool) method
DK11 for Python | tatukgis.pdk.TGIS_LayerVector.LocateEx | Overloads | Constructors | Methods | Properties | Events
Locates a shape (more precise).
Syntax
# Python def LocateEx( self, _ptg: TGIS_Point, _prec: float, _uid: TGIS_Uid, _dist: VarParameter, _part: VarParameter, _proj: VarParameter, _visible: bool ) -> TGIS_Shape:
Parameters
| Name | Type | Description |
|---|---|---|
| _ptg | TGIS_Point | reference point /searching point/ in a layer; 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 |
| _prec | float | 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 |
| _uid | TGIS_Uid | Uid of reference shape or -1; thanks to this, is possible to find nearest shape, excluding shape given by _uid. |
| _dist | float | 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 |
| _part | int | number of the part closest to a given point |
| _proj | TGIS_Point | point projected to the nearest element of a shape |
| _visible | bool | if true the only visible shapes will be evaluated; shapes turned of by query of hidden will be ignored |
Result
| Type | Description |
|---|---|
| TGIS_Shape | Found shape or nil. |
Remarks
Use this method to locate a shape that is near _ptg but also on _prec distance. It finds a shape using FindFirst method in extent corrected by _prec and _ptg params.
2023/08/09 01:57