Interface IConstructMultipoint
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
Remarks

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"
);
}
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
Remarks
The number of points in the constructed multipoint is equal to the input numPoints plus the 2 endpoints.

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);
}
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
Remarks
If the final inner point is too close to the To point, that inner point is not included in the constructed multipoint.

//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);
}
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
segment1ISegmentextension1esriSegmentExtensionsegment2ISegmentextension2esriSegmentExtensionparams1objectparams2objectisTangentPointobject
Remarks

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);
}
}
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
segment1ISegmentextension1esriSegmentExtensionsegment2ISegmentextension2esriSegmentExtensionparams1doubleparams2doubletangentBitsint
Remarks

ConstructTangent(ICurve, IPoint)
Constructs all points of tangency to a curve from a point.
void ConstructTangent(ICurve inCurve, IPoint p)
Parameters
Remarks
Input must consist of a single segment and not polycurves.

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);
}
}
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