com.esri.arcgis.geodatabase
Interface ITin

All Superinterfaces:
Serializable
All Known Subinterfaces:
ITinAdvanced, ITinAdvanced2
All Known Implementing Classes:
Tin

public interface ITin
extends Serializable

Provides access to members that control TINs.

Product Availability

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


Method Summary
 int getDataEdgeCount()
          The number of TIN edges that have a data triangle on one side or the other.
 int getDataNodeCount()
          The number of data nodes in the TIN.
 int getDataTriangleCount()
          The number of data triangles in the TIN.
 IEnvelope getExtent()
          The interpolation zone of the TIN.
 IFields getFields()
          The collection of attribute items of the TIN.
 int getVersion()
          Returns the version number of the TIN engine used to build the TIN.
 double getZFactor()
          Multiplication factor applied to all z values in a TIN to provide unit-congruency between coordinate components.
 boolean isDelaunay()
          Indicates if TIN was constructed using Delaunay triangulation.
 boolean isEmpty()
          Indicates if the TIN contains no data.
 boolean isHasEdgeTagValues()
          Indicates if the TIN dataset has edge tag values.
 boolean isHasNodeTagValues()
          Indicates if the TIN dataset has node tag values.
 boolean isHasTriangleTagValues()
          Indicates if the TIN dataset has triangle tag values.
 void saveAs(String newName, Object pOverWrite)
          Saves the TIN to disk using the specified name.
 void setZFactor(double pFactor)
          Multiplication factor applied to all z values in a TIN to provide unit-congruency between coordinate components.
 

Method Detail

isEmpty

boolean isEmpty()
                throws IOException,
                       AutomationException
Indicates if the TIN contains no data.

Remarks

IsEmpty is TRUE if the TIN contains no user data. In this state the TIN only has the four dummy nodes and two NODATA triangles added automatically by the software at the time the TIN was created.

IsEmpty is FALSE if any user data has been added to the TIN.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

isDelaunay

boolean isDelaunay()
                   throws IOException,
                          AutomationException
Indicates if TIN was constructed using Delaunay triangulation.

Remarks

IsDelaunay is TRUE if the circumscribing circles for all triangles in the TIN do not contain any of the nodes used to construct the TIN. Nodes may fall on the circumcircle perimeters but not inside.

IsDelaunay is FALSE if the above condition is not met.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

saveAs

void saveAs(String newName,
            Object pOverWrite)
            throws IOException,
                   AutomationException
Saves the TIN to disk using the specified name.

Description

SaveAs saves the TIN to disk using the specified name. The interface pointer will reference the saved TIN after the call is made.

Remarks

Use SaveAs for copying a TIN and for saving any edits made to a TIN.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
newName - The newName (in)
pOverWrite - A Variant (in, optional, pass null if not required)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getExtent

IEnvelope getExtent()
                    throws IOException,
                           AutomationException
The interpolation zone of the TIN.

Description

Extent returns the 2D data extent of the TIN. This is the minimum bounding rectangle of the interpolation zone.

Remarks

Extent returns the 2D data extent of the TIN. It's useful for any purpose that needs to determine a TIN's XY coordinate range.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getDataNodeCount

int getDataNodeCount()
                     throws IOException,
                            AutomationException
The number of data nodes in the TIN.

Remarks

The DataNodeCount is the number of nodes in the TIN that are associated with data triangles. Nodes that are surrounded only by masked triangles are excluded from this count.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getDataEdgeCount

int getDataEdgeCount()
                     throws IOException,
                            AutomationException
The number of TIN edges that have a data triangle on one side or the other.

Remarks

The DataEdgeCount is the number of edges in the TIN associated with data triangles. Edges that have masked triangles on either side are excluded from this count.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getDataTriangleCount

int getDataTriangleCount()
                         throws IOException,
                                AutomationException
The number of data triangles in the TIN.

Remarks

The DataTriangleCount is the number of data triangles in the TIN. Masked triangles are excluded from this count.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getZFactor

double getZFactor()
                  throws IOException,
                         AutomationException
Multiplication factor applied to all z values in a TIN to provide unit-congruency between coordinate components.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setZFactor

void setZFactor(double pFactor)
                throws IOException,
                       AutomationException
Multiplication factor applied to all z values in a TIN to provide unit-congruency between coordinate components.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
pFactor - The pFactor (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getVersion

int getVersion()
               throws IOException,
                      AutomationException
Returns the version number of the TIN engine used to build the TIN.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

isHasNodeTagValues

boolean isHasNodeTagValues()
                           throws IOException,
                                  AutomationException
Indicates if the TIN dataset has node tag values.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

isHasEdgeTagValues

boolean isHasEdgeTagValues()
                           throws IOException,
                                  AutomationException
Indicates if the TIN dataset has edge tag values.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

isHasTriangleTagValues

boolean isHasTriangleTagValues()
                               throws IOException,
                                      AutomationException
Indicates if the TIN dataset has triangle tag values.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getFields

IFields getFields()
                  throws IOException,
                         AutomationException
The collection of attribute items of the TIN.

Description

Returns fields used to represent intrinsic attributes of the TIN.

While a TIN doesn't have attributes stored in a database table it does have intrinsic properties that can be treated like attributes. In this manner, TINs can 'pretend' to be like other data types that have attributes. An identify operation is an example where this behavior is useful. An identify tool asks the dataset what attributes (fields) it has and what the values are for a selected feature. For TINs it's based on selected location.

Fields are Elevation, Slope, Aspect, Node Tag Value, and Face Tag Value.

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