ITinEdit.AddFromPixelBlock Method

Adds pixels from a pixel block to the TIN.

[Visual Basic .NET]
Public Sub AddFromPixelBlock ( _
    ByVal xOrigin As Double, _
    ByVal yOrigin As Double, _
    ByVal xPixelSize As Double, _
    ByVal yPixelSize As Double, _
    ByVal valueForNoData As Object, _
    ByVal block As Object, _
    ByVal ZTolerance As Double, _
    [ByRef pMaxPoints As Object], _
    [ByRef pbToleranceAchieved As Object] _
)

[C#]
public void AddFromPixelBlock (
    double xOrigin,
    double yOrigin,
    double xPixelSize,
    double yPixelSize,
    object valueForNoData,
    object block,
    double ZTolerance,
    ref object pMaxPoints,
    ref object pbToleranceAchieved
);

[C++]
HRESULT AddFromPixelBlock(
  double xOrigin,
  double yOrigin,
  double xPixelSize,
  double yPixelSize,
  VARIANT valueForNoData,
  VARIANT block,
  double ZTolerance,
  VARIANT* pMaxPoints,
  VARIANT* pbToleranceAchieved
);

[C++]
Parameters
xOrigin [in]
  xOrigin is a parameter of type double
yOrigin [in]
  yOrigin is a parameter of type double
xPixelSize [in]
  xPixelSize is a parameter of type double
yPixelSize [in]
  yPixelSize is a parameter of type double
valueForNoData [in]
  valueForNoData is a parameter of type VARIANT
block [in]
  block is a parameter of type VARIANT
ZTolerance [in]
  ZTolerance is a parameter of type double
pMaxPoints [optional]
  pMaxPoints is a parameter of type VARIANT
  To indicate this parameter is undefined pass a reference to a VARIANT with type VT_ERROR and scode value of DISP_E_PARAMNOTFOUND.
pbToleranceAchieved [out, optional]
  pbToleranceAchieved is a parameter of type VARIANT
  To indicate this parameter is undefined pass a reference to a VARIANT with type VT_ERROR and scode value of DISP_E_PARAMNOTFOUND.

Product Availability

Description

This function is used in raster to TIN conversion. It's a recursive process that adds pixel cell centers from the PixelBlock as nodes to the TIN. The process stops once a specified vertical accuracy has been achieved, or a maximum number of nodes have been added.

xOrigin and yOrigin represent the upper left cell center of the PixelBlock in map space coordinates.

xPixelSize and yPixelSize represent the x and y cell dimensions (cellsize) of the PixelBlock.

valueForNoData is the value used for cells in the PixelBlock to indicate NoData. Cells with this value will be excluded.

block is the PixelBlock itself.

zTolerance is a vertical accuracy parameter. The resulting TIN's height field will not differ from the input PixelBlock's by more than this value. A smaller zTolerance produces a TIN that is more accurate.

[MaxPoints] is an optional long integer. The process will halt if the total number of nodes in the TIN, not just just those added by this function, has been reached without the zTolerance being achieved. For performance reasons [MaxPoints] is approximate so it's possible the resulting TIN may be slightly larger than the value specified.

[bToleranceAchieved] is a boolean that is set by the function if the [MaxPoints] argument was specified. It is set to TRUE if the zTolerance was met or FALSE if the function had to quit as a result of reaching [MaxPoints] without meeting the tolerance.

See Also