TGIS_LayerPixel.Loop(TGIS_Extent; Double; TGIS_Shape; String; Integer; Boolean) method

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

Prepares enumerator to iterate the layer (pixels are treated as points).

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

// Delphi
public
  function Loop(
    const _extent : TGIS_Extent;
    const _pixelsize : Double;
    const _shape : TGIS_Shape;
    const _de9im : String;
    const _band : Integer;
    const _writable : Boolean
  ) : TGIS_LayerPixelEnumeratorFactory; overload; virtual;

// C++ Builder
public:
  virtual TGIS_LayerPixelEnumeratorFactory* Loop(
    TGIS_Extent* const _extent,
    const double _pixelsize,
    TGIS_Shape* const _shape,
    const UnicodeString _de9im,
    const int _band,
    const bool _writable
  ) /* overload */;

_pixelsize

By providing _pixelsize=0, a native layer resolution is requested. This is also the fastest method if a layer is fully in-memory because, in such situation, a pointer to existing memory is used

General way to query for terrain profile:

foreach (TatukGIS.NDK.TGIS_PixelItem px in lp.Loop(0, line, false))
{
  Memo.AppendText(
    String.Format("Distance: {0}, Height:{1}\r\n", px.Distance, px.Value)
  );
}

General way to query for pixels within polygon and modifying value:

foreach (TGIS_PixelItem px in lp.Loop(polygon.Extent, 0, polygon, "T", true))
{
  px.Color = TGIS_Color.Red;
}

• PixelEdit sample