Class GeometryEnvironmentClass

Namespace
ESRI.ArcGIS.Geometry
Assembly
ESRI.Server.Geometry.dll
[ClassInterface(ClassInterfaceType.None)]
[Guid("11735DAE-816C-11D0-82F5-0000F8034032")]
public class GeometryEnvironmentClass : GeometryEnvironment, ISupportErrorInfo, IConstructAngle, IGeometryFactory3, IGeometryFactory2, IGeometryFactory, IGeometryEnvironment4, IGeometryEnvironment3, IGeometryEnvironment2, IGeometryEnvironment, IExtrude, IEncode3DProperties, IConstructDomainExtent, IGeometryBridge2, IGeometryBridge, IConstructMerge, IConstructClothoid
Inheritance
GeometryEnvironmentClass
Implements
Inherited Members

Constructors

GeometryEnvironmentClass()

public GeometryEnvironmentClass()

Explicit Interface Implementations

AddGeometries(IGeometryCollection, ref IGeometry[])

Adds references to the specified geometries.

virtual void AddGeometries(IGeometryCollection pGeometryCollection, ref IGeometry[] newGeometries)

Parameters

pGeometryCollection IGeometryCollection
newGeometries IGeometry[]

AddPoints(IPointCollection4, ref IPoint[])

Adds copies of the input points as vertices to this Path, Ring, Polyline, or Polygon; or references to the input points to this Multipoint, Triangles, TriangleFan, or TriangleStrip.

virtual void AddPoints(IPointCollection4 pPointCollection, ref IPoint[] newPoints)

Parameters

pPointCollection IPointCollection4
newPoints IPoint[]

AddSegments(ISegmentCollection, ref ISegment[])

Adds references to segments.

virtual void AddSegments(ISegmentCollection pSegmentCollection, ref ISegment[] newSegments)

Parameters

pSegmentCollection ISegmentCollection
newSegments ISegment[]

AddWKSPointZs(IPointCollection4, ref WKSPointZ[])

Adds vertices/points to this Path, Ring, Polyline, Polygon, Multipoint, Triangles, TriangleFan, TriangleStrip, or MultiPatch.

virtual void AddWKSPointZs(IPointCollection4 pPointCollection, ref WKSPointZ[] pointStructures)

Parameters

pPointCollection IPointCollection4
pointStructures WKSPointZ[]

AddWKSPoints(IPointCollection4, ref WKSPoint[])

Adds vertices to this Path, Ring, Polyline, or Polygon, or adds new points to this Multipoint, Triangles, TriangleFan, or TriangleStrip.

virtual void AddWKSPoints(IPointCollection4 pPointCollection, ref WKSPoint[] pointStructures)

Parameters

pPointCollection IPointCollection4
pointStructures WKSPoint[]

AngularAutoDensifyTolerance

The default angular increment to be used with angular densification.

virtual double AngularAutoDensifyTolerance { get; set; }

Returns

double

AutoDensifyTolerance

The maximum distance by which on-the-fly deviation-based densification may differ from the original. If the value is less than or equal to zero, the system will try to pick a reasonable tolerance at the time of densification.

virtual double AutoDensifyTolerance { get; set; }

Returns

double

ConstructBuffers(ITopologicalOperator2, ref double[])

Constructs a set of buffers at various distances. More efficient than calling Buffer repeatedly on the same geometry.

virtual IEnumGeometry ConstructBuffers(ITopologicalOperator2 pTopologicalOperator, ref double[] distances)

Parameters

pTopologicalOperator ITopologicalOperator2
distances double[]

Returns

IEnumGeometry

ConstructClothoidByAngle(IPoint, IPoint, bool, double, double, double, esriCurveDensifyMethod, double)

Constructs a pieccewise linear approximation to a clothoid spiral. Curvature is the reciprocal of the radius, so specify a curvature of 0 for an infinite radius. deflectionAngle is positive and is the change in direction (in radians) from the starting curve ta

virtual IPolyline ConstructClothoidByAngle(IPoint pFrom, IPoint pFromTangent, bool bCurveRight, double fromCurvature, double toCurvature, double deflectionAngle, esriCurveDensifyMethod __MIDL__IConstructClothoid0001, double densifyParameter)

Parameters

pFrom IPoint
pFromTangent IPoint
bCurveRight bool
fromCurvature double
toCurvature double
deflectionAngle double
__MIDL__IConstructClothoid0001 esriCurveDensifyMethod
densifyParameter double

Returns

IPolyline

ConstructClothoidByLength(IPoint, IPoint, bool, double, double, double, esriCurveDensifyMethod, double)

Constructs a pieccewise linear approximation to a clothoid spiral. Curvature is the reciprocal of the radius, so specify a curvature of 0 for an infinite radius. curveLength is the design length of the curve.

virtual IPolyline ConstructClothoidByLength(IPoint pFrom, IPoint pFromTangent, bool bCurveRight, double fromCurvature, double toCurvature, double curveLength, esriCurveDensifyMethod __MIDL__IConstructClothoid0000, double densifyParameter)

Parameters

pFrom IPoint
pFromTangent IPoint
bCurveRight bool
fromCurvature double
toCurvature double
curveLength double
__MIDL__IConstructClothoid0000 esriCurveDensifyMethod
densifyParameter double

Returns

IPolyline

ConstructDomainExtent(IEnvelope, double)

Constructs a new envelope by expanding the input envelope about its center. Scale is typically a power of 10 indicating the number of sig figs to preserve. If its zero, the extent is expanded 1.5 times (subject to some constraints).

virtual IEnvelope ConstructDomainExtent(IEnvelope extent, double Scale)

Parameters

extent IEnvelope
Scale double

Returns

IEnvelope

Remarks

The 'scale factor' parameter is typically a power of 10 that specifies the number of significant digits to preserve for coordinates associated with a spatial reference having as its domain the envelope constructed by this method. The constructed envelope has the same center as the input envelope and an extent determined by the scale factor and the version of the spatial reference associated with the input envelope. For example, with a scale factor of 10^5 and a version 9.2 spatial reference, the width/height of the constructed extent will be (2^53-2)/10^5 ˜ 9.0 x 10^10 data units. With a pre 9.2 spatial reference, the constructed extent will be (2^31-2)/10^5 ˜ 2.1 x 10^4 data units.

If the input scale factor is zero, a default output extent is calculated. Typically, that extent will be 1.5 times the maximum extent of the input envelope. The constructed extent will be intersected against the horizon envelope of the spatial reference of the input envelope's spatial reference. Also, if it is too large (> 10^7) the expansion factor will be reduced to 1.1.

The output envelope will have the same set of vertex attributes and spatial reference as the input envelope.

[C#]

//This example demonstrates how to use the ConstructDomainExtent method.
private void ConstructDomainExtent_ExampleDriver()
{
    //The precision corresponds to the extent.
    //So the InputEnvelope == OutputEnvelope
    IEnvelope testEnvelope1 = new EnvelopeClass();
    testEnvelope1.PutCoords(-10000, -10000, 11474.83645, 11474.83645);
    double testPrecision1 = 100000;
    String title1 = "Example1";
    ConstructDomainExtent_Example(testEnvelope1, testPrecision1, title1);
    //The extent is then adjusted to fit the precision.
    //The new extent is different from the input extent to adopt the input precision.
    IEnvelope testEnvelope2 = new EnvelopeClass();
    testEnvelope2.PutCoords(-10000, -10000, 11474.83645, 11474.83645);
    double testPrecision2 = 10000;
    String title2 = "Example2";
    ConstructDomainExtent_Example(testEnvelope2, testPrecision2, title2);
    //The precision doesn't correspond to the input extent and the input precision is 0.
    //The new extent is different from the input extent to adopt the input precision.
    IEnvelope testEnvelope3 = new EnvelopeClass();
    testEnvelope3.PutCoords(-10000, -10000, 11474.83645, 11474.83645);
    double testPrecision3 = 0;
    String title3 = "Example3";
    ConstructDomainExtent_Example(testEnvelope3, testPrecision3, title3);
}
private void ConstructDomainExtent_Example(IEnvelope inputExtend, double precsision, String title)
{
    IConstructDomainExtent constructDomainExtent = new GeometryEnvironmentClass();
    IEnvelope newExtent = constructDomainExtent.ConstructDomainExtent(inputExtend, precsision);
    ISpatialReference spatialReference = new UnknownCoordinateSystemClass();
    spatialReference.SetDomain(newExtent.XMin, newExtent.XMax, newExtent.YMin, newExtent.YMax);
    double falseX;
    double falseY;
    double xyUnits;
    spatialReference.GetFalseOriginAndUnits(out falseX, out falseY, out xyUnits);
    String report = title + "\n" +
                    "Input Extend \n" +
                    inputExtend.XMax + " , " + inputExtend.YMax + " , " + inputExtend.XMin + " , " + inputExtend.YMin + " \n " +
                    "Calculated envelope coordinates \n" +
                    newExtent.XMax + " , " + newExtent.YMax + " , " + newExtent.XMin + " , " + newExtent.YMin + " \n " +
                    "False X, False Y and XyUnits of the new created spatial reference \n" +
                    falseX + " , " + falseY + " , " + xyUnits;








































    System.Windows.Forms.MessageBox.Show(report);
}

[Visual Basic .NET]

    'This example demonstrates how to use the ConstructDomainExtent method
    Sub ConstructDomainExtent_Example()
        Dim pConstructDomainExtent As IConstructDomainExtent
        Dim pNewExtent As IEnvelope, dPrecision As Double
        Dim pExtent As IEnvelope, pspref As ISpatialReference
        Dim dx As Double, dy As Double, dxy As Double
        pConstructDomainExtent = New GeometryEnvironment
        pExtent = New Envelope
        '*********************************************************************
        '* Example 1: Default XYDomain value when creating a new feature class
        '* The precision corresponds to the extent.
        '*********************************************************************
        Debug.Print("*********** Example 1 ***********")
        Debug.Print("*Input Extent")
        Debug.Print("-10000, -10000, 11474.83645, 11474.83645")
        pExtent.PutCoords(-10000, -10000, 11474.83645, 11474.83645)
        dPrecision = 100000
        pNewExtent = pConstructDomainExtent.ConstructDomainExtent(pExtent, dPrecision)
        'Here since the input envelope corresponds to the precision
        'the ouput envelope is equal to the input envelope
        Debug.Print("*Calculated envelope coordinates")
        Debug.Print(pNewExtent.XMin & " , " & pNewExtent.XMax & " , " & pNewExtent.YMin & " , " & pNewExtent.YMax)
        'Create a new spatial reference and used the calculated envelope
        'to set the domain of it
        pspref = New UnknownCoordinateSystem
        pspref.SetDomain(pNewExtent.XMin, pNewExtent.XMax, pNewExtent.YMin, pNewExtent.YMax)
        'Print the precision of the new spatial reference
        pspref.GetFalseOriginAndUnits(dx, dy, dxy)
        Debug.Print("*False X, False Y and XyUnits of the new created spatial reference")
        Debug.Print(dx & " , " & dy & " , " & dxy)
        '*********************************************************************
        '* Example 2: The precision doesn't correspond to the input extent
        '* The extent is then adjusted to fit the precision
        '*********************************************************************
        Debug.Print("*********** Example 2 ***********")
        Debug.Print("*Input Extent")
        Debug.Print("-10000, -10000, 11474.83645, 11474.83645")
        pExtent.PutCoords(-10000, -10000, 11474.83645, 11474.83645)
        dPrecision = 10000
        pNewExtent = pConstructDomainExtent.ConstructDomainExtent(pExtent, dPrecision)
        Debug.Print("*Calculated envelope coordinates")
        'Here the new extent is different from the input extent to adopt the input precision
        Debug.Print(pNewExtent.XMin & " , " & pNewExtent.XMax & " , " & pNewExtent.YMin & " , " & pNewExtent.YMax)
        pspref = New UnknownCoordinateSystem
        pspref.SetDomain(pNewExtent.XMin, pNewExtent.XMax, pNewExtent.YMin, pNewExtent.YMax)
        pspref.GetFalseOriginAndUnits(dx, dy, dxy)
        Debug.Print("*False X, False Y and XyUnits of the new created spatial reference")
        Debug.Print(dx & " , " & dy & " , " & dxy)














































        '*********************************************************************
        '* Example 3: The precision doesn't correspond to the input extent
        '* and the input precision is 0
        '*********************************************************************
        Debug.Print("*********** Example 3 ***********")
        Debug.Print("*Input Extent")
        Debug.Print("-10000, -10000, 11474.83645, 11474.83645")
        pExtent.PutCoords(-10000, -10000, 11474.83645, 11474.83645)
        dPrecision = 0
        pNewExtent = pConstructDomainExtent.ConstructDomainExtent(pExtent, dPrecision)
        Debug.Print("*Calculated envelope coordinates")
        'Here the new extent is different from the input extent to adopt the input precision
        Debug.Print(pNewExtent.XMin & " , " & pNewExtent.XMax & " , " & pNewExtent.YMin & " , " & pNewExtent.YMax)
        pspref = New UnknownCoordinateSystem
        pspref.SetDomain(pNewExtent.XMin, pNewExtent.XMax, pNewExtent.YMin, pNewExtent.YMax)
        pspref.GetFalseOriginAndUnits(dx, dy, dxy)
        Debug.Print("*False X, False Y and XyUnits of the new created spatial reference")
        Debug.Print(dx & " , " & dy & " , " & dxy)
















    End Sub

ConstructLine(ILine)

Constructs the angle between the infinite line containing the input line segment and the positive x-axis.

virtual double ConstructLine(ILine inLine)

Parameters

inLine ILine

Returns

double

Remarks

 
IConstructAngle ConstructLine Example
[Visual Basic .NET]

Private Shared Sub constructLine()

     Dim pPtFrom As IPoint

     Dim pPtTo As IPoint

     pPtFrom = New Point

     pPtTo = New Point

     Dim pLine As ILine

     pLine = New Line

     pPtFrom.PutCoords(0, 0)

     pPtTo.PutCoords(1, 1)

     pLine.PutCoords(pPtFrom, pPtTo)

     Dim pCAngle As IConstructAngle

     Dim pGEnv As GeometryEnvironment

     pGEnv = New GeometryEnvironment

     pCAngle = pGEnv

     Dim dAngle As Double

     dAngle = pCAngle.ConstructLine(pLine)

     MsgBox("The angle from the x-axis to the line is " & dAngle)

End Sub

ConstructSplitClothoidByAngle(IPoint, IPoint, IPoint, bool, double, double, double, out double, out double, out double, out ILine)

Same as ConstructClothoidByAngle but reports curve parameters for point on curve closest to split query point.

virtual void ConstructSplitClothoidByAngle(IPoint pSplitQuery, IPoint pFrom, IPoint pFromTangent, bool bCurveRight, double fromCurvature, double toCurvature, double deflectionAngle, out double pSplitCurvature, out double pSplitLength, out double pSplitAngle, out ILine ppSplitTangent)

Parameters

pSplitQuery IPoint
pFrom IPoint
pFromTangent IPoint
bCurveRight bool
fromCurvature double
toCurvature double
deflectionAngle double
pSplitCurvature double
pSplitLength double
pSplitAngle double
ppSplitTangent ILine

ConstructSplitClothoidByLength(IPoint, IPoint, IPoint, bool, double, double, double, out double, out double, out double, out ILine)

Same as ConstructClothoidByLength but reports curve parameters for point on curve closest to split query point.

virtual void ConstructSplitClothoidByLength(IPoint pSplitQuery, IPoint pFrom, IPoint pFromTangent, bool bCurveRight, double fromCurvature, double toCurvature, double curveLength, out double pSplitCurvature, out double pSplitLength, out double pSplitAngle, out ILine ppSplitTangent)

Parameters

pSplitQuery IPoint
pFrom IPoint
pFromTangent IPoint
bCurveRight bool
fromCurvature double
toCurvature double
curveLength double
pSplitCurvature double
pSplitLength double
pSplitAngle double
ppSplitTangent ILine

ConstructThreePoint(IPoint, IPoint, IPoint)

Constructs the angle included in three points.

virtual double ConstructThreePoint(IPoint from, IPoint through, IPoint to)

Parameters

from IPoint
through IPoint
to IPoint

Returns

double

Remarks

 

ConstructAngle ConstructThreePoint Example

[C#]
// Calculates the angle defined by the 3 points.
public void constructAngle()
{
    IPoint fromPoint = new ESRI.ArcGIS.Geometry.Point();
    IPoint throughPoint = new ESRI.ArcGIS.Geometry.Point();
    IPoint toPoint = new ESRI.ArcGIS.Geometry.Point();
    fromPoint.PutCoords(1, 0);
    toPoint.PutCoords(1, 1);
    throughPoint.PutCoords(0, 0);
    GeometryEnvironment geometryEnvironment = new GeometryEnvironment();
    IConstructAngle constructAngle = geometryEnvironment as IConstructAngle;
    double angle = constructAngle.ConstructThreePoint(fromPoint, throughPoint, toPoint);
    System.Windows.Forms.MessageBox.Show("The constructed angle is " + angle);
}
[Visual Basic .NET]

   ' Calculates the angle defined by the 3 points.

    Public Sub t_construct_angle()
        Dim pPtFrom As IPoint
        Dim pPtThrough As IPoint
        Dim pPtTo As IPoint


        pPtFrom = New Point
        pPtThrough = New Point
        pPtTo = New Point

        pPtFrom.PutCoords(1, 0)
        pPtTo.PutCoords(1, 1)
        pPtThrough.PutCoords(0, 0)

        Dim pCAngle As IConstructAngle
        Dim pGEnv As GeometryEnvironment

        pGEnv = New GeometryEnvironment
        pCAngle = pGEnv

        Dim dAngle As Double
        dAngle = pCAngle.ConstructThreePoint(pPtFrom, pPtThrough, pPtTo)

        MsgBox("The constructed angle is " & dAngle)

    End Sub

ConstructZMDomainExtent(double, double, double, out double, out double)

Constructs a low precision Z or M domain extent centered on the specified extent. scale is 1/(desired resolution). If scale is 0.0, a default of 1,000,000.0 is used.

virtual void ConstructZMDomainExtent(double inMin, double inMax, double Scale, out double outMin, out double outMax)

Parameters

inMin double
inMax double
Scale double
outMin double
outMax double

CreateEmptyGeometryByESRIType(esriShapeType, out IGeometry)

Create an empty geometry of the specified Esri shape file type.

virtual void CreateEmptyGeometryByESRIType(esriShapeType shapeType, out IGeometry outGeometry)

Parameters

shapeType esriShapeType
outGeometry IGeometry

CreateEmptyGeometryByType(esriGeometryType, out IGeometry)

Creates an empty geometry of the specified ArcObjects geometry type.

virtual void CreateEmptyGeometryByType(esriGeometryType GeometryType, out IGeometry outGeometry)

Parameters

GeometryType esriGeometryType
outGeometry IGeometry

CreateGeometry(ref int, ref byte, out IGeometry)

Create a point, polyline, polygon, or multipoint from the specified shapefile format buffer.

virtual void CreateGeometry(ref int byteCountInOut, ref byte geometryInfo, out IGeometry outGeometry)

Parameters

byteCountInOut int
geometryInfo byte
outGeometry IGeometry

CreateGeometryEx(int, ref int, ref byte, out IGeometry)

Create a point, polyline, polygon, or multipoint from the specified shapefile format buffer.

virtual void CreateGeometryEx(int importFlags, ref int byteCountInOut, ref byte geometryInfo, out IGeometry outGeometry)

Parameters

importFlags int
byteCountInOut int
geometryInfo byte
outGeometry IGeometry

CreateGeometryFromEnumerator(IEnumGeometry)

Creates a geometry bag containing references to geometries returned by the input geometry enumerator.

virtual IGeometry CreateGeometryFromEnumerator(IEnumGeometry geometries)

Parameters

geometries IEnumGeometry

Returns

IGeometry

CreateGeometryFromWkb(ref int, ref byte, out IGeometry)

Create a point, polyline, polygon, or multipoint from the specified OGIS WKB format buffer.

virtual void CreateGeometryFromWkb(ref int byteCountInOut, ref byte geometryInfo, out IGeometry outGeometry)

Parameters

byteCountInOut int
geometryInfo byte
outGeometry IGeometry

CreateGeometryFromWkbVariant(object, out IGeometry, out int)

Create a point, polyline, polygon, or multipoint from the specified OGIS WKB format buffer.

virtual void CreateGeometryFromWkbVariant(object wkb, out IGeometry outGeometry, out int numBytesRead)

Parameters

wkb object
outGeometry IGeometry
numBytesRead int

CreateWkbVariantFromGeometry(IGeometry)

Creates an OGC WKB format from a geometry object.

virtual object CreateWkbVariantFromGeometry(IGeometry inGeometry)

Parameters

inGeometry IGeometry

Returns

object

Densify(ISegment, double, ref int, ref ILine[])

Densify segment into the specified number of smaller segments.

virtual void Densify(ISegment pSegment, double maxDeviation, ref int pcOutSegments, ref ILine[] segments)

Parameters

pSegment ISegment
maxDeviation double
pcOutSegments int
segments ILine[]

DeviationAutoDensifyTolerance

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

virtual double DeviationAutoDensifyTolerance { get; set; }

Returns

double

Remarks

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

DiceWithTrapezoids

Selects dicing algorithm. True means dicing with trapezoids, False means dicing with smaller polygons and polypolygons. True by default.

virtual bool DiceWithTrapezoids { get; set; }

Returns

bool

DicingEnabled

Indicates whether large polygons are diced before being sent to GDI. True by default.

virtual bool DicingEnabled { get; set; }

Returns

bool

ExpandSubPixelParts

Selects export to WIN32 shape mode. True means export without loss of sub-pixel parts, False means eliminating parts that degenerate into single pixel. False by default.

virtual bool ExpandSubPixelParts { get; set; }

Returns

bool

Extrude(double, IGeometry)

Extrude using an input geometry as one base and offsetting the Zs already set on the input geometry to get the second base.

virtual IGeometry Extrude(double OffsetZ, IGeometry baseGeom)

Parameters

OffsetZ double
baseGeom IGeometry

Returns

IGeometry

Remarks

All non-linear segments are treated as linear segments when extrusion is performed.  Only Polylines, Polygons, Envelopes, Points, and Multipoints are allowed as input geometries.  Polylines, Polygons, and Envelopes will output MultiPatches while Points and Multipoints will output Polylines.

IExtrude Extrude Example

ExtrudeAbsolute(double, IGeometry)

Extrude a geometry using its initial Zs for one base, and a uniform input Z for the other.

virtual IGeometry ExtrudeAbsolute(double toZ, IGeometry baseGeom)

Parameters

toZ double
baseGeom IGeometry

Returns

IGeometry

Remarks

All non-linear segments are treated as linear segments when extrusion is performed.  Only Polylines, Polygons, Envelopes, Points, and Multipoints are allowed as input geometries.  Polylines, Polygons, and Envelopes will output MultiPatches while Points and Multipoints will output Polylines.

IExtrude ExtrudeAbsolute Example

ExtrudeAlongLine(ILine, IGeometry)

Extrude a geometry along a specified line, using the Zs on the two ends of the line to set Zs on the top and bottom.

virtual IGeometry ExtrudeAlongLine(ILine extrusionLine, IGeometry baseGeom)

Parameters

extrusionLine ILine
baseGeom IGeometry

Returns

IGeometry

Remarks

All non-linear segments are treated as linear segments when extrusion is performed.  Only Polylines, Polygons, Envelopes, Points, and Multipoints are allowed as input geometries.  Polylines, Polygons, and Envelopes will output MultiPatches while Points and Multipoints will output Polylines.

IExtrude ExtrudeAlongLine Example

ExtrudeBetween(IFunctionalSurface, IFunctionalSurface, IGeometry)

Extrude a geometry between two functional surfaces.

virtual IGeometry ExtrudeBetween(IFunctionalSurface fromSurface, IFunctionalSurface toSurface, IGeometry baseGeom)

Parameters

fromSurface IFunctionalSurface
toSurface IFunctionalSurface
baseGeom IGeometry

Returns

IGeometry

Remarks

All non-linear segments are treated as linear segments when extrusion is performed.  Only Polylines, Polygons, Envelopes, Points, and Multipoints are allowed as input geometries.  Polylines, Polygons, and Envelopes will output MultiPatches while Points and Multipoints will output Polylines.  Z values from the FunctionalSurfaces are only calculated at Points in the input Geometry.

IExtrude ExtrudeBetween Example

ExtrudeFromTo(double, double, IGeometry)

Extrude a geometry between two specified Z values.

virtual IGeometry ExtrudeFromTo(double fromZ, double toZ, IGeometry baseGeom)

Parameters

fromZ double
toZ double
baseGeom IGeometry

Returns

IGeometry

Remarks

All non-linear segments are treated as linear segments when extrusion is performed.  Only Polylines, Polygons, Envelopes, Points, and Multipoints are allowed as input geometries.  Polylines, Polygons, and Envelopes will output MultiPatches while Points and Multipoints will output Polylines.

IExtrude ExtrudeFromTo Example

ExtrudeRelative(IVector3D, IGeometry)

Extrude a geometry along a specified vector, using Zs already set on the input geometry.

virtual IGeometry ExtrudeRelative(IVector3D extrusionVector, IGeometry baseGeom)

Parameters

extrusionVector IVector3D
baseGeom IGeometry

Returns

IGeometry

Remarks

All non-linear segments are treated as linear segments when extrusion is performed.  Only Polylines, Polygons, Envelopes, Points, and Multipoints are allowed as input geometries.  Polylines, Polygons, and Envelopes will output MultiPatches while Points and Multipoints will output Polylines.

IExtrude ExtrudeRelative Example

GetPoints(IPointCollection4, int, ref IPoint[])

Populates an array with references to points in the Multipoint. The QueryPoints method on IPointCollection makes copies of the points.

virtual void GetPoints(IPointCollection4 pPointCollection, int Index, ref IPoint[] Points)

Parameters

pPointCollection IPointCollection4
Index int
Points IPoint[]

IGeometryBridge2_AddGeometries(IGeometryCollection, ref IGeometry[])

virtual void IGeometryBridge2_AddGeometries(IGeometryCollection pGeometryCollection, ref IGeometry[] newGeometries)

Parameters

pGeometryCollection IGeometryCollection
newGeometries IGeometry[]

IGeometryBridge2_AddPoints(IPointCollection4, ref IPoint[])

virtual void IGeometryBridge2_AddPoints(IPointCollection4 pPointCollection, ref IPoint[] newPoints)

Parameters

pPointCollection IPointCollection4
newPoints IPoint[]

IGeometryBridge2_AddSegments(ISegmentCollection, ref ISegment[])

virtual void IGeometryBridge2_AddSegments(ISegmentCollection pSegmentCollection, ref ISegment[] newSegments)

Parameters

pSegmentCollection ISegmentCollection
newSegments ISegment[]

IGeometryBridge2_AddWKSPointZs(IPointCollection4, ref WKSPointZ[])

virtual void IGeometryBridge2_AddWKSPointZs(IPointCollection4 pPointCollection, ref WKSPointZ[] pointStructures)

Parameters

pPointCollection IPointCollection4
pointStructures WKSPointZ[]

IGeometryBridge2_ConstructBuffers(ITopologicalOperator2, ref double[])

virtual IEnumGeometry IGeometryBridge2_ConstructBuffers(ITopologicalOperator2 pTopologicalOperator, ref double[] distances)

Parameters

pTopologicalOperator ITopologicalOperator2
distances double[]

Returns

IEnumGeometry

IGeometryBridge2_Densify(ISegment, double, ref int, ref ILine[])

virtual void IGeometryBridge2_Densify(ISegment pSegment, double maxDeviation, ref int pcOutSegments, ref ILine[] segments)

Parameters

pSegment ISegment
maxDeviation double
pcOutSegments int
segments ILine[]

IGeometryBridge2_GetPoints(IPointCollection4, int, ref IPoint[])

virtual void IGeometryBridge2_GetPoints(IPointCollection4 pPointCollection, int Index, ref IPoint[] Points)

Parameters

pPointCollection IPointCollection4
Index int
Points IPoint[]

IGeometryBridge2_InsertGeometries(IGeometryCollection, int, ref IGeometry[])

virtual void IGeometryBridge2_InsertGeometries(IGeometryCollection pGeometryCollection, int Index, ref IGeometry[] newGeometries)

Parameters

pGeometryCollection IGeometryCollection
Index int
newGeometries IGeometry[]

IGeometryBridge2_InsertPoints(IPointCollection4, int, ref IPoint[])

virtual void IGeometryBridge2_InsertPoints(IPointCollection4 pPointCollection, int Index, ref IPoint[] newPoints)

Parameters

pPointCollection IPointCollection4
Index int
newPoints IPoint[]

IGeometryBridge2_InsertSegments(ISegmentCollection, int, ref ISegment[])

virtual void IGeometryBridge2_InsertSegments(ISegmentCollection pSegmentCollection, int Index, ref ISegment[] newSegments)

Parameters

pSegmentCollection ISegmentCollection
Index int
newSegments ISegment[]

IGeometryBridge2_InsertWKSPointZs(IPointCollection4, int, ref WKSPointZ[])

virtual void IGeometryBridge2_InsertWKSPointZs(IPointCollection4 pPointCollection, int Index, ref WKSPointZ[] newPoints)

Parameters

pPointCollection IPointCollection4
Index int
newPoints WKSPointZ[]

IGeometryBridge2_QueryBeginningRings(IMultiPatch, int, ref IRing[])

virtual void IGeometryBridge2_QueryBeginningRings(IMultiPatch pMultiPatch, int ringTypesDesired, ref IRing[] beginningRings)

Parameters

pMultiPatch IMultiPatch
ringTypesDesired int
beginningRings IRing[]

IGeometryBridge2_QueryFollowingRings(IMultiPatch, IRing, ref IRing[])

virtual void IGeometryBridge2_QueryFollowingRings(IMultiPatch pMultiPatch, IRing beginningRing, ref IRing[] followingRings)

Parameters

pMultiPatch IMultiPatch
beginningRing IRing
followingRings IRing[]

IGeometryBridge2_QueryGeometries(IGeometryCollection, int, ref IGeometry[])

virtual void IGeometryBridge2_QueryGeometries(IGeometryCollection pGeometryCollection, int Index, ref IGeometry[] geometries)

Parameters

pGeometryCollection IGeometryCollection
Index int
geometries IGeometry[]

IGeometryBridge2_QueryPoints(IPointCollection4, int, ref IPoint[])

virtual void IGeometryBridge2_QueryPoints(IPointCollection4 pPointCollection, int Index, ref IPoint[] Points)

Parameters

pPointCollection IPointCollection4
Index int
Points IPoint[]

IGeometryBridge2_QuerySegments(ISegmentCollection, int, ref ISegment[])

virtual void IGeometryBridge2_QuerySegments(ISegmentCollection pSegmentCollection, int Index, ref ISegment[] segments)

Parameters

pSegmentCollection ISegmentCollection
Index int
segments ISegment[]

IGeometryBridge2_QueryWKSPointZs(IPointCollection4, int, ref WKSPointZ[])

virtual void IGeometryBridge2_QueryWKSPointZs(IPointCollection4 pPointCollection, int Index, ref WKSPointZ[] pointStructures)

Parameters

pPointCollection IPointCollection4
Index int
pointStructures WKSPointZ[]

IGeometryBridge2_ReplacePoints(IPointCollection4, int, int, ref IPoint[])

virtual void IGeometryBridge2_ReplacePoints(IPointCollection4 pPointCollection, int Index, int goingAway, ref IPoint[] newPoints)

Parameters

pPointCollection IPointCollection4
Index int
goingAway int
newPoints IPoint[]

IGeometryBridge2_ReplaceSegments(ISegmentCollection, int, int, ref ISegment[])

virtual void IGeometryBridge2_ReplaceSegments(ISegmentCollection pSegmentCollection, int Index, int goingAway, ref ISegment[] newSegments)

Parameters

pSegmentCollection ISegmentCollection
Index int
goingAway int
newSegments ISegment[]

IGeometryBridge2_SetGeometries(IGeometryCollection, ref IGeometry[])

virtual void IGeometryBridge2_SetGeometries(IGeometryCollection pGeometryCollection, ref IGeometry[] newGeometries)

Parameters

pGeometryCollection IGeometryCollection
newGeometries IGeometry[]

IGeometryBridge2_SetPoints(IPointCollection4, ref IPoint[])

virtual void IGeometryBridge2_SetPoints(IPointCollection4 pPointCollection, ref IPoint[] newPoints)

Parameters

pPointCollection IPointCollection4
newPoints IPoint[]

IGeometryBridge2_SetSegments(ISegmentCollection, ref ISegment[])

virtual void IGeometryBridge2_SetSegments(ISegmentCollection pSegmentCollection, ref ISegment[] newSegments)

Parameters

pSegmentCollection ISegmentCollection
newSegments ISegment[]

IGeometryBridge2_SetWKSPointZs(IPointCollection4, ref WKSPointZ[])

virtual void IGeometryBridge2_SetWKSPointZs(IPointCollection4 pPointCollection, ref WKSPointZ[] pointStructures)

Parameters

pPointCollection IPointCollection4
pointStructures WKSPointZ[]

IGeometryEnvironment2_AutoDensifyTolerance

virtual double IGeometryEnvironment2_AutoDensifyTolerance { get; set; }

Returns

double

IGeometryEnvironment2_NoDiceLimit

virtual int IGeometryEnvironment2_NoDiceLimit { get; set; }

Returns

int

IGeometryEnvironment3_AngularAutoDensifyTolerance

virtual double IGeometryEnvironment3_AngularAutoDensifyTolerance { get; set; }

Returns

double

IGeometryEnvironment3_AutoDensifyTolerance

virtual double IGeometryEnvironment3_AutoDensifyTolerance { get; set; }

Returns

double

IGeometryEnvironment3_DeviationAutoDensifyTolerance

virtual double IGeometryEnvironment3_DeviationAutoDensifyTolerance { get; set; }

Returns

double

IGeometryEnvironment3_NoDiceLimit

virtual int IGeometryEnvironment3_NoDiceLimit { get; set; }

Returns

int

IGeometryEnvironment3_Pre81Compatibility

virtual bool IGeometryEnvironment3_Pre81Compatibility { get; set; }

Returns

bool

IGeometryEnvironment3_UseAlternativeTopoOps

virtual bool IGeometryEnvironment3_UseAlternativeTopoOps { get; set; }

Returns

bool

IGeometryEnvironment4_AngularAutoDensifyTolerance

virtual double IGeometryEnvironment4_AngularAutoDensifyTolerance { get; set; }

Returns

double

IGeometryEnvironment4_AutoDensifyTolerance

virtual double IGeometryEnvironment4_AutoDensifyTolerance { get; set; }

Returns

double

IGeometryEnvironment4_DeviationAutoDensifyTolerance

virtual double IGeometryEnvironment4_DeviationAutoDensifyTolerance { get; set; }

Returns

double

IGeometryEnvironment4_DicingEnabled

virtual bool IGeometryEnvironment4_DicingEnabled { get; set; }

Returns

bool

IGeometryEnvironment4_NoDiceLimit

virtual int IGeometryEnvironment4_NoDiceLimit { get; set; }

Returns

int

IGeometryEnvironment4_Pre81Compatibility

virtual bool IGeometryEnvironment4_Pre81Compatibility { get; set; }

Returns

bool

IGeometryEnvironment4_UseAlternativeTopoOps

virtual bool IGeometryEnvironment4_UseAlternativeTopoOps { get; set; }

Returns

bool

IGeometryFactory2_CreateEmptyGeometryByESRIType(esriShapeType, out IGeometry)

virtual void IGeometryFactory2_CreateEmptyGeometryByESRIType(esriShapeType shapeType, out IGeometry outGeometry)

Parameters

shapeType esriShapeType
outGeometry IGeometry

IGeometryFactory2_CreateEmptyGeometryByType(esriGeometryType, out IGeometry)

virtual void IGeometryFactory2_CreateEmptyGeometryByType(esriGeometryType GeometryType, out IGeometry outGeometry)

Parameters

GeometryType esriGeometryType
outGeometry IGeometry

IGeometryFactory2_CreateGeometry(ref int, ref byte, out IGeometry)

virtual void IGeometryFactory2_CreateGeometry(ref int byteCountInOut, ref byte geometryInfo, out IGeometry outGeometry)

Parameters

byteCountInOut int
geometryInfo byte
outGeometry IGeometry

IGeometryFactory2_CreateGeometryFromEnumerator(IEnumGeometry)

virtual IGeometry IGeometryFactory2_CreateGeometryFromEnumerator(IEnumGeometry geometries)

Parameters

geometries IEnumGeometry

Returns

IGeometry

IGeometryFactory2_CreateGeometryFromWkb(ref int, ref byte, out IGeometry)

virtual void IGeometryFactory2_CreateGeometryFromWkb(ref int byteCountInOut, ref byte geometryInfo, out IGeometry outGeometry)

Parameters

byteCountInOut int
geometryInfo byte
outGeometry IGeometry

IGeometryFactory2_CreateGeometryFromWkbVariant(object, out IGeometry, out int)

virtual void IGeometryFactory2_CreateGeometryFromWkbVariant(object wkb, out IGeometry outGeometry, out int numBytesRead)

Parameters

wkb object
outGeometry IGeometry
numBytesRead int

IGeometryFactory3_CreateEmptyGeometryByESRIType(esriShapeType, out IGeometry)

virtual void IGeometryFactory3_CreateEmptyGeometryByESRIType(esriShapeType shapeType, out IGeometry outGeometry)

Parameters

shapeType esriShapeType
outGeometry IGeometry

IGeometryFactory3_CreateEmptyGeometryByType(esriGeometryType, out IGeometry)

virtual void IGeometryFactory3_CreateEmptyGeometryByType(esriGeometryType GeometryType, out IGeometry outGeometry)

Parameters

GeometryType esriGeometryType
outGeometry IGeometry

IGeometryFactory3_CreateGeometry(ref int, ref byte, out IGeometry)

virtual void IGeometryFactory3_CreateGeometry(ref int byteCountInOut, ref byte geometryInfo, out IGeometry outGeometry)

Parameters

byteCountInOut int
geometryInfo byte
outGeometry IGeometry

IGeometryFactory3_CreateGeometryFromEnumerator(IEnumGeometry)

virtual IGeometry IGeometryFactory3_CreateGeometryFromEnumerator(IEnumGeometry geometries)

Parameters

geometries IEnumGeometry

Returns

IGeometry

IGeometryFactory3_CreateGeometryFromWkb(ref int, ref byte, out IGeometry)

virtual void IGeometryFactory3_CreateGeometryFromWkb(ref int byteCountInOut, ref byte geometryInfo, out IGeometry outGeometry)

Parameters

byteCountInOut int
geometryInfo byte
outGeometry IGeometry

IGeometryFactory3_CreateGeometryFromWkbVariant(object, out IGeometry, out int)

virtual void IGeometryFactory3_CreateGeometryFromWkbVariant(object wkb, out IGeometry outGeometry, out int numBytesRead)

Parameters

wkb object
outGeometry IGeometry
numBytesRead int

IGeometryFactory3_CreateWkbVariantFromGeometry(IGeometry)

virtual object IGeometryFactory3_CreateWkbVariantFromGeometry(IGeometry inGeometry)

Parameters

inGeometry IGeometry

Returns

object

InsertGeometries(IGeometryCollection, int, ref IGeometry[])

Inserts at the specified index references to some number of geometries in the input array.

virtual void InsertGeometries(IGeometryCollection pGeometryCollection, int Index, ref IGeometry[] newGeometries)

Parameters

pGeometryCollection IGeometryCollection
Index int
newGeometries IGeometry[]

InsertPoints(IPointCollection4, int, ref IPoint[])

Inserts copies of the input points as vertices into a Path, Ring, Polyline, or Polygon; or references to the input points into a Multipoint, Triangles, TriangleFan, or TriangleStrip.

virtual void InsertPoints(IPointCollection4 pPointCollection, int Index, ref IPoint[] newPoints)

Parameters

pPointCollection IPointCollection4
Index int
newPoints IPoint[]

InsertSegments(ISegmentCollection, int, ref ISegment[])

Inserts references to the input segments.

virtual void InsertSegments(ISegmentCollection pSegmentCollection, int Index, ref ISegment[] newSegments)

Parameters

pSegmentCollection ISegmentCollection
Index int
newSegments ISegment[]

InsertWKSPointZs(IPointCollection4, int, ref WKSPointZ[])

Inserts new vertices/points into this Path, Ring, Polyline, Polygon, Multipoint, Triangles, TriangleFan, TriangleStrip, or MultiPatch.

virtual void InsertWKSPointZs(IPointCollection4 pPointCollection, int Index, ref WKSPointZ[] newPoints)

Parameters

pPointCollection IPointCollection4
Index int
newPoints WKSPointZ[]

InsertWKSPoints(IPointCollection4, int, ref WKSPoint[])

Inserts new vertices/points into this Path, Ring, Polyline, Polygon, Multipoint, Triangles, TriangleFan, TriangleStrip, or MultiPatch.

virtual void InsertWKSPoints(IPointCollection4 pPointCollection, int Index, ref WKSPoint[] pointStructures)

Parameters

pPointCollection IPointCollection4
Index int
pointStructures WKSPoint[]

InterfaceSupportsErrorInfo(ref Guid)

virtual void InterfaceSupportsErrorInfo(ref Guid riid)

Parameters

riid Guid

MergeGeometries(IGeometry, IGeometry, IGeometry)

Merges the representation from both versions of a geometry that has been modifed

virtual IGeometry MergeGeometries(IGeometry pOriginal, IGeometry pEdit1, IGeometry pEdit2)

Parameters

pOriginal IGeometry
pEdit1 IGeometry
pEdit2 IGeometry

Returns

IGeometry

Remarks

IConstructMerge pConstMrg = new GeometryEnvironmentClass() as IConstructMerge;

/*IGeometry origGeom;

IGeometry geom1;

IGeometry geom2;

...*/

IGeometry newGeom = pConstMrg.MergeGeometries(origGeom, geom1, geom2);

NoDiceLimit

Polygons with fewer than this number of vertices will not be drawn/printed as a collection of trapezoids.

virtual int NoDiceLimit { get; set; }

Returns

int

Remarks


NoDiceLimit
controls how many vertices must be in the polygon when exporting the geometry to a format that can be directly used by the Win32 drawing API. By default, the limit is 20,000 vertices.

PackNormal(IVector3D, out double)

Encodes a normal into part of a double. A normal and texture information can both be packed in a single double without conflict.

virtual void PackNormal(IVector3D normalVector, out double packedNormal)

Parameters

normalVector IVector3D
packedNormal double

PackTexture2D(double, double, out double)

Encodes texture coordinates into part of a double. A normal and texture information can both be packed in a single double without conflict.

virtual void PackTexture2D(double textureS, double textureT, out double packedTexture)

Parameters

textureS double
textureT double
packedTexture double

Pre81Compatibility

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

virtual bool Pre81Compatibility { get; set; }

Returns

bool

QueryBeginningRings(IMultiPatch, int, ref IRing[])

Populates an array with references to all beginning rings of the specified types.

virtual void QueryBeginningRings(IMultiPatch pMultiPatch, int ringTypesDesired, ref IRing[] beginningRings)

Parameters

pMultiPatch IMultiPatch
ringTypesDesired int
beginningRings IRing[]

QueryFollowingRings(IMultiPatch, IRing, ref IRing[])

Populates an array with references to following rings that are in the ring group that starts with the specified beginning ring.

virtual void QueryFollowingRings(IMultiPatch pMultiPatch, IRing beginningRing, ref IRing[] followingRings)

Parameters

pMultiPatch IMultiPatch
beginningRing IRing
followingRings IRing[]

QueryGeometries(IGeometryCollection, int, ref IGeometry[])

Populates the array with references to a sub-sequence of geometries.

virtual void QueryGeometries(IGeometryCollection pGeometryCollection, int Index, ref IGeometry[] geometries)

Parameters

pGeometryCollection IGeometryCollection
Index int
geometries IGeometry[]

QueryPoints(IPointCollection4, int, ref IPoint[])

Copies some points to an existing array of points.

virtual void QueryPoints(IPointCollection4 pPointCollection, int Index, ref IPoint[] Points)

Parameters

pPointCollection IPointCollection4
Index int
Points IPoint[]

QuerySegments(ISegmentCollection, int, ref ISegment[])

Returns references to some of the input segments.

virtual void QuerySegments(ISegmentCollection pSegmentCollection, int Index, ref ISegment[] segments)

Parameters

pSegmentCollection ISegmentCollection
Index int
segments ISegment[]

QueryWKSPointZs(IPointCollection4, int, ref WKSPointZ[])

Copies vertices/points coordinates to the array of point structures.

virtual void QueryWKSPointZs(IPointCollection4 pPointCollection, int Index, ref WKSPointZ[] pointStructures)

Parameters

pPointCollection IPointCollection4
Index int
pointStructures WKSPointZ[]

QueryWKSPoints(IPointCollection4, int, ref WKSPoint[])

Copies vertices'/points' coordinates to the array of point structures.

virtual void QueryWKSPoints(IPointCollection4 pPointCollection, int Index, ref WKSPoint[] pointStructures)

Parameters

pPointCollection IPointCollection4
Index int
pointStructures WKSPoint[]

ReplacePoints(IPointCollection4, int, int, ref IPoint[])

Replaces vertices/points within a PointCollection.

virtual void ReplacePoints(IPointCollection4 pPointCollection, int Index, int goingAway, ref IPoint[] newPoints)

Parameters

pPointCollection IPointCollection4
Index int
goingAway int
newPoints IPoint[]

ReplaceSegments(ISegmentCollection, int, int, ref ISegment[])

Removes and inserts from segments.

virtual void ReplaceSegments(ISegmentCollection pSegmentCollection, int Index, int goingAway, ref ISegment[] newSegments)

Parameters

pSegmentCollection ISegmentCollection
Index int
goingAway int
newSegments ISegment[]

SetGeometries(IGeometryCollection, ref IGeometry[])

Replaces all geometries in the collection with the specified number of references to those in the input array.

virtual void SetGeometries(IGeometryCollection pGeometryCollection, ref IGeometry[] newGeometries)

Parameters

pGeometryCollection IGeometryCollection
newGeometries IGeometry[]

SetPoints(IPointCollection4, ref IPoint[])

Replaces all existing vertices of this Path, Ring, Polyline, or Polygon with copies of the input points; or all existing points of this Multipoint, Triangles, TriangleFan, or TriangleStrip with references to the input points.

virtual void SetPoints(IPointCollection4 pPointCollection, ref IPoint[] newPoints)

Parameters

pPointCollection IPointCollection4
newPoints IPoint[]

SetSegments(ISegmentCollection, ref ISegment[])

Replaces all segments with references to the input segments.

virtual void SetSegments(ISegmentCollection pSegmentCollection, ref ISegment[] newSegments)

Parameters

pSegmentCollection ISegmentCollection
newSegments ISegment[]

SetWKSPointZs(IPointCollection4, ref WKSPointZ[])

Replaces all vertices/points of this Path, Ring, Polyline, Polygon, Multipoint, Triangles, TriangleFan, TriangleStrip, or MultiPatch with new ones.

virtual void SetWKSPointZs(IPointCollection4 pPointCollection, ref WKSPointZ[] pointStructures)

Parameters

pPointCollection IPointCollection4
pointStructures WKSPointZ[]

SetWKSPoints(IPointCollection4, ref WKSPoint[])

Replaces all vertices of this Path, Ring, Polyline, or Polygon with new ones, or replaces all points of this Multipoint, Triangles, TriangleFan, or TriangleStrip with new ones.

virtual void SetWKSPoints(IPointCollection4 pPointCollection, ref WKSPoint[] pointStructures)

Parameters

pPointCollection IPointCollection4
pointStructures WKSPoint[]

SplitAtDistances(IPolycurve2, ref double[], bool, bool)

Introduces new vertices into this polyline at specified distances from the beginning of the polyline.

virtual IEnumSplitPoint SplitAtDistances(IPolycurve2 polyCurve, ref double[] distances, bool asRatios, bool createParts)

Parameters

polyCurve IPolycurve2
distances double[]
asRatios bool
createParts bool

Returns

IEnumSplitPoint

SplitDivideLength(ISegment, double, double, bool, out int, ref ISegment[])

Divide segment into smaller segments of the specified length.

virtual void SplitDivideLength(ISegment pSegment, double Offset, double Length, bool asRatio, out int numSplitSegments, ref ISegment[] splitSegments)

Parameters

pSegment ISegment
Offset double
Length double
asRatio bool
numSplitSegments int
splitSegments ISegment[]

UnPackNormal(double, IVector3D, out bool)

Decodes a normal from a double.

virtual void UnPackNormal(double packedNormal, IVector3D normalVector, out bool wasProductive)

Parameters

packedNormal double
normalVector IVector3D
wasProductive bool

UnPackTexture2D(double, out double, out double, out bool)

Decodes texture coordinates.

virtual void UnPackTexture2D(double packedTextureST, out double textureS, out double textureT, out bool wasProductive)

Parameters

packedTextureST double
textureS double
textureT double
wasProductive bool

UseAlternativeTopoOps

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

virtual bool UseAlternativeTopoOps { get; set; }

Returns

bool