ArcObjects Library Reference (GeoDatabase)  

ITinSurface.GetPartialVolumeAndArea Method

Returns portion of the TIN's volume above or below an input z value.

[Visual Basic .NET]
Public Sub GetPartialVolumeAndArea ( _
    ByVal referenceHeight As Double, _
    ByVal Type As esriPlaneReferenceType, _
    ByVal pTriangles As IEnumTinTriangle, _
    [ByRef pVolume As Object], _
    [ByRef pSurfaceArea As Object], _
    [ByRef pProjectedArea As Object] _
)
[C#]
public void GetPartialVolumeAndArea (
    double referenceHeight,
    esriPlaneReferenceType Type,
    IEnumTinTriangle pTriangles,
    ref object pVolume,
    ref object pSurfaceArea,
    ref object pProjectedArea
);
[C++]
HRESULT GetPartialVolumeAndArea(
  double referenceHeight,
  esriPlaneReferenceType Type,
  IEnumTinTriangle* pTriangles,
  VARIANT* pVolume,
  VARIANT* pSurfaceArea,
  VARIANT* pProjectedArea
);
[C++]

Parameters

referenceHeight [in]   referenceHeight is a parameter of type double Type [in]

  Type is a parameter of type esriPlaneReferenceType

pTriangles [in]

  pTriangles is a parameter of type IEnumTinTriangle

pVolume   pVolume is a parameter of type VARIANT pSurfaceArea   pSurfaceArea is a parameter of type VARIANT pProjectedArea   pProjectedArea is a parameter of type VARIANT

Product Availability

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

Description

Calculates projected area, surface area, and/or volume relative to a given reference height and collection of triangles.

reference is the height against which area and volume statistics will be gathered. Height is used to define a horizontal plane. Area and volume is calculated per triangle and the values are summed for all triangles to produce the results.

esriPlaneReferenceType can be set to esriPlaneReferenceAbove or esriPlaneReferenceBelow. When set to esriPlaneReferenceAbove projected area and surface area is calculated for the portion of each triangle that falls above the plane. Triangles, or portions of triangles, that fall below the plane are excluded. Volume is calculated for the cubic area between the top of the reference plane and the underside of triangles above it. When the plane type is set to esriPlaneReferenceBelow the opposite action takes place. Area is calculated for triangles, or portions of triangles, that are below the plane. Volume is the cubic area between the underside of the plane and the tops of triangles that fall below it.

pTriangles is a triangle enumerator that determines which triangles are involved in the calculation. This enables analysis on a sub-portion of the TIN because only triangles passed by the enumerator are used. Alternately, if you want to perform the operation on the entire TIN use ISurface.GetProjectedArea, ISurface.GetSurfaceArea, or ISurface.GetVolume.

Volume, SurfaceArea, and ProjectedArea are optional double variables that are the output results. Only specify the ones you're interested in to avoid unnecessary computation.

 

See Also

ITinSurface Interface