ITGIS_LayerPixel.Loop method

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

Prepares enumerator to iterate the layer through the linear shape. Lines are interpreted as-line-flow for terrain profile like analysis. Pixels are treated as points.

Available also on: Delphi | .NET | Java.

// C#
public ITGIS_LayerPixelEnumeratorFactory Loop(
  double _pixelsize,
  ITGIS_Shape _shape,
  WordBool _writable
);

' VisualBasic
Public Function Loop(
  ByVal _pixelsize As Double,
  ByVal _shape As ITGIS_Shape,
  ByVal _writable As WordBool
) As ITGIS_LayerPixelEnumeratorFactory

// Oxygene
public
  function Loop(
    _pixelsize : Double;
    _shape : ITGIS_Shape;
    _writable : WordBool
  ) : ITGIS_LayerPixelEnumeratorFactory;

_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