ITerrainDataImporter.Import Method

Loads the specified data, based on the current properties, into the target feature class.

[Visual Basic .NET]
Public Sub Import ( _
    ByVal pOutputFeatureClass As IFeatureClass, _
    ByVal TileSize As Double, _
    ByVal ZFactor As Double, _
    ByVal pAOI As IEnvelope, _
    ByVal pTrackCancel As ITrackCancel, _
    ByRef pcOutsidePoints As Integer _
)

[C#]
public void Import (
    IFeatureClass pOutputFeatureClass,
    double TileSize,
    double ZFactor,
    IEnvelope pAOI,
    ITrackCancel pTrackCancel,
    ref int pcOutsidePoints
);

[C++]
HRESULT Import(
  IFeatureClass* pOutputFeatureClass,
  double TileSize,
  double ZFactor,
  IEnvelope* pAOI,
  ITrackCancel* pTrackCancel,
  long* pcOutsidePoints
);

[C++]
Parameters
pOutputFeatureClass [in]
  pOutputFeatureClass is a parameter of type IFeatureClass
TileSize [in]
  TileSize is a parameter of type double
ZFactor [in]
  ZFactor is a parameter of type double
pAOI [in]
  pAOI is a parameter of type IEnvelope
pTrackCancel [in]
  pTrackCancel is a parameter of type ITrackCancel
pcOutsidePoints [out]
  pcOutsidePoints is a parameter of type long

Product Availability

Description

OutFeatureClass is a reference to an existing z-aware multipoint feature class. Imported multipoints will be appended to it. If not already present, a field called 'PointCount' will be added that records the number of vertices in each multipoint record. When importing LAS attributes (see ITerrainLasDataImporter.AddProperty) the BLOB fields used to store the values need to be added to the feature class before calling this method.

TileSize is the length of a square tile side used to cluster the points. Points within the same tile are grouped together.

zFactor is a multiplication factor applied to point z values. It's applied before any z unit conversion which may occur as a result of input and output vertical coordinate system definition.

AOI is an area of interest envelope. Only points falling within this extent will be imported. It may be set to NULL ('Nothing' in VB) in which case everything will be used. If an envelope is passed, the XY values of the envelope must be defined. Z-values are optional. If z-values are set the filtering process is 3D. If not (values equal NaN), then the filtering process is 2D. The z min/max must either both be set or unset.

TrackCancel is a reference to a CancelTracker that can be used to report progress or cancel the import. It may be set to a NULL pointer (‘Nothing’ in VB) if this feature is not desired.

OutsidePoints will be set equal to the number of points which were omitted because they fell outside the area of interest (if defined) or outside the feature dataset domain.

Notes

• If the OutFeatureClass resides in SDE and has a controller (e.g., participates in a terrain dataset) then it must be registered as versioned before calling this function.

See Also