com.esri.arcgis.geodatabaseextensions
Class IDynamicSurface2Proxy

java.lang.Object
  com.esri.arcgis.interop.Dispatch
      com.esri.arcgis.geodatabaseextensions.IDynamicSurfaceProxy
          com.esri.arcgis.geodatabaseextensions.IDynamicSurface2Proxy

All Implemented Interfaces:

IDynamicSurface, IDynamicSurface2, Externalizable, Serializable

Direct Known Subclasses:

IDynamicSurface3Proxy

public class IDynamicSurface2Proxy
extends IDynamicSurfaceProxy
implements IDynamicSurface2, Serializable

Provides access to members that utilize Terrain surfaces.

Description

This interface is new at ArcGIS 9.3. It supersedes IDynamicSurface.

Product Availability

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

See Also:

Serialized Form

Field Summary

boolean

noncastable

Fields inherited from class com.esri.arcgis.interop.Dispatch

DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, objRef

Constructor Summary

	IDynamicSurface2Proxy()
	IDynamicSurface2Proxy(Object obj)
protected	IDynamicSurface2Proxy(Object obj, String iid)

Method Summary

void	addListener(String iidStr, Object theListener, Object theSource)
void	getLineOfSight(IPoint pObserver, IPoint pTarget, double resolution, ITrackCancel pTrackCancel, IPoint[] ppObstruction, IPolyline[] ppVisibleLines, IPolyline[] ppInvisibleLines, boolean[] pbIsVisible, boolean bApplyCurvature, boolean bApplyRefraction, Object pRefractionFactor) Returns a line-of-sight.
void	getLineOfSightFeatureCursor(IFeatureCursor pCursor, double resolution, ITrackCancel pTrackCancel, IFeatureClass pOutputLines, IFeatureClass pObstructionPoints, boolean bApplyCurvature, boolean bApplyRefraction, Object pRefractionFactor) Get line-of-sight.
IPolygon	getTileBasedDataArea(ITrackCancel pTrackCancel) Get tile-based terrain's Data Area.
void	interpolateFeatureClass(IFeatureClass pInFeatureClass, IQueryFilter pFilter, double resolution, int type, IFeatureClass pOutFeatureClass, ITrackCancel pTrackCancel, Object pStepSize) Interpolates z values for features.
void	interpolateFeatureClassVertices(IFeatureClass pInFeatureClass, IQueryFilter pFilter, double resolution, int type, IFeatureClass pOutFeatureClass, ITrackCancel pTrackCancel) Interpolates z values for features.
void	interpolateFeatureCursor(IFeatureCursor pCursor, double resolution, int type, IFeatureClass pOutFeatureClass, ITrackCancel pTrackCancel, Object pStepSize) Interpolates z values for features.
void	interpolateFeatureCursorVertices(IFeatureCursor pCursor, double resolution, int type, IFeatureClass pOutFeatureClass, ITrackCancel pTrackCancel) Interpolates z values for features.
void	interpolateShape(IGeometry pInShape, double resolution, int type, ITrackCancel pTrackCancel, IGeometry[] ppOutShape, Object pStepSize) Interpolates z values for a defined geometric shape.
void	interpolateShapeVertices(IGeometry pInShape, double resolution, int type, ITrackCancel pTrackCancel, IGeometry[] ppOutShape) Interpolates z values for a defined geometric shape.
boolean	isCanDoCurvature() Indicates if earth curvature can be applied.
boolean	isMinimizeResourceUsage() Indicates whether or not resource uasge should be minimized.
boolean	isRefineBoundaryMatching() Indicates whether or not to refine boundary matching.
void	removeListener(String iidStr, Object theListener)
void	setMinimizeResourceUsage(boolean pbMinimize) Indicates whether or not resource uasge should be minimized.
void	setRefineBoundaryMatching(boolean pbRefine) Indicates whether or not to refine boundary matching.

Methods inherited from class com.esri.arcgis.geodatabaseextensions.IDynamicSurfaceProxy

getRasterBlockSize, getTerrain, getTin, queryAsFeatureClass, queryRaster, setRasterBlockSize

Methods inherited from class com.esri.arcgis.interop.Dispatch

bindUsingMoniker, constructVtblPosTable, convertToNative, cookieForListener, createDispatch, createObjrefMonikerDisplayName, equals, getActiveObject, getActiveObject, getDefaultProperty, getDispatchIdOfName, getLastErrorCode, getMtsObjectContext, getObjRef, getPropertyByName, getPropertyByName, getVtblPos, hashCode, initDispatch, invoke, invokeMethodByName, invokeMethodByName, invokeMethodByName, invokePropertyGetByName, invokePropertyPutByName, invokePropertyPutByRefByName, isNativeMode, isObjRef, optimizedVtblInvoke, queryInterface, readExternal, release, setNativeMode, setPropertyByName, toString, vtblInvoke, writeExternal

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.esri.arcgis.geodatabaseextensions.IDynamicSurface

getRasterBlockSize, getTerrain, getTin, queryAsFeatureClass, queryRaster, setRasterBlockSize

Field Detail

noncastable

public boolean noncastable

Constructor Detail

IDynamicSurface2Proxy

public IDynamicSurface2Proxy()

IDynamicSurface2Proxy

public IDynamicSurface2Proxy(Object obj)
                      throws IOException

Throws:

IOException

IDynamicSurface2Proxy

protected IDynamicSurface2Proxy(Object obj,
                                String iid)
                         throws IOException

Throws:

IOException

Method Detail

addListener

public void addListener(String iidStr,
                        Object theListener,
                        Object theSource)
                 throws IOException

Overrides:

addListener in class IDynamicSurfaceProxy

Throws:

IOException

removeListener

public void removeListener(String iidStr,
                           Object theListener)
                    throws IOException

Overrides:

removeListener in class IDynamicSurfaceProxy

Throws:

IOException

setMinimizeResourceUsage

public void setMinimizeResourceUsage(boolean pbMinimize)
                              throws IOException,
                                     AutomationException

Indicates whether or not resource uasge should be minimized.

Product Availability

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

Specified by:

setMinimizeResourceUsage in interface IDynamicSurface2

Parameters:

pbMinimize - The pbMinimize (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isMinimizeResourceUsage

public boolean isMinimizeResourceUsage()
                                throws IOException,
                                       AutomationException

Indicates whether or not resource uasge should be minimized.

Description

By default, MinimizeResourceUsage is set to FALSE: if possible, it will construct TINs, from which to interpolate heights, using multiple terrain tiles at once. This applies to interpolation for both features and rasters. Whether or not it can do this depends on the amount of data required for the given area of interest, desired pyramid level, and available physical memory. This approach tends to improve performance at the expense of some memory resources. Setting the property to TRUE forces the terrain to triangulate no more than one tile at a time in memory, interpolating heights in an iterative, chunked, fashion. This sacrifices performance in favor of minimizing memory use.

Product Availability

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

Specified by:

isMinimizeResourceUsage in interface IDynamicSurface2

Returns:

The pbMinimize

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setRefineBoundaryMatching

public void setRefineBoundaryMatching(boolean pbRefine)
                               throws IOException,
                                      AutomationException

Indicates whether or not to refine boundary matching.

Product Availability

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

Specified by:

setRefineBoundaryMatching in interface IDynamicSurface2

Parameters:

pbRefine - The pbRefine (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isRefineBoundaryMatching

public boolean isRefineBoundaryMatching()
                                 throws IOException,
                                        AutomationException

Indicates whether or not to refine boundary matching.

Description

Operations such as rasterization and feature interpolation are performed iteratively on chuncks of terrain data. One or more contiguous terrain tiles are used to form chunks. When using a pyramid level other than full resolution the surfaces between neighboring chunk boundaries may not align, resulting in artifacts. Setting RefineBoundaryMatching to TRUE improves the match between these boundaries.

Product Availability

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

Specified by:

isRefineBoundaryMatching in interface IDynamicSurface2

Returns:

The pbRefine

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

interpolateShape

public void interpolateShape(IGeometry pInShape,
                             double resolution,
                             int type,
                             ITrackCancel pTrackCancel,
                             IGeometry[] ppOutShape,
                             Object pStepSize)
                      throws IOException,
                             AutomationException

Interpolates z values for a defined geometric shape.

Description

pInShape is the input geometry for which heights will be interpolated. The shape types supported are points, multipoints, polylines, and polygons.

Resolution controls which pyramid level of the terrain to use as a surface. Depending on the type of filter used to generate the terrain pyramid, resolution represents either the z-tolerance or window size of the desired pyramid level. Pass a value of 0.0 to use the full resolution surface.

Type is used to control which interpolant is applied; linear or natural neighbors.

pTrackCancel supports process interruption. This can be set to NULL ('Nothing' in VB).

pOutShape is a placeholder for the resulting 3D geometry. It does not need to reference an instantiated, empty geometry. The geometry will be created by the function. The result will be NULL ('Nothing' in VB) if the input geometry does not have any overlap with the 2D extent of the surface.

stepSize is used to densify input polylines and polygon boundaries. If stepsize is omitted input polylines and polygon boundaries will be densified where they intersect terrain triangle edges. Typically, stepSize should be omitted when using linear interpolation because the 'natural' densification applied with triangle edges is sufficient to capture what information is available in the surface.

Notes

This function is best used to interpolate heights for one feature that crosses over multiple terrain tiles which, at the desired resolution, can't all be held in memory. An alternative is IDynamicSurface2.InterpolateFeatureClass, which is optimized for processing multiple features. If multiple features fall within an extent of the terrain which can be held in memory (estimate this using ITerrain.GetPointCount) then consider using IDynamicSurface.GetTin followed by ISurface.InterpolateShape on the TIN. Another approach would be to retreive a TIN using ITerrainLayer.GetCurrentSurface followed by ISurface.InterpolateShape on the TIN if the current representation of a terrain layer's surface is sufficient.

Product Availability

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

Specified by:

interpolateShape in interface IDynamicSurface2

Parameters:

pInShape - A reference to a com.esri.arcgis.geometry.IGeometry (in)

resolution - The resolution (in)

type - A com.esri.arcgis.geodatabase.esriSurfaceInterpolationType constant (in)

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

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

pStepSize - A Variant (in, optional, pass null if not required)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

interpolateShapeVertices

public void interpolateShapeVertices(IGeometry pInShape,
                                     double resolution,
                                     int type,
                                     ITrackCancel pTrackCancel,
                                     IGeometry[] ppOutShape)
                              throws IOException,
                                     AutomationException

Interpolates z values for a defined geometric shape.

Description

pInShape is the input geometry for which heights will be interpolated. The shape types supported are points, multipoints, polylines, and polygons. Heights will only be calculated for input vertices. No densification of polyline or polygon vertices takes place.

Resolution controls which pyramid level of the terrain to use as a surface. Depending on the type of filter used to generate the terrain pyramid, resolution represents either the z-tolerance or window size of the desired pyramid level. Pass a value of 0.0 to use the full resolution surface.

Type is used to control which interpolant is applied; linear or natural neighbors.

pTrackCancel supports process interruption. This can be set to NULL ('Nothing' in VB).

pOutShape is a placeholder for the resulting 3D geometry. It does not need to reference an instantiated object. The geometry will be created by the function. The result will be NULL ('Nothing' in VB) if any part of the geometry falls outside the surface.

Notes

This function is best used to interpolate heights for one feature that crosses over multiple terrain tiles which, at the desired resolution, can't all be held in memory. An alternative is IDynamicSurface2.InterpolateFeatureClassVertices, which is optimized for processing multiple features. If multiple features fall within an extent of the terrain which can be held in memory (estimate this using ITerrain.GetPointCount) then consider using IDynamicSurface.GetTin followed by ISurface.InterpolateShapeVertices on the TIN. Another approach would be to retreive a TIN using ITerrainLayer.GetCurrentSurface followed by ISurface.InterpolateShapeVertices on the TIN if the current representation of a terrain layer's surface is sufficient.

Product Availability

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

Specified by:

interpolateShapeVertices in interface IDynamicSurface2

Parameters:

pInShape - A reference to a com.esri.arcgis.geometry.IGeometry (in)

resolution - The resolution (in)

type - A com.esri.arcgis.geodatabase.esriSurfaceInterpolationType constant (in)

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

interpolateFeatureClass

public void interpolateFeatureClass(IFeatureClass pInFeatureClass,
                                    IQueryFilter pFilter,
                                    double resolution,
                                    int type,
                                    IFeatureClass pOutFeatureClass,
                                    ITrackCancel pTrackCancel,
                                    Object pStepSize)
                             throws IOException,
                                    AutomationException

Interpolates z values for features.

Description

InterpolateFeatureClass interpolates heights for shapes from an input feature class into a new feature class. The output will contain 3D geometry.

pInFeatureClass contains the input features. The shape types supported are points, multipoints, polylines, and polygons.

pFilter is a query filter used on the input features. It may be set to NULL ('Nothing n VB).

Resolution controls which pyramid level of the terrain to use as a surface. Depending on the type of filter used to generate the terrain pyramid, resolution represents either the z-tolerance or window size of the desired pyramid level. Pass a value of 0.0 to use the full resolution surface.

Type is used to control which interpolant is applied; linear or natural neighbors.

pOutFeatureClass is where features are written. It must be z-enabled (i.e.; IGeometryDef.HasZ = TRUE). Attribute fields and values will be copied from the input to the output. Input features that fall completely off the surface will not be written to the output.

pTrackCancel supports process interruption. This can be set to NULL ('Nothing' in VB).

stepSize is used to densify input polylines and polygon boundaries. If stepsize is omitted input polylines and polygon boundaries will be densified where they intersect terrain triangle edges. Typically, stepSize should be omitted when using linear interpolation because the 'natural' densification applied with triangle edges is sufficient to capture what information is available in the surface.

Product Availability

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

Specified by:

interpolateFeatureClass in interface IDynamicSurface2

Parameters:

pInFeatureClass - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)

pFilter - A reference to a com.esri.arcgis.geodatabase.IQueryFilter (in)

resolution - The resolution (in)

type - A com.esri.arcgis.geodatabase.esriSurfaceInterpolationType constant (in)

pOutFeatureClass - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

pStepSize - A Variant (in, optional, pass null if not required)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

interpolateFeatureCursor

public void interpolateFeatureCursor(IFeatureCursor pCursor,
                                     double resolution,
                                     int type,
                                     IFeatureClass pOutFeatureClass,
                                     ITrackCancel pTrackCancel,
                                     Object pStepSize)
                              throws IOException,
                                     AutomationException

Interpolates z values for features.

Description

If stepsize is omitted, and the interpolation option is set to natural neighbors, input polylines and polygon boundaries will be densified where they intersect terrain triangle edges.

Product Availability

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

Specified by:

interpolateFeatureCursor in interface IDynamicSurface2

Parameters:

pCursor - A reference to a com.esri.arcgis.geodatabase.IFeatureCursor (in)

resolution - The resolution (in)

type - A com.esri.arcgis.geodatabase.esriSurfaceInterpolationType constant (in)

pOutFeatureClass - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

pStepSize - A Variant (in, optional, pass null if not required)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

interpolateFeatureClassVertices

public void interpolateFeatureClassVertices(IFeatureClass pInFeatureClass,
                                            IQueryFilter pFilter,
                                            double resolution,
                                            int type,
                                            IFeatureClass pOutFeatureClass,
                                            ITrackCancel pTrackCancel)
                                     throws IOException,
                                            AutomationException

Interpolates z values for features.

Product Availability

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

Specified by:

interpolateFeatureClassVertices in interface IDynamicSurface2

Parameters:

pInFeatureClass - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)

pFilter - A reference to a com.esri.arcgis.geodatabase.IQueryFilter (in)

resolution - The resolution (in)

type - A com.esri.arcgis.geodatabase.esriSurfaceInterpolationType constant (in)

pOutFeatureClass - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)

pTrackCancel - 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.

interpolateFeatureCursorVertices

public void interpolateFeatureCursorVertices(IFeatureCursor pCursor,
                                             double resolution,
                                             int type,
                                             IFeatureClass pOutFeatureClass,
                                             ITrackCancel pTrackCancel)
                                      throws IOException,
                                             AutomationException

Interpolates z values for features.

Product Availability

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

Specified by:

interpolateFeatureCursorVertices in interface IDynamicSurface2

Parameters:

pCursor - A reference to a com.esri.arcgis.geodatabase.IFeatureCursor (in)

resolution - The resolution (in)

type - A com.esri.arcgis.geodatabase.esriSurfaceInterpolationType constant (in)

pOutFeatureClass - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)

pTrackCancel - 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.

isCanDoCurvature

public boolean isCanDoCurvature()
                         throws IOException,
                                AutomationException

Indicates if earth curvature can be applied.

Description

Indicates whether earth curvature correction can be applied to line of sight functions. The result will be TRUE as long as both XY and Z coordinate systems for the terrain are defined.

Product Availability

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

Specified by:

isCanDoCurvature in interface IDynamicSurface2

Returns:

The pbCanDo

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getLineOfSight

public void getLineOfSight(IPoint pObserver,
                           IPoint pTarget,
                           double resolution,
                           ITrackCancel pTrackCancel,
                           IPoint[] ppObstruction,
                           IPolyline[] ppVisibleLines,
                           IPolyline[] ppInvisibleLines,
                           boolean[] pbIsVisible,
                           boolean bApplyCurvature,
                           boolean bApplyRefraction,
                           Object pRefractionFactor)
                    throws IOException,
                           AutomationException

Returns a line-of-sight.

Product Availability

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

Specified by:

getLineOfSight in interface IDynamicSurface2

Parameters:

pObserver - A reference to a com.esri.arcgis.geometry.IPoint (in)

pTarget - A reference to a com.esri.arcgis.geometry.IPoint (in)

resolution - The resolution (in)

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

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

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

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

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

bApplyCurvature - The bApplyCurvature (in)

bApplyRefraction - The bApplyRefraction (in)

pRefractionFactor - A Variant (in, optional, pass null if not required)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getLineOfSightFeatureCursor

public void getLineOfSightFeatureCursor(IFeatureCursor pCursor,
                                        double resolution,
                                        ITrackCancel pTrackCancel,
                                        IFeatureClass pOutputLines,
                                        IFeatureClass pObstructionPoints,
                                        boolean bApplyCurvature,
                                        boolean bApplyRefraction,
                                        Object pRefractionFactor)
                                 throws IOException,
                                        AutomationException

Get line-of-sight.

Product Availability

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

Specified by:

getLineOfSightFeatureCursor in interface IDynamicSurface2

Parameters:

pCursor - A reference to a com.esri.arcgis.geodatabase.IFeatureCursor (in)

resolution - The resolution (in)

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)

pOutputLines - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)

pObstructionPoints - A reference to a com.esri.arcgis.geodatabase.IFeatureClass (in)

bApplyCurvature - The bApplyCurvature (in)

bApplyRefraction - The bApplyRefraction (in)

pRefractionFactor - A Variant (in, optional, pass null if not required)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getTileBasedDataArea

public IPolygon getTileBasedDataArea(ITrackCancel pTrackCancel)
                              throws IOException,
                                     AutomationException

Get tile-based terrain's Data Area.

Description

GetTileBasedDataArea returns a polygon that represents the union of the terrain's data tiles. It ignores the presense of any clip or erase features. This function provides a relatively fast means of extracting a rough approximation of the terrain's data area.

pTrackCancel is a reference to a CancelTracker which can be used to escape the process. A NULL pointer ('Nothing' in VB) can be past if desired.

Product Availability

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

Specified by:

getTileBasedDataArea in interface IDynamicSurface2

Parameters:

pTrackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (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.