ILasPointCloud.GetLasPointsByBudget Method

Returns a point enumerator object.

[Visual Basic .NET]
Public Function GetLasPointsByBudget ( _
    ByVal pTrackCancel As ITrackCancel, _
    ByVal pFilter As ILasPointFilter, _
    ByVal maxPointCount As Double, _
    ByVal ZFactor As Double _
) As IEnumLasPoint

[C#]
public IEnumLasPoint GetLasPointsByBudget (
    ITrackCancel pTrackCancel,
    ILasPointFilter pFilter,
    double maxPointCount,
    double ZFactor
);

[C++]
HRESULT GetLasPointsByBudget(
  ITrackCancel* pTrackCancel,
  ILasPointFilter* pFilter,
  double maxPointCount,
  double ZFactor
);

[C++]

Parameters
pTrackCancel [in]

  pTrackCancel is a parameter of type ITrackCancel*
pFilter [in]

  pFilter is a parameter of type ILasPointFilter*
maxPointCount [in]

  maxPointCount is a parameter of type double
ZFactor [in]

  ZFactor is a parameter of type double

Product Availability

Description

Returns a Las point enumerator to retrieve points from a LAS dataset with a constraint on the upper limit of the number of points.

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.

pFilter references a ILasPointFilter that defines the selection criteria for what points to read from the las files.

maxPointCount is the maximum number of points that is desired.

zFactor is used to convert the vertical units of the retrieved points (e.g., to convert feet to meters). The output point z values are multipled by the zFactor. Prior to 10.5 the zFactor is always applied. In 10.5 and later the zFactor is applied only if the software doesn't have enough information to go on to apply a factor itself. Otherwise, it's ignored. It looks at the input files and the 'target' spatial reference which is the LAS Dataset spatial reference. It will try to honor the target. This can mean that it selectively applies a zFactor if the LAS files themselves have different z units, some that don't match the output vs. some that already do.

Remarks