com.esri.arcgis.geodatabaseextensions
Interface ITerrainBlockCursor

All Superinterfaces:

Serializable

All Known Implementing Classes:

ITerrainBlockCursorProxy, TerrainBlockCursor

public interface ITerrainBlockCursor
extends Serializable

Provides access to TerrainBlockCursor object.

Product Availability

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

Method Summary

int	getBlockCount() The number of blocks in the cursor.
void	next(int[] pRowBegin, int[] pRowEnd, int[] pColBegin, int[] pColEnd, boolean[] pbIsEnd) Returns next block in the form of rows and columns.
void	nextAsTin(ITin[] ppTin, IEnvelope[] ppExtent) Returns next block as a reference to a TIN object.
void	reset() Resets the cursor to point to the first block.

Method Detail

getBlockCount

int getBlockCount()
                  throws IOException,
                         AutomationException

The number of blocks in the cursor.

Description

The total number of blocks in the cursor. While this value is generally reliable it's possible for it to change in the event an overload condition is discovered for a block and it needs to be subdivided into multiple blocks. Therefore, it may be need to be checked each successive call to Next or NextAsTin if it's being used to track progress.

Product Availability

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

Returns:

The pcBlocks

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

next

void next(int[] pRowBegin,
          int[] pRowEnd,
          int[] pColBegin,
          int[] pColEnd,
          boolean[] pbIsEnd)
          throws IOException,
                 AutomationException

Returns next block in the form of rows and columns.

Description

Returns the row and column numbers of the terrain tiles associated with the next block. These can be passed to IDynamicSurface3.ConvertToExtent if getting the spatial extent of the block is desired.

bEnd is set to TRUE when there are no more blocks. Thus the row and column values are not to be used when bEnd is TRUE.

Product Availability

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

Parameters:

pRowBegin - The pRowBegin (out: use single element array)

pRowEnd - The pRowEnd (out: use single element array)

pColBegin - The pColBegin (out: use single element array)

pColEnd - The pColEnd (out: use single element array)

pbIsEnd - The pbIsEnd (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

nextAsTin

void nextAsTin(ITin[] ppTin,
               IEnvelope[] ppExtent)
               throws IOException,
                      AutomationException

Returns next block as a reference to a TIN object.

Description

Returns a TIN for the area represented by the next block in the cursor.

pTin is the output TIN for the next block. This will be returned NULL when there are no more blocks.

pExtent is an output envelope represeting the neatline, tile based, boundary for the block. The extent of the envelope may fall outside the data area of the TIN on the perimeter of the terrain where data does not fill the extent of the tiles. The extent of the envelope may fall within the data extent of the TIN for areas on the inside of the terrain. This is intentional and is designed to provide data overlap between neighboring blocks. This completes interpolation neighborhoods along block boundaries so that analytic results performed separately on the TINs for neighboring blocks match after being clipped by their respective block extents and merged.

Product Availability

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

Parameters:

ppTin - A reference to a com.esri.arcgis.geodatabase.ITin (out: use single element array)

ppExtent - A reference to a com.esri.arcgis.geometry.IEnvelope (out: use single element array)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

reset

void reset()
           throws IOException,
                  AutomationException

Resets the cursor to point to the first block.

Description

Returns the cursor to the initial block.

Product Availability

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.