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.
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().
2022/11/16 01:19