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


ITinEdit.AddShape Method (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (GeoDatabase)  

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#]

Optional Values

pZ   To indicate that this parameter is undefined, first define a variable object Missing=Type.Missing; then pass this in as ref Missing.
[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

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

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

ITinEdit Interface