ITinEdit.AddShape Method

Adds a 2D shape to the TIN.

[Visual Basic .NET]
Public Sub AddShape ( _
    ByVal pShape As IGeometry, _
    ByVal Type As esriTinSurfaceType, _
    ByVal TagValue As Integer, _
    [ByRef pZ As Object] _
)

[C#]
public void AddShape (
    IGeometry pShape,
    esriTinSurfaceType Type,
    int TagValue,
    ref object pZ
);

[C++]
HRESULT AddShape(
  IGeometry* pShape,
  esriTinSurfaceType Type,
  long TagValue,
  VARIANT* pZ
);

[C++]
Parameters
pShape [in]
  pShape is a parameter of type IGeometry
Type [in]
  Type is a parameter of type esriTinSurfaceType
TagValue [in]
  TagValue is a parameter of type long
pZ [optional]
  pZ is a parameter of type VARIANT
  To indicate this parameter is undefined pass a reference to a VARIANT with type VT_ERROR and scode value of DISP_E_PARAMNOTFOUND.

Product Availability

Description

Adds a 2D point, multipoint, polyline, or polygon to the TIN.

The esriTinSurfaceType enumeration indicates how the input geometry is to be incorporated into the TIN. The surface types which are valid depend on the type of geometry being entered. Points can only be entered as mass points. Polylines can be entered as hard or soft breakline types or have their vertices entered as mass points. Polygons can be entered as polygon, line, or mass surface types.

Tags are assigned using the TagValue argument. If the surface feature type is set to mass points the tag is assigned to the resulting TIN nodes. If the surface type is polygonal the tags are assigned to triangles. A value of 0 will result in no tag assignment.

Z values for the shape's vertices are interpolated from the existing state of the TIN before the shape is inserted. The assumption is the existing TIN already has data with Z's. Typically 2D shapes are added to a TIN after all available 3D shapes.

You can use the optional Z argument to provide a constant height for the shape. In this case no interpolation for the shape takes place.

This function should not be called if the geometry IsEmpty.

See Also