IDynamicSurface.GetTin Method

Returns a TIN for a given area of interest and terrain pyramid level.

[Visual Basic .NET]
Public Function GetTin ( _
    ByVal pAreaOfInterest As IEnvelope, _
    ByVal Resolution As Double, _
    ByVal bClipWithAOI As Boolean, _
    ByVal pTrackCancel As ITrackCancel _
) As ITin

[C#]
public ITin GetTin (
    IEnvelope pAreaOfInterest,
    double Resolution,
    bool bClipWithAOI,
    ITrackCancel pTrackCancel
);

[C++]
HRESULT GetTin(
  IEnvelope* pAreaOfInterest,
  double Resolution,
  VARIANT_BOOL bClipWithAOI,
  ITrackCancel* pTrackCancel,
  ITin** ppTin
);

[C++]
Parameters
pAreaOfInterest [in]
  pAreaOfInterest is a parameter of type IEnvelope
Resolution [in]
  Resolution is a parameter of type double
bClipWithAOI [in]
  bClipWithAOI is a parameter of type VARIANT_BOOL
pTrackCancel [in]
  pTrackCancel is a parameter of type ITrackCancel
ppTin [out, retval]
  ppTin is a parameter of type ITin

Product Availability

Description

AreaOfInterest (AOI) is an envelope that indicates the area of the terrain to be extracted. If a spatial reference is defined for the envelope the returned TIN will be in that spatial reference. Otherwise the TIN will be in the spatial reference of the terrain.

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.

ClipWithAOI is a boolean that is used to neatline clip the returned TIN to the passed AOI. Otherwise, data outside the AOI envelope may be included. If the terrain is defined with a clip polygon the returned TIN with be clipped by the intersection of the clip polygon with the AOI.

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).

You should call ITerrain.GetPointCount before this GetTIN using the same AOI and resolution parameters to ensure the resulting number of nodes is not too big. You should not attempt to build TINs with more than several million points.

The returned TIN will be in edit mode. To save it to disk and take it out of edit mode you call ITin.SaveAs followed by ITinEdit.StopEditing.

See Also