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


ITerrainDataImporter.Import Method (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (GeoDatabaseExtensions)  

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

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

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

See Also

ITerrainDataImporter Interface