com.esri.arcgis.geodatabase
Interface ITinSurface

All Superinterfaces:

IFunctionalSurface, ISurface, Serializable

All Known Subinterfaces:

ITinSurface2

All Known Implementing Classes:

Tin

public interface ITinSurface
extends ISurface, Serializable

Provides access to members that control TIN surfaces.

Superseded By

ITinSurface2

Product Availability

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

Method Summary

double	getIntensity(_WKSPointZ pPi, _WKSPointZ pPj, _WKSPointZ pPk) Returns the hillshade brightness value of the plane defined by the three points.
void	getPartialVolumeAndArea(double referenceHeight, int type, IEnumTinTriangle pTriangles, Object[] pVolume, Object[] pSurfaceArea, Object[] pProjectedArea) Returns portion of the TIN's volume above or below an input z value.
int	getRasterInterpolationMethod() The elevation interpolation method for rasterization.
_WKSPointZ	getSunPosition() The vector indicating the direction of the light source relative to the scene.
ITinSurfaceElement	getSurfaceElement(IPoint pPoint) Returns the surface element at the specified location.
void	setRasterInterpolationMethod(int pType) The elevation interpolation method for rasterization.
void	setSunPosition(_WKSPointZ pPosition) The vector indicating the direction of the light source relative to the scene.

Methods inherited from interface com.esri.arcgis.geodatabase.ISurface

asPolygons, contour, contourList, getAspectDegrees, getAspectRadians, getContour, getElevation, getLineOfSight, getProfile, getProjectedArea, getSlopeDegrees, getSlopePercent, getSlopeRadians, getSteepestPath, getSurfaceArea, getVolume, getZFactor, interpolateShape, interpolateShapeVertices, isVoidZ, locate, locateAll, queryNormal, queryPixelBlock, querySurfaceLength, setZFactor

Methods inherited from interface com.esri.arcgis.geometry.IFunctionalSurface

getDomain, getZ

Method Detail

setRasterInterpolationMethod

void setRasterInterpolationMethod(int pType)
                                  throws IOException,
                                         AutomationException

The elevation interpolation method for rasterization.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

pType - A com.esri.arcgis.geodatabase.esriSurfaceInterpolationType constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getRasterInterpolationMethod

int getRasterInterpolationMethod()
                                 throws IOException,
                                        AutomationException

The elevation interpolation method for rasterization.

Description

The interpolation method used when converting a TIN to a raster using ITinSurface.QueryPixelBlock.

esriSurfaceInterpolationType can be set to either esriLinearInterpolation or esriNaturalNeighborInterpolation.

Linear interpolation considers each triangle as a flat plane. For each cell center in the output raster the encompassing triangle is found and the height for the location on the plane is determined.

Natural neighbor interpolation uses an area based weighting scheme to calculate height for output raster cell centers and produces smoother results than linear interpolation. The closest TIN nodes in all directions found for each raster cell center are used in the calculation. Hard breaklines present in the TIN will influence results as the surface definition is not continuously smooth across them with this interpolator.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

A com.esri.arcgis.geodatabase.esriSurfaceInterpolationType constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setSunPosition

void setSunPosition(_WKSPointZ pPosition)
                    throws IOException,
                           AutomationException

The vector indicating the direction of the light source relative to the scene.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

pPosition - A Structure: com.esri.arcgis.system._WKSPointZ (A com.esri.arcgis.system._WKSPointZ COM typedef) (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSunPosition

_WKSPointZ getSunPosition()
                          throws IOException,
                                 AutomationException

The vector indicating the direction of the light source relative to the scene.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

A Structure: com.esri.arcgis.system._WKSPointZ (A com.esri.arcgis.system._WKSPointZ COM typedef)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getIntensity

double getIntensity(_WKSPointZ pPi,
                    _WKSPointZ pPj,
                    _WKSPointZ pPk)
                    throws IOException,
                           AutomationException

Returns the hillshade brightness value of the plane defined by the three points.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

pPi - A Structure: com.esri.arcgis.system._WKSPointZ (A com.esri.arcgis.system._WKSPointZ COM typedef) (in)

pPj - A Structure: com.esri.arcgis.system._WKSPointZ (A com.esri.arcgis.system._WKSPointZ COM typedef) (in)

pPk - A Structure: com.esri.arcgis.system._WKSPointZ (A com.esri.arcgis.system._WKSPointZ COM typedef) (in)

Returns:

The pIntensity

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSurfaceElement

ITinSurfaceElement getSurfaceElement(IPoint pPoint)
                                     throws IOException,
                                            AutomationException

Returns the surface element at the specified location.

Description

A surface element contains information about the TIN and the surface it defines specific to a given point position. It maintains the surface attributes of elevation, slope, and aspect, as well as the the index and tag value of the containing triangle, and the index and tag value of the closest node in the containing triangle.

The element is constructed from the triangle containing the query point. If the query point falls on a triangle edge, one of the triangles on either side is picked randomly by the software. If the query point falls on a TIN node the triangle used is picked randomnly from those incident to the node.

A Nil pointer (nothing) is returned when the query point falls outside the interpolation zone.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

pPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)

Returns:

A reference to a com.esri.arcgis.geodatabase.ITinSurfaceElement

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getPartialVolumeAndArea

void getPartialVolumeAndArea(double referenceHeight,
                             int type,
                             IEnumTinTriangle pTriangles,
                             Object[] pVolume,
                             Object[] pSurfaceArea,
                             Object[] pProjectedArea)
                             throws IOException,
                                    AutomationException

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

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.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

referenceHeight - The referenceHeight (in)

type - A com.esri.arcgis.geodatabase.esriPlaneReferenceType constant (in)

pTriangles - A reference to a com.esri.arcgis.geodatabase.IEnumTinTriangle (in)

pVolume - A Variant (in/out: use single element array, optional, pass single element of null if not required)

pSurfaceArea - A Variant (in/out: use single element array, optional, pass single element of null if not required)

pProjectedArea - A Variant (in/out: use single element array, optional, pass single element of null if not required)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.