com.esri.arcgis.carto
Interface ITinRenderer

All Superinterfaces:
Serializable
All Known Subinterfaces:
ITerrainAttributeRenderer, ITerrainRenderer, ITerrainRenderer2
All Known Implementing Classes:
TerrainDirtyAreaRenderer, TerrainPointAttributeRenderer, TerrainPointElevationRenderer, TerrainPointUniqueValueRenderer, TinAspectRenderer, TinBreaklineRenderer, TinContourRenderer, TinEdgeRenderer, TinElevationRenderer, TinFaceRenderer, TinFaceValueRenderer, TinNodeElevationRenderer, TinNodeRenderer, TinNodeValueRenderer, TinSlopeRenderer

public interface ITinRenderer
extends Serializable

Provides access to members that control functions common to all TIN renderers.

Remarks

This interface is implemented by all ten TIN renderers at ArcGIS 9.0. It provides the basic info for a specific TIN renderer. The following sample VBA code shows a way to query a TIN renderer's name and visibility properties in ArcMap:

Sub ShowTinRenderer()
Dim pDoc As IMxDocument: Set pDoc = ThisDocument
Dim pMap As IMap: Set pMap = pDoc.Maps.Item(0) 'assuming we're working on the first map
Dim pTinLyr As ITinLayer: Set pTinLyr = pMap.Layer(0) 'assuming the first layer is a TIN layer

Dim i As Integer
For i = 0 To pTinLyr.RendererCount - 1
Dim pTinRenderer As ITinRenderer
Set pTinRenderer = pTinLyr.GetRenderer(i)
Debug.Print pTinRenderer.Name, pTinRenderer.Visible
Next i
End Sub

A TIN layer can have one of more TIN renderers. When you load a TIN dataset into an application, two default TIN renderers are added. Depending on applications, the two default TIN renderers vary. In ArcMap, the two default TIN renderers are Edge Type and Elevation renderers. In ArcScene, they're Edge Type and Faces.

The order of TIN renderers in the application has an effect on how the TIN is drawn. In ArcMap, the effect is the same as that in the the TOC in general; higher ones get drawn on top of the lower ones. In ArcScene, rendering conflict may arise if multiple renderers are drawn simultaneously (especially with face renderers) and that should be avoided.

Product Availability

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


Method Summary
 boolean canRender()
          Indicates if renderer can draw.
 void copy(ITinRenderer pSource)
          Copies the properties of the given renderer.
 void draw(int drawPhase, IDisplay display, ISpatialReference aSpatialReference, ITrackCancel trackCancel)
          Draws the TIN.
 String getName()
          The descriptive name of a renderer.
 ITin getTin()
          The TIN associated with the renderer.
 boolean isVisible()
          Indicates if the renderer is currently visible.
 void setName(String name)
          The descriptive name of a renderer.
 void setTinByRef(ITin ppTin)
          The TIN associated with the renderer.
 void setVisible(boolean visible)
          Indicates if the renderer is currently visible.
 

Method Detail

draw

void draw(int drawPhase,
          IDisplay display,
          ISpatialReference aSpatialReference,
          ITrackCancel trackCancel)
          throws IOException,
                 AutomationException
Draws the TIN.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
drawPhase - A com.esri.arcgis.system.esriDrawPhase constant (in)
display - A reference to a com.esri.arcgis.display.IDisplay (in)
aSpatialReference - A reference to a com.esri.arcgis.geometry.ISpatialReference (in)
trackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

copy

void copy(ITinRenderer pSource)
          throws IOException,
                 AutomationException
Copies the properties of the given renderer.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

canRender

boolean canRender()
                  throws IOException,
                         AutomationException
Indicates if renderer can draw.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setTinByRef

void setTinByRef(ITin ppTin)
                 throws IOException,
                        AutomationException
The TIN associated with the renderer.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

getTin

ITin getTin()
            throws IOException,
                   AutomationException
The TIN associated with the renderer.

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

getName

String getName()
               throws IOException,
                      AutomationException
The descriptive name of a renderer.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setName

void setName(String name)
             throws IOException,
                    AutomationException
The descriptive name of a renderer.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

isVisible

boolean isVisible()
                  throws IOException,
                         AutomationException
Indicates if the renderer is currently visible.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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

setVisible

void setVisible(boolean visible)
                throws IOException,
                       AutomationException
Indicates if the renderer is currently visible.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

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