This document is archived and information here might be outdated.  Recommended version.


IConstructCircularArc Interface (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (Geometry)  

IConstructCircularArc Interface

Provides access to members that construct a circular arc using other geometries and values. Note: the IConstructCircularArc interface has been superseded byIConstructCircularArc2. Please consider using the more recent version.

Product Availability

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

Description

IConstructCircularArc allows CircularArcs to be constructed given a wide variety of parameters.  The construction method varies depending on what parameters the user has available.  The input parameters used in the various constructions include the Center Point, the From Point, the To Point, a Thru Point, IsCounterClockwise Orientation, the Arc Distance, the Bearing Angle, the Central Angle, the Chord Distance, the Tangent Distance, the Radius, IsMinor Orientation, Fillet Segments, and a Tangent Segment.

The Central Angle used for construction must be positive (since the orientation is already specified).  The Arc Distance is the length of the CircularArc to be constructed.  The Bearing Angle is the Angle between the From Point and To Point of the CircularArc to be constructed.  The Chord Distance is the length of the chord between the From Point and To Point.  The Tangent Distance is the length of the line between an endpoint of the CircularArc to be constructed and the point of intersection between the embedded extension of the lines Tangent to the endpoints.  The Tangent Segment is the segment that determines an endpoint of the CircularArc to be constructed and the tangent at that endpoint.

Most construction methods use a single specified endpoint and a variety of parameters to calculate the other endpoint.  The calculated endpoint is rarely at the exact location of the theoretically calculated location based on small numerical inaccuracies in the computerized calculation process.  This is important to remember when attaching other segments to the constructed CircularArc.  ConstructThreePoints and the EndPoint construction methods always gives exact endpoints since they are both given as input.

Members

Description
Method ConstructArcDistance Constructs an arc from a center point, a starting point, and an arc length.
Method ConstructBearingAngleArc Constructs an arc with the given chord bearing, central angle and arc distance.
Method ConstructBearingAngleChord Constructs an arc with the given chord bearing, central angle and chord distance.
Method ConstructBearingAngleTangent Constructs an arc with the given chord bearing, central angle and tangent distance.
Method ConstructBearingArcTangent Constructs an arc with the given chord bearing, arc distance and tangent distance.
Method ConstructBearingChordArc Constructs an arc with the given chord bearing, chord distance and arc distance (negative for clockwise orientation).
Method ConstructBearingChordTangent Constructs an arc with the given chord bearing, chord distance and tangent distance.
Method ConstructBearingRadiusAngle Constructs an arc with the given chord bearing, radius and central angle.
Method ConstructBearingRadiusArc Constructs an arc with the given chord bearing, radius and arc distance.
Method ConstructBearingRadiusChord Constructs an arc with the given chord bearing, radius and chord distance.
Method ConstructBearingRadiusTangent Constructs an arc with the given chord bearing, radius and tangent distance.
Method ConstructChordDistance Constructs an arc from a center point, a starting point, and a chord length.
Method ConstructCircle Constructs a circle of a given radius and orientation.
Method ConstructEndPointsAngle Constructs an arc from the given endpoints and central angle.
Method ConstructEndPointsArc Constructs an arc from the given endpoints and arc distance.
Method ConstructEndPointsChordHeight Constructs an arc with specified endpoints and and chord height.
Method ConstructEndPointsRadius Constructs an arc from the given endpoints and radius.
Method ConstructEndPointsTangent Constructs an arc from the given endpoints and tangent distance.
Method ConstructFilletPoint Constructs an arc of given start point near first segment and tangent to two segments. hintPoint can be nil or can be a location near the desired fillet.
Method ConstructFilletRadius Constructs an arc of given radius and tangent to two segments. hintPoint can be nil or can be a location near the desired fillet.
Method ConstructTangentAndPoint Constructs an arc with one endpoint being p, tangent to s, and connected to s. If atFrom is true, the connection is at s's from point, otherwise at s's to point.
Method ConstructTangentAngleArc Constructs an arc with a common tangent to the input segment, a given central angle and an arc length.
Method ConstructTangentAngleChord Constructs an arc with a common tangent to the input segment, a given central angle and a chord length.
Method ConstructTangentAngleTangent Constructs an arc with a common tangent to the input segment, a given central angle and a tangent length.
Method ConstructTangentArcTangent Constructs an arc with a common tangent to the input segment, a given arc length and a tangent length.
Method ConstructTangentChordArc Constructs an arc with a common tangent to the input segment, a given chord length and an arc length.
Method ConstructTangentChordTangent Constructs an arc with a common tangent to input segment, a given chord length and a tangent length.
Method ConstructTangentDistance Constructs an arc from a center point, a starting point, and an tangent length.
Method ConstructTangentRadiusAngle Constructs an arc with a common tangent to the input segment, a given radius and a central angle.
Method ConstructTangentRadiusArc Constructs an arc having a common tangent to the input segment, a given radius and an arc length.
Method ConstructTangentRadiusChord Constructs an arc with a common tangent to the input segment, a given radius and a chord length.
Method ConstructTangentRadiusTangent Constructs an arc with a common tangent to the input segment, a given radius and a tangent length.
Method ConstructThreePoints Constructs an arc from three points. useExistingCenter can be set to true in order to help create a reasonable arc when from and to are identical.
Method QueryFilletRadiusRange Returns minimum and maximum radius for fillet to touch both input segments. hintPoint can be nil or can be a location near the desired fillet.

CoClasses that implement IConstructCircularArc

CoClasses and Classes Description
CircularArc A portion of a circle that connects two points optionally has measure, height and ID attributes at each endpoint.

Remarks

 

ConstructCircularArc CircularArc Example

ConstructCircularArc Example1

ConstructCircularArc Example2

See Also

ICircularArc Interface

.NET Samples

Curve conversion add-in (Code Files: CurveConversionDockWin)

.NET Related Topics

How to create a multipoint using the ConstructIntersectionEx method | How to use some basic properties and methods on ICircularArc