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

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