com.esri.arcgis.geodatabase
Class TinNode

java.lang.Object
  com.esri.arcgis.geodatabase.TinNode

All Implemented Interfaces:

ITinElement, ITinFeatureSeed, ITinNode, ITinNode2, com.esri.arcgis.interop.RemoteObjRef, ISupportErrorInfo, Serializable

public class TinNode
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, ITinElement, ITinNode, ITinNode2, ITinFeatureSeed, ISupportErrorInfo

The Esri TinNode component.

Description

The TinNode object is one of the three basic elements of a TIN: nodes, edges, and triangles. Triangles are comprised of three nodes and edges. Nodes and edges are ordered around triangles in a clockwise direction.

Nodes store x,y,z and optionally tag values. A tag is a long integer that has user assigned meaning.

When a TIN is first created it's populated with four supernodes connected into 2 triangles. The placement of the supernodes is far outside the declared data envelope (see ITinEdit.InitNew ). The initial triangulation formed by these nodes is used as the foundation for incrementally adding more data. Supernodes are assigned the VoidZ value. Most other nodes in a TIN are derived from input points or vertices of polylines and polygon boundaries. These are original, user input, data. Breakline enforcement may require the software to add densification, or Steiner , nodes. These are used to maintain line or polygon boundaries while simultaneously honoring Delaunay criteria.

ITinNodeInfo is used to determine a node's lineage; whether it's a supernode, an original node, or densification node. Since TINs don't store all node source information once a TIN is saved to disk some of this information is lost. Supernodes can always be differentiated from regular nodes, even after a TIN is saved, by testing their Z's against the VoidZ value.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

See Also:

Serialized Form

Constructor Summary

TinNode()
Constructs a TinNode using ArcGIS Engine.

TinNode(Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
TinNode theTinNode = (TinNode) obj;

Method Summary

boolean	equals(Object o) Compare this object with another
int	esri_getSource() The source of the node.
ITinNodeArray	getAdjacentNodes() Returns all nodes comprising triangles sharing the specified node.
static String	getClsid() getClsid.
int	getDegree(boolean bEnforcedEdgesOnly) The degree of the node.
ITinEdgeArray	getIncidentEdges() Returns all edges sharing the specified node.
ITinTriangleArray	getIncidentTriangles() Returns all triangles sharing the specified node.
int	getIndex() The element's index number.
int	getTagValue() The tag value of the specified element.
ITin	getTheTin() The TIN object referenced by the element.
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.
int	hashCode() the hashcode for this object
ITinTriangle	incidentTriangle() Returns any triangle having the node as one of it's vertices.
int	incidentTriangleIndex() Returns the index of any triangle having the node as one of it's vertices.
void	init(ITin pTin, int index) Initializes a new TIN element.
void	interfaceSupportsErrorInfo(GUID riid) interfaceSupportsErrorInfo
boolean	isEmpty() Indicates if the specified element is uninitialized.
boolean	isInsideDataArea() Indicates if the specified element is within the interpolation zone of the TIN.
boolean	isOnDomainBoundary() Indicates if the specified node is on domain's boundary.
boolean	isUseTagValue() Indicates whether tag value (if true) or edge type (if false) should be used to define the feature, in case the seed is an edge.
void	queryAdjacentNodeIndices(ILongArray pNodes) Returns all nodes connecting to the 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.
void	queryIncidentEdgeIndices(ILongArray pEdges) Returns all edges sharing the node.
void	queryIncidentTriangleIndices(ILongArray pTriangles) Returns all triangles sharing the node.
void	setEmpty() Uninitializes the element.
void	setUseTagValue(boolean pbUseTagValue) Indicates whether tag value (if true) or edge type (if false) should be used to define the feature, in case the seed is an edge.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef

getJintegraDispatch, release

Constructor Detail

TinNode

public TinNode()
        throws IOException,
               UnknownHostException

Constructs a TinNode using ArcGIS Engine.

Throws:

IOException - if there are interop problems

UnknownHostException - if there are interop problems

TinNode

public TinNode(Object obj)
        throws IOException

Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
TinNode theTinNode = (TinNode) obj;

Construct a TinNode using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to TinNode.

Parameters:

obj - an object returned from ArcGIS Engine or Server

Throws:

IOException - if there are interop problems

Method Detail

getClsid

public static String getClsid()

getClsid.

equals

public boolean equals(Object o)

Compare this object with another

Overrides:

equals in class Object

hashCode

public int hashCode()

the hashcode for this object

Overrides:

hashCode in class Object

isEmpty

public boolean isEmpty()
                throws IOException,
                       AutomationException

Indicates if the specified element is uninitialized.

Description

Indicates whether or not the element has been set with values.

When an element is instantiated using 'New' IsEmpty will return True.

When using QueryNext on one of the element enumerators, the end of the set is indicated by IsEmpty returning True.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

isEmpty in interface ITinElement

Returns:

The pbIsEmpty

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getTheTin

public ITin getTheTin()
               throws IOException,
                      AutomationException

The TIN object referenced by the element.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

getTheTin in interface ITinElement

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getIndex

public int getIndex()
             throws IOException,
                    AutomationException

The element's index number.

Description

Returns the index number of the element. TINs are composed of 1..n node, edge, and triangle elements. The base index number for TIN elements is 1.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

getIndex in interface ITinElement

Specified by:

getIndex in interface ITinFeatureSeed

Returns:

The pIndex

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getTagValue

public int getTagValue()
                throws IOException,
                       AutomationException

The tag value of the specified element.

Description

A tag value is a 32-bit long integer. Presently, only nodes and triangles support tags. Support for edge tags is anticipated in a future release. Tag values can be set to whatever the user wishes and their interpretation is left up to the user. Examples include accuracy codes on nodes or land cover codes on triangles.

A TIN layer has support to symbolize itself through the use of tag values.

The Identify tool used in ArcMap and ArcScene will report tag values.

The default tag value is 0.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

getTagValue in interface ITinElement

Specified by:

getTagValue in interface ITinFeatureSeed

Returns:

The pValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setEmpty

public void setEmpty()
              throws IOException,
                     AutomationException

Uninitializes the element.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

setEmpty in interface ITinElement

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

init

public void init(ITin pTin,
                 int index)
          throws IOException,
                 AutomationException

Initializes a new TIN element.

Description

After instantiating a new TIN element you can initialize its properties with Init. The input arguments include a TIN object and an index number. The base index number for nodes, edges, and triangles is 1.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

init in interface ITinElement

Parameters:

pTin - A reference to a com.esri.arcgis.geodatabase.ITin (in)

index - The index (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isInsideDataArea

public boolean isInsideDataArea()
                         throws IOException,
                                AutomationException

Indicates if the specified element is within the interpolation zone of the TIN.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

isInsideDataArea in interface ITinElement

Returns:

The pbIsInside

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getX

public 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

Specified by:

getX in interface ITinNode

Returns:

The x

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getY

public 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

Specified by:

getY in interface ITinNode

Returns:

The y

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getZ

public 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

Specified by:

getZ in interface ITinNode

Returns:

The z

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryAsPoint

public 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

Specified by:

queryAsPoint in interface ITinNode

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

public 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

Specified by:

queryAsWKSPointZ in interface ITinNode

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

public 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

Specified by:

getAdjacentNodes in interface ITinNode

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

public 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

Specified by:

getIncidentEdges in interface ITinNode

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

public 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

Specified by:

getIncidentTriangles in interface ITinNode

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

public 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

Specified by:

getVoronoiRegion in interface ITinNode

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.

esri_getSource

public int esri_getSource()
                   throws IOException,
                          AutomationException

The source of the node.

Product Availability

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

Specified by:

esri_getSource in interface ITinNode2

Returns:

A com.esri.arcgis.geodatabase.esriTinNodeSourceType constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDegree

public int getDegree(boolean bEnforcedEdgesOnly)
              throws IOException,
                     AutomationException

The degree of the node.

Product Availability

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

Specified by:

getDegree in interface ITinNode2

Parameters:

bEnforcedEdgesOnly - The bEnforcedEdgesOnly (in)

Returns:

The pDegree

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isOnDomainBoundary

public boolean isOnDomainBoundary()
                           throws IOException,
                                  AutomationException

Indicates if the specified node is on domain's boundary.

Description

The TIN's domain is the same thing as its interpolation zone. IsOnDomainBoundary returns TRUE if the node is on this boundary, separating data from nodata areas.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

isOnDomainBoundary in interface ITinNode2

Returns:

The pbIsOn

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryAdjacentNodeIndices

public void queryAdjacentNodeIndices(ILongArray pNodes)
                              throws IOException,
                                     AutomationException

Returns all nodes connecting to the node.

Description

Returns indices for nodes adjacent to the given node. These are its direct neighbors which are connected by triangle edges.

The passed object that implements ILongArray must have already been instantiated.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

queryAdjacentNodeIndices in interface ITinNode2

Parameters:

pNodes - A reference to a com.esri.arcgis.system.ILongArray (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryIncidentEdgeIndices

public void queryIncidentEdgeIndices(ILongArray pEdges)
                              throws IOException,
                                     AutomationException

Returns all edges sharing the node.

Description

This populates a LongArray with the indices of edges that surround the node.

The passed LongArray must already have been instantiated.

A single edge interpretation is used. This is where edges between adjacent triangles are shared.

Only edges that have their from node in common with the specified node are returned. Because of this, some boundary edges incident to super nodes will have no representation.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

queryIncidentEdgeIndices in interface ITinNode2

Parameters:

pEdges - A reference to a com.esri.arcgis.system.ILongArray (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

queryIncidentTriangleIndices

public void queryIncidentTriangleIndices(ILongArray pTriangles)
                                  throws IOException,
                                         AutomationException

Returns all triangles sharing the node.

Description

Returns indices for triangles incident to the node.

The passed object that implements ILongArray must have already been instantiated.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

queryIncidentTriangleIndices in interface ITinNode2

Parameters:

pTriangles - A reference to a com.esri.arcgis.system.ILongArray (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

incidentTriangle

public ITinTriangle incidentTriangle()
                              throws IOException,
                                     AutomationException

Returns any triangle having the node as one of it's vertices.

Description

Returns one of the triangles that is incident to the node. There is no fixed rule to determine which triangle it will be. You are just assured it will be one that is defined, in part, by the node.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

incidentTriangle in interface ITinNode2

Returns:

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

incidentTriangleIndex

public int incidentTriangleIndex()
                          throws IOException,
                                 AutomationException

Returns the index of any triangle having the node as one of it's vertices.

Description

Returns the index for one of the triangles incident to the node. There is no fixed rule to determine which triangle it will be. You are just assured it will be one that is defined, in part, by the node.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

incidentTriangleIndex in interface ITinNode2

Returns:

The pTriangle

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isUseTagValue

public boolean isUseTagValue()
                      throws IOException,
                             AutomationException

Indicates whether tag value (if true) or edge type (if false) should be used to define the feature, in case the seed is an edge.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

isUseTagValue in interface ITinFeatureSeed

Returns:

The pbUseTagValue

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setUseTagValue

public void setUseTagValue(boolean pbUseTagValue)
                    throws IOException,
                           AutomationException

Indicates whether tag value (if true) or edge type (if false) should be used to define the feature, in case the seed is an edge.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

setUseTagValue in interface ITinFeatureSeed

Parameters:

pbUseTagValue - The pbUseTagValue (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

interfaceSupportsErrorInfo

public void interfaceSupportsErrorInfo(GUID riid)
                                throws IOException,
                                       AutomationException

interfaceSupportsErrorInfo

Description

Indicates whether the interface supports IErrorInfo.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:

interfaceSupportsErrorInfo in interface ISupportErrorInfo

Parameters:

riid - A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.