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


ISurface.QueryPixelBlock Method (ArcObjects .NET 10.4 SDK)
ArcObjects Library Reference (GeoDatabase)  

ISurface.QueryPixelBlock Method

Derives slope, aspect, hillshade, or elevation from the input surface and writes the result to the provided PixelBlock.

[Visual Basic .NET]
Public Sub QueryPixelBlock ( _
    ByVal xOrigin As Double, _
    ByVal yOrigin As Double, _
    ByVal xPixelSize As Double, _
    ByVal yPixelSize As Double, _
    ByVal Type As esriRasterizationType, _
    ByVal valueForNoData As Object, _
    ByVal block As Object _
)
[C#]
public void QueryPixelBlock (
    double xOrigin,
    double yOrigin,
    double xPixelSize,
    double yPixelSize,
    esriRasterizationType Type,
    object valueForNoData,
    object block
);
[C++]
HRESULT QueryPixelBlock(
  double xOrigin,
  double yOrigin,
  double xPixelSize,
  double yPixelSize,
  esriRasterizationType Type,
  VARIANT valueForNoData,
  VARIANT block
);
[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 Type [in]
Type is a parameter of type esriRasterizationType valueForNoData [in] valueForNoData is a parameter of type VARIANT block [in] block is a parameter of type VARIANT

Product Availability

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

Description

xOrigin and yOrigin represent the map coordinates of the upper left cell center of the output pixel block.

xPixelSize and yPixelSize are the horizontal and vertical dimensions of the cells in the output pixel block.

type is an esriRasterizationType enumeration that indicates what type of surface information is written; elevation or a derivative.

valueForNodata is the value written into the pixel block for areas of NoData. It's a variant that must be set to the the same numeric type as the target raster (see rstPixelType). It should be the same value and variant type used as when constructing/defining the output raster via IRasterProps.NoDataValue.

block is a pointer to pixel data used for writing output values. It should be retrieved from a pixel block from the output raster via IPixelBlock3.PixelDataByRef.

 

Notes:

This member should not be used in .NET. As a substitute, .NET developers must use IGeoDatabaseBridge2.QueryPixelBlock.

See Also

ISurface Interface