ITerrain.ExtractFromEmbeddedDataSource Method

Copies features of an embedded data source to the specified feature class.

[Visual Basic .NET]
Public Sub ExtractFromEmbeddedDataSource ( _
    ByVal index As Integer, _
    ByVal pFeatureClass As IFeatureClass, _
    ByVal pAOI As IEnvelope, _
    ByVal Resolution As Double, _
    ByVal pTrackCancel As ITrackCancel _
)

[C#]
public void ExtractFromEmbeddedDataSource (
    int index,
    IFeatureClass pFeatureClass,
    IEnvelope pAOI,
    double Resolution,
    ITrackCancel pTrackCancel
);

[C++]
HRESULT ExtractFromEmbeddedDataSource(
  long index,
  IFeatureClass* pFeatureClass,
  IEnvelope* pAOI,
  double Resolution,
  ITrackCancel* pTrackCancel
);

[C++]
Parameters
index [in]
  index is a parameter of type long
pFeatureClass [in]
  pFeatureClass is a parameter of type IFeatureClass
pAOI [in]
  pAOI is a parameter of type IEnvelope
Resolution [in]
  Resolution is a parameter of type double
pTrackCancel [in]
  pTrackCancel is a parameter of type ITrackCancel

Product Availability

Description

Copies points from an embedded source into the target feature class.

index references the data source to use. This should be in the range of 0 to n-1 where n represents the number of data sources in the terrain, but it must also be a source which is embedded.

pFeatureClass is the target feature class, where the points will be written.

pAOI is the area of interest envelope. Points within the AOI will be extracted. This can be set to a NULL pointer ('Nothing' in VB) if the entire extent of the terrain is desired.

resolution indicates which pyramid level should be used for extraction. A value of 0.0 will extract the full resolution data. Any other value should correspond to one of the values used to define the terrain's pyramid. If you don't provide an exact match the software will round down to the next closest level.

pTrackCancel is a reference to a Cancel Tracker object that can be used to monitor progress and/or cancel the process. This can be set to a NULL pointer ('Nothing' in VB) if desired.

Notes

• The target feature class must be z-aware.
• The target feature class shape type can be point or multipoint.
• When writing points all output geometry will be within the neatline AOI boundary. When writing multipoints the output geometry may extend beyond the AOI because multipoints are extracted from the embedded source based on whether their envelopes intersect the AOI.
• Embedded attributes, if present, will be copied to the target. Fields will be added as necessary to the target to hold the attributes.

See Also