com.esri.arcgis.geometry
Interface IGeometryEnvironment2

All Superinterfaces:

IGeometryEnvironment, Serializable

All Known Subinterfaces:

IGeometryEnvironment3, IGeometryEnvironment4

All Known Implementing Classes:

GeometryEnvironment

public interface IGeometryEnvironment2
extends IGeometryEnvironment, Serializable

Provides access to members that control additional global geometry variables.

Superseded By

IGeometryEnvironment4

Description

Adds additional functionality to the GeometryEnvironment to ensure a balance between compatibility with ArcInfo releases prior to 8.1, and proper restriction and reliability of results and errors returned by IRelationalOperators when they are used improperly.

Product Availability

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

Method Summary

double	getAngularAutoDensifyTolerance() The default angular increment to be used with angular densification.
double	getDeviationAutoDensifyTolerance() The default deviation distance to be used for curve segment densification.
boolean	isPre81Compatibility() Indicates if some geometric operations are compatible with releases previous to 8.1.
boolean	isUseAlternativeTopoOps() Indicates whether alternative versions of polygon intersection and union should be used.
void	setAngularAutoDensifyTolerance(double tolerance) The default angular increment to be used with angular densification.
void	setDeviationAutoDensifyTolerance(double tolerance) The default deviation distance to be used for curve segment densification.
void	setPre81Compatibility(boolean pre81Compatible) Indicates if some geometric operations are compatible with releases previous to 8.1.
void	setUseAlternativeTopoOps(boolean alternativeTopoOps) Indicates whether alternative versions of polygon intersection and union should be used.

Methods inherited from interface com.esri.arcgis.geometry.IGeometryEnvironment

getAutoDensifyTolerance, getNoDiceLimit, setAutoDensifyTolerance, setNoDiceLimit

Method Detail

setPre81Compatibility

void setPre81Compatibility(boolean pre81Compatible)
                           throws IOException,
                                  AutomationException

Indicates if some geometric operations are compatible with releases previous to 8.1. When set to false, return errors for some illegal relational operations (default is true).

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

pre81Compatible - The pre81Compatible (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isPre81Compatibility

boolean isPre81Compatibility()
                             throws IOException,
                                    AutomationException

Indicates if some geometric operations are compatible with releases previous to 8.1. When set to false, return errors for some illegal relational operations (default is true).

Description

Returns and sets the flag indicating the preference for extending compatibility with pre-ArcInfo 8.1 releases at the cost of allowing improperly used IRelationalOperator comparisons to return meaningless false values.

If Pre81Compatibility = TRUE, meaningless comparisons of non-Clementini geometries using Clementini relational operators returns FALSE (even though no meaningful relation actual took place).

If Pre81Compatibility = FALSE, these comparisons will return an error message indicating that the attempted comparison is invalid and would not have returned meaningful results. By default, Pre81Compatibility = TRUE.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The pre81Compatible

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setAngularAutoDensifyTolerance

void setAngularAutoDensifyTolerance(double tolerance)
                                    throws IOException,
                                           AutomationException

The default angular increment to be used with angular densification.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

tolerance - The tolerance (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getAngularAutoDensifyTolerance

double getAngularAutoDensifyTolerance()
                                      throws IOException,
                                             AutomationException

The default angular increment to be used with angular densification.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The tolerance

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setDeviationAutoDensifyTolerance

void setDeviationAutoDensifyTolerance(double tolerance)
                                      throws IOException,
                                             AutomationException

The default deviation distance to be used for curve segment densification.

Description

The DeviationAutoDensify controls the Densification factor use when performing automatic densification in ArcGIS. The automatic densification is used when exporting a feature class containing non-linear segments (CircularArc, EllipticArc, BezierCurve) to other files that don’t support non-linear segments. For example, when exporting to shapefile this parameter is used.

Remarks

Note : The number used here is the actual MaxDeviation. (see IPolycurve::Densify for more details)

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

tolerance - The tolerance (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDeviationAutoDensifyTolerance

double getDeviationAutoDensifyTolerance()
                                        throws IOException,
                                               AutomationException

The default deviation distance to be used for curve segment densification.

Description

The DeviationAutoDensify controls the Densification factor use when performing automatic densification in ArcGIS. The automatic densification is used when exporting a feature class containing non-linear segments (CircularArc, EllipticArc, BezierCurve) to other file that don’t support non-linear segments. For example, when exporting to shapefile this parameter is used.

Remarks

Note : The number used here is the actual MaxDeviation. (see IPolycurve::Densify for more details)

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The tolerance

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setUseAlternativeTopoOps

void setUseAlternativeTopoOps(boolean alternativeTopoOps)
                              throws IOException,
                                     AutomationException

Indicates whether alternative versions of polygon intersection and union should be used.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

alternativeTopoOps - The alternativeTopoOps (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isUseAlternativeTopoOps

boolean isUseAlternativeTopoOps()
                                throws IOException,
                                       AutomationException

Indicates whether alternative versions of polygon intersection and union should be used.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The alternativeTopoOps

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.