User Tools

Site Tools


api:dk11:delphi:gislayerpixel.tgis_layerpixel.locateex_tgis_point_tgis_color_tgis_doublearray_boolean_double

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.

Syntax

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

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
_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

Result

Type Description
Boolean True if success

Remarks

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

2020/06/27 08:17

Page Tools