User Tools

Site Tools


Table of Contents

TGIS_LayerPixel.LocateEx method

DK11 for Delphi | GisLayerPixel.TGIS_LayerPixel.LocateEx | Constructors | Fields | Methods | Properties | Events

If a given point is located in the image area, returns true and sets variables.

Available also on: .NET | Java | ActiveX.


// Delphi
  function LocateEx(
    const _ptg : TGIS_Point;
    var _rgbMapped : TGIS_Color;
    var _nativesVals : TGIS_DoubleArray;
    var _transparency : Boolean;
    const _pixelsize : Double
  ) : Boolean; virtual;
// C++ Builder
  virtual bool LocateEx(
    TGIS_Point* const _ptg,
    TGIS_Color* &_rgbMapped,
    TGIS_DoubleArray* &_nativesVals,
    bool &_transparency,
    const double _pixelsize


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
_rgbMapped TGIS_Color color in _ptg point after mapping (the same as _nativesVals if no mapping, in this case _rgbMapped and $FF = Byte(_nativesVals[0] and so on).
_nativesVals TGIS_DoubleArray dynamic array of double with original values in _ptg point (for example R, G, B), Length(_nativesVals) is equal to number of bands
_transparency Boolean set on True if point is transparent
_pixelsize Double requested size of image pixel; by providing 0 an actual viewer scale should be used to calculate am optimal pixel size; >0 - pixel size is expressed in map units; <0 - pixels is expressed in layer units


Type Description
Boolean True if success


If _pixelsize=0 then meaning same as Locate().

2020/06/27 08:17

Page Tools