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


IDynamicSurface.QueryRaster Method (ArcObjects .NET 10.6 SDK)
ArcObjects Library Reference (GeoDatabaseExtensions)  

IDynamicSurface.QueryRaster Method

Writes surface heights to a raster dataset for a given area of interest and terrain pyramid level.

[Visual Basic .NET]
Public Sub QueryRaster ( _
    ByVal pDataset As IRasterDataset, _
    ByVal pAreaOfInterest As IEnvelope, _
    ByVal Resolution As Double, _
    ByVal Method As esriSurfaceInterpolationType, _
    ByVal pTrackCancel As ITrackCancel _
)
[C#]
public void QueryRaster (
    IRasterDataset pDataset,
    IEnvelope pAreaOfInterest,
    double Resolution,
    esriSurfaceInterpolationType Method,
    ITrackCancel pTrackCancel
);
[C++]
HRESULT QueryRaster(
  IRasterDataset* pDataset,
  IEnvelope* pAreaOfInterest,
  double Resolution,
  esriSurfaceInterpolationType Method,
  ITrackCancel* pTrackCancel
);
[C++]

Parameters pDataset [in]
pDataset is a parameter of type IRasterDataset* pAreaOfInterest [in]
pAreaOfInterest is a parameter of type IEnvelope* Resolution [in]
Resolution is a parameter of type double Method [in]
Method is a parameter of type esriSurfaceInterpolationType pTrackCancel [in]
pTrackCancel is a parameter of type ITrackCancel*

Product Availability

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

Description

The raster dataset will be written to. The raster must already exist and may be file or SDE based.

AreaOfInterest (AOI) is an envelope that indicates the area of the terrain to be rasterized. If data already exists in the output raster for part of this area it will be overwritten.

Resolution is used to indicate which pyramid level to extract from. The pyramid level with a resolution (e.g. z-tolerance) that is equal to or better than the value specified will be used. For example, take a terrain that has pyramids with resolutions 1.0, 2.5, and 5.0. If you give a value of 2.5 then the 2.5 resolution pyramid level is used. If you give 2.4 then the pyramid with a resolution of 1 is used. Specify a value of -1 to obtain the terrain's overview representation.

The method is the type of interpolation. It may be esriLinearInterpolation or esriNaturalNeighborInterpolation.

TrackCancel is a pointer to a CancelTracker object. If you are not interested in supporting a user cancel operation then pass a NULL pointer ('Nothing' in VB).

See Also

IDynamicSurface Interface