This document is archived and information here might be outdated.  Recommended version.


ITinEdit.AddFromPixelBlock Method (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (GeoDatabase)  

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#]

Optional Values

pMaxPoints   To indicate that this parameter is undefined, first define a variable object Missing=Type.Missing; then pass this in as ref Missing.
pbToleranceAchieved   To indicate that this parameter is undefined, first define a variable object Missing=Type.Missing; then pass this in as ref Missing.
[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

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

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

ITinEdit Interface