ITinFeatureEdit.ExtractPolyline Method

Extracts polyline. The seed must be a special edge, or an edge with tagValue.

[Visual Basic .NET]
Public Function ExtractPolyline ( _
    ByVal pSeed As ITinFeatureSeed, _
    ByVal bGetZ As Boolean, _
    ByVal bSkipDensifiedNodes As Boolean _
) As IPolyline

[C#]
public IPolyline ExtractPolyline (
    ITinFeatureSeed pSeed,
    bool bGetZ,
    bool bSkipDensifiedNodes
);

[C++]
HRESULT ExtractPolyline(
  ITinFeatureSeed* pSeed,
  VARIANT_BOOL bGetZ,
  VARIANT_BOOL bSkipDensifiedNodes,
  IPolyline** ppPolyline
);

[C++]

Parameters
pSeed [in]

  pSeed is a parameter of type ITinFeatureSeed
bGetZ [in]
  bGetZ is a parameter of type VARIANT_BOOL
bSkipDensifiedNodes [in]
  bSkipDensifiedNodes is a parameter of type VARIANT_BOOL
ppPolyline [out, retval]

  ppPolyline is a parameter of type IPolyline

Product Availability

Description

Takes a polyline embedded in the triangulation and returns a polyline geometry.

The seed must be a TIN edge and either be enforced or have an assigned tag value.

ITinFeatureSeed.UseTagValue is used to control whether edge tag values are used to define the polyline. The default value is TRUE. If set to FALSE, only the edge type (i.e. hard, soft) is considered.

If the option to GetZ is TRUE the returned polyline will be ZAware with vertex Z values set from the source nodes.

If node source information is available, the setting of SkipDensifiedNodes to TRUE will result in the exclusion of densification nodes as vertices in the resulting polyline. This will result in the loss of the first and/or last polyline segment when first or last vertex of the polyline is a densification node. If the application requires these densification nodes to remain, and only the others to be excluded, consider use of ITinAdvanced.ExtractPolyline. The resulting TinPolyline object provides control on a per-node basis.

See Also