User Tools

Site Tools


Table of Contents

ITGIS_LayerPixel.LocateEx method

DK11 for ActiveX | TatukGIS_XDK11.ITGIS_LayerPixel.LocateEx | Methods | Properties

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

Available also on: Delphi | .NET | Java.


// C#
public WordBool LocateEx(
  ITGIS_Point _ptg,
  ref ITGIS_Color _rgbMapped,
  ref ITGIS_DoubleArray _nativesVals,
  ref WordBool _transparency,
  double _pixelsize
' VisualBasic
Public Function LocateEx(
  ByVal _ptg As ITGIS_Point,
  ByRef _rgbMapped As ITGIS_Color,
  ByRef _nativesVals As ITGIS_DoubleArray,
  ByRef _transparency As WordBool,
  ByVal _pixelsize As Double
) As WordBool
// Oxygene
  function LocateEx(
    _ptg : ITGIS_Point;
    var _rgbMapped : ITGIS_Color;
    var _nativesVals : ITGIS_DoubleArray;
    var _transparency : WordBool;
    _pixelsize : Double
  ) : WordBool;


Name Type Description
_ptg ITGIS_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 ITGIS_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 ITGIS_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 WordBool 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
WordBool True if success


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

2020/06/27 08:12

Page Tools