com.esri.arcgis.geodatabase
Interface ITinNode

All Superinterfaces:
ITinElement, Serializable
All Known Subinterfaces:
ITinNode2
All Known Implementing Classes:
TinNode

public interface ITinNode
extends ITinElement, Serializable

Provides access to members that control TIN nodes.

Superseded By

ITinNode2

Product Availability

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

Supported Platforms

Windows, Solaris, Linux


Method Summary
 ITinNodeArray getAdjacentNodes()
          Returns all nodes comprising triangles sharing the specified node.
 ITinEdgeArray getIncidentEdges()
          Returns all edges sharing the specified node.
 ITinTriangleArray getIncidentTriangles()
          Returns all triangles sharing the specified node.
 IPolygon getVoronoiRegion(IPolygon pClippingPolygon)
          Returns the Voronoi-polygon region of the specified node.
 double getX()
          The x-coordinate of the specified node.
 double getY()
          The y-coordinate of the specified node.
 double getZ()
          The z-coordinate of the specified node.
 void queryAsPoint(IPoint pPoint)
          Sets the node equal to a point.
 void queryAsWKSPointZ(_WKSPointZ[] pPoint)
          Sets the node equal to a point with a z value.
 
Methods inherited from interface com.esri.arcgis.geodatabase.ITinElement
getIndex, getTagValue, getTheTin, init, isEmpty, isInsideDataArea, setEmpty
 

Method Detail

getX

double getX()
            throws IOException,
                   AutomationException
The x-coordinate of the specified node.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The x
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getY

double getY()
            throws IOException,
                   AutomationException
The y-coordinate of the specified node.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The y
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getZ

double getZ()
            throws IOException,
                   AutomationException
The z-coordinate of the specified node.

Description

The super nodes of a TIN have a Z value equal to NODATA. Mathmatical operations cannot be performed on NODATA. You can check this case by passing the Z to ITinAdvanced.IsVoidZ, ISurface.IsVoidZ, or ITinSurface.IsVoidZ for evaluation.

A super node is one of four nodes added by the software when a TIN is initially created (ITinEdit.InitNew). They reside far outside the declared data extent and are used to define an initial triangulation before user data gets added. Triangles incident to these nodes are always flagged as being outside the TIN's interpolation zone or data area.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
The z
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

queryAsPoint

void queryAsPoint(IPoint pPoint)
                  throws IOException,
                         AutomationException
Sets the node equal to a point.

Description

Writes the X, Y, and Z values of the node to an existing, pre-instantiated, Point object. In some cases, such as in loops, it's faster to reuse and write to an existing Point object rather than to create a new one each iteration.

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)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

queryAsWKSPointZ

void queryAsWKSPointZ(_WKSPointZ[] pPoint)
                      throws IOException,
                             AutomationException
Sets the node equal to a point with a z value.

Description

Writes the X, Y, and Z values of the node to a WKSPointZ variable.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
pPoint - A Structure: com.esri.arcgis.system._WKSPointZ (A com.esri.arcgis.system._WKSPointZ COM typedef) (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getAdjacentNodes

ITinNodeArray getAdjacentNodes()
                               throws IOException,
                                      AutomationException
Returns all nodes comprising triangles sharing the specified node.

Description

Returns a TinNodeArray containing nodes that are next to the given node. These adjacent nodes are connected to the given node by TIN edges.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
A reference to a com.esri.arcgis.geodatabase.ITinNodeArray
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getIncidentEdges

ITinEdgeArray getIncidentEdges()
                               throws IOException,
                                      AutomationException
Returns all edges sharing the specified node.

Description

The edges returned in the TinEdgeArray all share this node as their from node.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
A reference to a com.esri.arcgis.geodatabase.ITinEdgeArray
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getIncidentTriangles

ITinTriangleArray getIncidentTriangles()
                                       throws IOException,
                                              AutomationException
Returns all triangles sharing the specified node.

Description

The returned TinTriangleArray will contain the set of triangles that are incident to, or surround, the given node. In other words, this node belongs to, and is referenced by, every triangle returned.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
A reference to a com.esri.arcgis.geodatabase.ITinTriangleArray
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getVoronoiRegion

IPolygon getVoronoiRegion(IPolygon pClippingPolygon)
                          throws IOException,
                                 AutomationException
Returns the Voronoi-polygon region of the specified node.

Description

The Voronoi region (also known as Thiessen or proximal polygon) that is returned encloses an area that is closer to the source node than to any other node in the triangulation.

'Nothing' (a null pointer) can be passed as the clip polygon. In this case, a default rectangle will be used to clip the voronoi region. The rectangle is set to be somewhat larger than the FullExtent of the TIN.

GetVoronoiRegion used on a super node will return Nothing (a null pointer). Super nodes are added by the software when the TIN is initially created and reside far outside the declared data extent.

If you wish to process the entire TIN and write the output to a feature class consider ITinNodeCollection.ConvertToVoronoiRegions.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
pClippingPolygon - A reference to a com.esri.arcgis.geometry.IPolygon (in)
Returns:
A reference to a com.esri.arcgis.geometry.IPolygon
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.