User Tools

Site Tools


api:dk11:java:tatukgis.jdk.tgis_viewer.locate_tgis_point_double_boolean

TGIS_Viewer.Locate(TGIS_Point, double, bool) method

DK11 for Java | tatukgis.jdk.TGIS_Viewer.Locate | Overloads | Constructors | Fields | Methods | Properties | Events

Locate a shape that is near _ptg, but is closer than _prec distance.

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

Syntax

// Java
public TGIS_ShapeAbstract Locate(
  TGIS_Point _ptg,
  double _prec,
  bool _visible
);
// Oxygene
public
  function Locate(
    _ptg : TGIS_Point;
    _prec : Double;
    _visible : Boolean
  ) : TGIS_ShapeAbstract;

Parameters

Name Type Description
_ptg TGIS_Point reference point /searching point/
_prec double
Double
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; precision is express in map units
_visible bool
Boolean
if true the only visible shapes will be evaluated; shapes turned of by query of hidden will be ignored

Result

Type Description
TGIS_ShapeAbstract Located shape or nil

Remarks

To improve performance sections visibility can be used to choose layer to call its Locate method. Only visible shapes will be evaluated.

If no shape is found on a layer, the searcher takes into account labels registered by the allocator (by extent). In order to disable this behavior, _visible must be set to False.

References

2022/11/30 19:36

Page Tools