User Tools

Site Tools


api:dk11:python:tatukgis.pdk.tgis_layervector.locate_tgis_point_double_boolean

Table of Contents

TGIS_LayerVector.Locate(TGIS_Point, float, bool) method

DK11 for Python | tatukgis.pdk.TGIS_LayerVector.Locate | Overloads | Constructors | Methods | Properties | Events

Locates a shape.

Available also on: Delphi | .NET | Java | ActiveX.

Syntax

# Python
def Locate(
  self,
  _ptg: TGIS_Point,
  _prec: float,
  _visible: bool
) -> TGIS_Shape: 

Parameters

Name Type Description
_ptg TGIS_Point reference point /searching point/; 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/; 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 _prec units are calculated same way as _ptg
_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 closest to point _ptg but also on _prec distance. Internally it calls LocateEx method.

2023/08/09 01:57

Page Tools