Interface IConstructMultipoint

Namespace
ESRI.ArcGIS.Geometry
Assembly
ESRI.Server.Geometry.dll

Provides access to members that construct multiple points using other geometries and values.

[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
[Guid("BE99E37A-14F8-11D1-8336-0000F8775BE9")]
public interface IConstructMultipoint

Methods

ConstructArcPoints(ICircularArc)

Constructs the four arc points (fromPoint, toPoint, center point, intersection point of the tangents at fromPoint and toPoint, in that order) for the specified circular arc.

void ConstructArcPoints(ICircularArc a)

Parameters

a ICircularArc

Remarks

 

ConstructMultipoint ConstructArcPoints Example

[C#]

        private void ConstrConstructArcPoints()
        {
            IPoint centerPoint = new PointClass();
            centerPoint.PutCoords(10, 0);
            IPoint fromPoint = new PointClass();
            fromPoint.PutCoords(0, 0);
            IPoint toPoint = new PointClass();
            toPoint.PutCoords(0, 20);
            IConstructCircularArc circularArcConstruction = new CircularArcClass();
            circularArcConstruction.ConstructThreePoints(fromPoint, centerPoint, toPoint, false);








            IConstructMultipoint constructMultipoint = new MultipointClass();
            constructMultipoint.ConstructArcPoints(circularArcConstruction as ICircularArc);
            IPointCollection pointCollection = constructMultipoint as IPointCollection;

            System.Windows.Forms.MessageBox.Show("From Point : " + pointCollection.get_Point(0).X + " , " + pointCollection.get_Point(0).Y + "\n" +
                                                 "To Point : " + pointCollection.get_Point(1).X + " , " + pointCollection.get_Point(1).Y + "\n" +
                                                 "Center Point : " + pointCollection.get_Point(2).X + " , " + pointCollection.get_Point(2).Y + "\n" +
                                                 "Intersection Point : " + pointCollection.get_Point(3).X + " , " + pointCollection.get_Point(3).Y + "\n"
                                                 );



        }

[Visual Basic .NET]

    Private Sub ConstructArcPoints()
        Dim pConstructCircularArc As ESRI.ArcGIS.Geometry.IConstructCircularArc
        Dim pCArc As ESRI.ArcGIS.Geometry.ICircularArc
        Dim pPoint1 As ESRI.ArcGIS.Geometry.IPoint
        Dim pPoint2 As ESRI.ArcGIS.Geometry.IPoint
        Dim pPoint3 As ESRI.ArcGIS.Geometry.IPoint
        Dim pTcoll As ESRI.ArcGIS.Geometry.IPointCollection
        Dim pConstructMultipoint As ESRI.ArcGIS.Geometry.IConstructMultipoint
        Dim pMultipoint As ESRI.ArcGIS.Geometry.IMultipoint
        pConstructMultipoint = New ESRI.ArcGIS.Geometry.Multipoint
        pConstructCircularArc = New ESRI.ArcGIS.Geometry.CircularArc
        pCArc = pConstructCircularArc
        pPoint1 = New ESRI.ArcGIS.Geometry.Point
        pPoint2 = New ESRI.ArcGIS.Geometry.Point
        pPoint3 = New ESRI.ArcGIS.Geometry.Point
        pPoint1.PutCoords(100, 100)
        pPoint2.PutCoords(300, 300)
        pPoint3.PutCoords(500, 150)
        pConstructCircularArc.ConstructThreePoints(pPoint1, pPoint2, pPoint3, False)
        pConstructMultipoint.ConstructArcPoints(pCArc)
        pMultipoint = pConstructMultipoint
        pTcoll = pMultipoint
        Debug.Print("*********************************************")
        Debug.Print(" Report the points")
        Debug.Print("*********************************************")
        Debug.Print("From Point : " & pTcoll.Point(0).X & " , " & pTcoll.Point(0).Y)
        Debug.Print("To Point : " & pTcoll.Point(1).X & " , " & pTcoll.Point(1).Y)
        Debug.Print("Center Point : " & pTcoll.Point(2).X & " , " & pTcoll.Point(2).Y)
        Debug.Print("Intersection Point : " & pTcoll.Point(3).X & " , " & pTcoll.Point(3).Y)
    End Sub





























ConstructDivideEqual(ICurve, int)

Constructs cPoints points evenly distributed along the input curve.

void ConstructDivideEqual(ICurve inCurve, int numInnerPoints)

Parameters

inCurve ICurve
numInnerPoints int

Remarks

The number of points in the constructed multipoint is equal to the input numPoints plus the 2 endpoints.

 

Multipoint Construct Divide Equal

[C#]

private void ConstructDivideEqual()
{
    IPoint centerPoint = new PointClass();
    centerPoint.PutCoords(10, 0);
    IPoint fromPoint = new PointClass();
    fromPoint.PutCoords(0, 0);
    IPoint toPoint = new PointClass();
    toPoint.PutCoords(0, 20);
    ICircularArc circularArcConstruction = new CircularArcClass();
    circularArcConstruction.PutCoords(centerPoint, fromPoint, toPoint, esriArcOrientation.esriArcClockwise);
    IConstructMultipoint constructMultipoint = new MultipointClass();
    constructMultipoint.ConstructDivideEqual(circularArcConstruction as ICurve, 10);
    IPointCollection pointCollection = constructMultipoint as IPointCollection;
    System.Windows.Forms.MessageBox.Show("Number of points is: " + pointCollection.PointCount);
}














[Visual Basic .NET]

    Sub ConstructDivideEqual_Example()
        Dim pCArc As ICircularArc, pConstructMultipoint As IConstructMultipoint
        Dim pCenter As IPoint, pFrom As IPoint, pTo As IPoint
        Dim ptc As IPointCollection
        pCArc = New CircularArc
        pCenter = New Point
        pCenter.PutCoords(10, 0)
        pFrom = New Point
        pFrom.PutCoords(0, 0)
        pTo = New Point
        pTo.PutCoords(0, 20)
        pCArc.PutCoords(pCenter, pFrom, pTo, esriArcOrientation.esriArcClockwise)
        pConstructMultipoint = New Multipoint
        pConstructMultipoint.ConstructDivideEqual(pCArc, 10)
        ptc = pConstructMultipoint
        Debug.Print("Number of points is: " & ptc.PointCount)
    End Sub















ConstructDivideLength(ICurve, double)

Places points along the input curve each seperate by the specified distance.

void ConstructDivideLength(ICurve inCurve, double separationDistance)

Parameters

inCurve ICurve
separationDistance double

Remarks

If the final inner point is too close to the To point, that inner point is not included in the constructed multipoint. 

 

Multipoint Construct Divide Length

[C#]

//This example demonstrates how to use ConstructDivideLentgth
private void ConstructDivideLength()
{
    IPoint centerPoint = new PointClass();
    centerPoint.PutCoords(10, 0);
    IPoint fromPoint = new PointClass();
    fromPoint.PutCoords(0, 0);
    IPoint toPoint = new PointClass();
    toPoint.PutCoords(0, 20);
    ICircularArc circularArcConstruction = new CircularArcClass();
    circularArcConstruction.PutCoords(centerPoint, fromPoint, toPoint, esriArcOrientation.esriArcClockwise);
    IConstructMultipoint constructMultipoint = new MultipointClass();
    constructMultipoint.ConstructDivideLength(circularArcConstruction as ICurve, 10);
    IPointCollection pointCollection = constructMultipoint as IPointCollection;
    System.Windows.Forms.MessageBox.Show("Number of points is: " + pointCollection.PointCount);
}














[Visual Basic .NET]

    Sub ConstructDivideEqual_ConstructDivideLength_Example()
        Dim pCArc As ICircularArc, pConstructMultipoint As IConstructMultipoint
        Dim pCenter As IPoint, pFrom As IPoint, pTo As IPoint
        Dim ptc As IPointCollection
        pCArc = New CircularArc
        pCenter = New Point
        pCenter.PutCoords(10, 0)
        pFrom = New Point
        pFrom.PutCoords(0, 0)
        pTo = New Point
        pTo.PutCoords(0, 20)
        pCArc.PutCoords(pCenter, pFrom, pTo, esriArcOrientation.esriArcClockwise)
        pConstructMultipoint = New Multipoint
        pConstructMultipoint.ConstructDivideLength(pCArc, pCArc.Length / 11)
        ptc = pConstructMultipoint
        Debug.Print("Number of points is: " & ptc.PointCount)
    End Sub















ConstructIntersection(ISegment, esriSegmentExtension, ISegment, esriSegmentExtension, out object, out object, out object)

Constructs the point(s) of intersection/tangency between two segments. Different ways of extending the segments in order to locate additional points can be specified.

void ConstructIntersection(ISegment segment1, esriSegmentExtension extension1, ISegment segment2, esriSegmentExtension extension2, out object params1, out object params2, out object isTangentPoint)

Parameters

segment1 ISegment
extension1 esriSegmentExtension
segment2 ISegment
extension2 esriSegmentExtension
params1 object
params2 object
isTangentPoint object

Remarks

 

IConstructMultipoint ConstructIntersection Example

[C#]
private void ConstructIntersection()
{
  IPoint[] points = new IPoint[4];
  for(int i = 0; i < 4; i++)
  {
      points[i] = new PointClass();
  }

points[0].PutCoords(150, 100); points[1].PutCoords(200, 600); points[2].PutCoords(400, 600); points[3].PutCoords(450, 100);

IBezierCurveGEN bezierCurve = new BezierCurveClass(); bezierCurve.PutCoords(ref points); IPoint centerPoint = new PointClass(); centerPoint.PutCoords(300, 300); IPoint fromPoint = new PointClass(); fromPoint.PutCoords(100, 100); IPoint toPoint = new PointClass(); toPoint.PutCoords(500, 100); IConstructCircularArc circularArcConstruction = new CircularArcClass(); circularArcConstruction.ConstructThreePoints(fromPoint, centerPoint, toPoint, false);

//params optional object param0; object param1; object isTangentPoint; IConstructMultipoint constructMultipoint = new MultipointClass(); constructMultipoint.ConstructIntersection(circularArcConstruction as ISegment, esriSegmentExtension.esriNoExtension, bezierCurve as ISegment, esriSegmentExtension.esriNoExtension, out param0, out param1, out isTangentPoint); IMultipoint multipoint = constructMultipoint as IMultipoint; IPointCollection pointCollection = multipoint as IPointCollection; for (int i = 0; i < pointCollection.PointCount; i++) { System.Windows.Forms.MessageBox.Show("Point : " + i + " X = " + pointCollection.get_Point(i).X + " Y = " + pointCollection.get_Point(i).Y); } }

[Visual Basic .NET]

    Private Sub ConstructIntersection()
        Dim pConstructCircularArc As ESRI.ArcGIS.Geometry.IConstructCircularArc
        Dim pCArc As ESRI.ArcGIS.Geometry.ICircularArc
        Dim pPoint1 As ESRI.ArcGIS.Geometry.IPoint
        Dim pPoint2 As ESRI.ArcGIS.Geometry.IPoint
        Dim pPoint3 As ESRI.ArcGIS.Geometry.IPoint
        Dim pTcoll As ESRI.ArcGIS.Geometry.IPointCollection
        Dim pConstructMultipoint As ESRI.ArcGIS.Geometry.IConstructMultipoint
        Dim pMultipoint As ESRI.ArcGIS.Geometry.IMultipoint
        Dim i As Long
        Dim pBezier As ESRI.ArcGIS.Geometry.IBezierCurve
        Dim pPtCon(0 To 3) As ESRI.ArcGIS.Geometry.IPoint
        For i = 0 To 3
            pPtCon(i) = New ESRI.ArcGIS.Geometry.Point
        Next
        pPtCon(0).PutCoords(150, 100)
        pPtCon(1).PutCoords(200, 600)
        pPtCon(2).PutCoords(400, 600)
        pPtCon(3).PutCoords(450, 100)
        pBezier = New ESRI.ArcGIS.Geometry.BezierCurve
        pBezier.PutCoords(4, pPtCon(0))
        pConstructMultipoint = New ESRI.ArcGIS.Geometry.Multipoint
        pConstructCircularArc = New ESRI.ArcGIS.Geometry.CircularArc
        pCArc = pConstructCircularArc
        pPoint1 = New ESRI.ArcGIS.Geometry.Point
        pPoint2 = New ESRI.ArcGIS.Geometry.Point
        pPoint3 = New ESRI.ArcGIS.Geometry.Point
        pPoint1.PutCoords(100, 100)
        pPoint2.PutCoords(300, 300)
        pPoint3.PutCoords(500, 100)
        pConstructCircularArc.ConstructThreePoints(pPoint1, pPoint2, pPoint3, False)
        pConstructMultipoint.ConstructIntersection(pCArc, ESRI.ArcGIS.Geometry.esriSegmentExtension.esriNoExtension, pBezier, ESRI.ArcGIS.Geometry.esriSegmentExtension.esriNoExtension)
        pMultipoint = pConstructMultipoint
        pTcoll = pMultipoint
        Debug.Print("*********************************************")
        Debug.Print(" Report the intersection points")
        Debug.Print("*********************************************")
        For i = 0 To pTcoll.PointCount - 1
            Debug.Print("Point : " & pTcoll.Point(i).X & " , " & pTcoll.Point(i).Y)
        Next
    End Sub








































ConstructIntersectionEx(ISegment, esriSegmentExtension, ISegment, esriSegmentExtension, out double, out double, out int)

Constructs the point(s) of intersection/tangency between two segments. Different ways of extending the segments in order to locate additional points can be specified.

void ConstructIntersectionEx(ISegment segment1, esriSegmentExtension extension1, ISegment segment2, esriSegmentExtension extension2, out double params1, out double params2, out int tangentBits)

Parameters

segment1 ISegment
extension1 esriSegmentExtension
segment2 ISegment
extension2 esriSegmentExtension
params1 double
params2 double
tangentBits int

Remarks

 

IConstructMultipoint ConstructIntersectionEx Example

ConstructTangent(ICurve, IPoint)

Constructs all points of tangency to a curve from a point.

void ConstructTangent(ICurve inCurve, IPoint p)

Parameters

inCurve ICurve
p IPoint

Remarks

Input must consist of a single segment and not polycurves.

 

Multipoint Construct Tangent

[C#]

        private void ConstructTangent()
        {
            IPoint[] points = new IPoint[4];
            for (int i = 0; i < 4; i++)
            {
                points[i] = new PointClass();
            }





            points[0].PutCoords(150, 100);
            points[1].PutCoords(200, 600);
            points[2].PutCoords(400, 600);
            points[3].PutCoords(450, 100);


            IBezierCurveGEN bezierCurve = new BezierCurveClass();
            bezierCurve.PutCoords(ref points);
            IConstructMultipoint constructMultipoint = new MultipointClass();
            constructMultipoint.ConstructTangent(bezierCurve as ICurve, points[1]);
            IMultipoint multipoint = constructMultipoint as IMultipoint;
            IPointCollection pointCollection = multipoint as IPointCollection;




            //Report the points

            for (int i = 0; i < pointCollection.PointCount; i++)
            {
                System.Windows.Forms.MessageBox.Show("Point : " + pointCollection.get_Point(i).X + " , " + pointCollection.get_Point(i).Y);
            }
        }




[Visual Basic .NET]

    Private Sub ConstructTangent()
        Dim pTcoll As ESRI.ArcGIS.Geometry.IPointCollection
        Dim pConstructMultipoint As ESRI.ArcGIS.Geometry.IConstructMultipoint
        Dim pMultipoint As ESRI.ArcGIS.Geometry.IMultipoint
        Dim i As Long
        Dim pBezier As ESRI.ArcGIS.Geometry.IBezierCurve
        Dim pPtCon(0 To 3) As ESRI.ArcGIS.Geometry.IPoint
        For i = 0 To 3
            pPtCon(i) = New ESRI.ArcGIS.Geometry.Point
        Next
        pPtCon(0).PutCoords(150, 100)
        pPtCon(1).PutCoords(200, 600)
        pPtCon(2).PutCoords(400, 600)
        pPtCon(3).PutCoords(450, 100)
        pBezier = New ESRI.ArcGIS.Geometry.BezierCurve
        pBezier.PutCoords(4, pPtCon(0))
        pConstructMultipoint = New ESRI.ArcGIS.Geometry.Multipoint
        pConstructMultipoint.ConstructTangent(pBezier, pPtCon(0))
        pMultipoint = pConstructMultipoint
        pTcoll = pMultipoint
        Debug.Print("*********************************************")
        Debug.Print(" Report the points")
        Debug.Print("*********************************************")
        For i = 0 To pTcoll.PointCount - 1
            Debug.Print("Point : " & pTcoll.Point(i).X & " , " & pTcoll.Point(i).Y)
        Next
    End Sub