com.esri.arcgis.geometry
Class CircularArc

java.lang.Object
  extended by com.esri.arcgis.geometry.CircularArc
All Implemented Interfaces:
ICircularArc, IConstructCircularArc, IConstructCircularArc2, ICurve, ICurve2, ICurve3, IGeometry, IProximityOperator, ISegment, ISegmentID, ISegmentM, ISegmentZ, ITransform2D, com.esri.arcgis.interop.RemoteObjRef, IClone, ISupportErrorInfo, Serializable

public class CircularArc
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, ICircularArc, IGeometry, ITransform2D, ICurve, ICurve2, ICurve3, ISegment, IConstructCircularArc, IConstructCircularArc2, IProximityOperator, ISupportErrorInfo, IClone, ISegmentM, ISegmentZ, ISegmentID

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

Description

A CircularArc is an object that describes a portion of a circle or a complete circle. In geometric terms, a CircularArc is a special case of an EllipticArc, where the major and minor axes are equal. Consequently, every point on the arc is equidistant from the CenterPoint, this distance being the Radius.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

See Also:
Serialized Form

Constructor Summary
CircularArc()
          Constructs a CircularArc using ArcGIS Engine.
CircularArc(Object obj)
          Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
CircularArc theCircularArc = (CircularArc) obj;
 
Method Summary
 void assign(IClone src)
          Assigns the properties of src to the receiver.
 void complement()
          Changes this arc into its complement; 'from' and 'to' points are unchanged.
 void constructArcDistance(IPoint center, IPoint from, boolean isCCW, double arcDistance)
          Constructs an arc from a center point, a starting point, and an arc length.
 void constructBearingAngleArc(IPoint from, double inAngle, boolean isCCW, double centralAngle, double arcDistance)
          Constructs an arc with the given chord bearing, central angle and arc distance.
 void constructBearingAngleChord(IPoint from, double inAngle, boolean isCCW, double centralAngle, double chordDistance)
          Constructs an arc with the given chord bearing, central angle and chord distance.
 void constructBearingAngleTangent(IPoint from, double inAngle, boolean isCCW, double centralAngle, double tangentDistance)
          Constructs an arc with the given chord bearing, central angle and tangent distance.
 void constructBearingArcTangent(IPoint from, double inAngle, boolean isCCW, double arcDistance, double tangentDistance)
          Constructs an arc with the given chord bearing, arc distance and tangent distance.
 void constructBearingChordArc(IPoint from, double inAngle, boolean isCCW, double chordDistance, double arcDistance)
          Constructs an arc with the given chord bearing, chord distance and arc distance (negative for clockwise orientation).
 void constructBearingChordTangent(IPoint from, double inAngle, boolean isCCW, double chordDistance, double tangentDistance)
          Constructs an arc with the given chord bearing, chord distance and tangent distance.
 void constructBearingRadiusAngle(IPoint startPoint, double inAngle, boolean isCCW, double inRadius, double centralAngle)
          Constructs an arc with the given chord bearing, radius and central angle.
 void constructBearingRadiusArc(IPoint from, double inAngle, boolean isCCW, double inRadius, double arcDistance)
          Constructs an arc with the given chord bearing, radius and arc distance.
 void constructBearingRadiusChord(IPoint from, double inAngle, boolean isCCW, double inRadius, double chordDistance, boolean isMinor)
          Constructs an arc with the given chord bearing, radius and chord distance.
 void constructBearingRadiusTangent(IPoint from, double inAngle, boolean isCCW, double inRadius, double tangentDistance)
          Constructs an arc with the given chord bearing, radius and tangent distance.
 void constructChordDistance(IPoint center, IPoint from, boolean isCCW, double chordDistance)
          Constructs an arc from a center point, a starting point, and a chord length.
 void constructChordDistanceEx(IPoint center, IPoint from, boolean isCCW, double chordDistance, boolean isMinor)
          Constructs an arc from a center point, a from point, and a chord length.
 void constructCircle(IPoint centerPoint, double radius, boolean isCCW)
          Constructs a circle of a given radius and orientation.
 void constructEndPointsAngle(IPoint from, IPoint to, boolean isCCW, double centralAngle)
          Constructs an arc from the given endpoints and central angle.
 void constructEndPointsArc(IPoint from, IPoint to, boolean isCCW, double arcDistance)
          Constructs an arc from the given endpoints and arc distance.
 void constructEndPointsChordHeight(IPoint from, IPoint to, boolean isCCW, double chordHeight)
          Constructs an arc with specified endpoints and and chord height.
 void constructEndPointsRadius(IPoint from, IPoint to, boolean isCCW, double inRadius, boolean isMinor)
          Constructs an arc from the given endpoints and radius.
 void constructEndPointsTangent(IPoint from, IPoint to, boolean isCCW, double tangentDistance)
          Constructs an arc from the given endpoints and tangent distance.
 void constructFilletPoint(ISegment s1, ISegment s2, IPoint from, IPoint hintPoint)
          Constructs an arc of given start point near first segment and tangent to two segments.
 void constructFilletRadius(ISegment s1, ISegment s2, double inRadius, IPoint hintPoint)
          Constructs an arc of given radius and tangent to two segments.
 void constructTangentAndPoint(ISegment s, boolean atFrom, IPoint p)
          Constructs an arc with one endpoint being p, tangent to s, and connected to s.
 void constructTangentAngleArc(ISegment segment, boolean atStart, boolean isCCW, double centralAngle, double arcDistance)
          Constructs an arc with a common tangent to the input segment, a given central angle and an arc length.
 void constructTangentAngleChord(ISegment segment, boolean atStart, boolean isCCW, double centralAngle, double chordDistance)
          Constructs an arc with a common tangent to the input segment, a given central angle and a chord length.
 void constructTangentAngleTangent(ISegment segment, boolean atStart, boolean isCCW, double centralAngle, double tangentDistance)
          Constructs an arc with a common tangent to the input segment, a given central angle and a tangent length.
 void constructTangentArcTangent(ISegment segment, boolean atStart, boolean isCCW, double arcDistance, double tangentDistance)
          Constructs an arc with a common tangent to the input segment, a given arc length and a tangent length.
 void constructTangentChordArc(ISegment segment, boolean atStart, boolean isCCW, double chordDistance, double arcDistance)
          Constructs an arc with a common tangent to the input segment, a given chord length and an arc length.
 void constructTangentChordTangent(ISegment segment, boolean atStart, boolean isCCW, double chordDistance, double tangentDistance)
          Constructs an arc with a common tangent to input segment, a given chord length and a tangent length.
 void constructTangentDistance(IPoint center, IPoint from, boolean isCCW, double tangentDistance)
          Constructs an arc from a center point, a starting point, and an tangent length.
 void constructTangentRadiusAngle(ISegment segment, boolean atStart, boolean isCCW, double inRadius, double centralAngle)
          Constructs an arc with a common tangent to the input segment, a given radius and a central angle.
 void constructTangentRadiusArc(ISegment segment, boolean atStart, boolean isCCW, double inRadius, double arcDistance)
          Constructs an arc having a common tangent to the input segment, a given radius and an arc length.
 void constructTangentRadiusChord(ISegment segment, boolean atStart, boolean isCCW, double inRadius, double chordDistance)
          Constructs an arc with a common tangent to the input segment, a given radius and a chord length.
 void constructTangentRadiusChordEx(ISegment segment, boolean atStart, boolean isCCW, double inRadius, double chordDistance, boolean isMinor)
          Constructs an arc with a common tangent to the input segment, a given radius and a chord length.
 void constructTangentRadiusTangent(ISegment segment, boolean atStart, boolean isCCW, double inRadius, double tangentDistance)
          Constructs an arc with a common tangent to the input segment, a given radius and a tangent length.
 void constructThreePoints(IPoint from, IPoint middle, IPoint to, boolean useExistingCenter)
          Constructs an arc from three points.
 void densify(int cInSlots, double maxDeviation, int[] pcOutSegments, ILine[] segments)
          Deprecated. This method uses C style arrays which are not supported in the ArcGIS API for Java. It is replaced by GeometryEnvironment.densify(com.esri.arcgis.geometry.ISegment, double, int[], com.esri.arcgis.geometry.ILine[][]).
 boolean equals(Object o)
          Compare this object with another
 IClone esri_clone()
          Clones the receiver and assigns the result to *clone.
 void geographicShift(double splitLongitude)
          Shift longitudes to the right of splitLongitude.
 void geoNormalize()
          Shifts longitudes, if need be, into a continuous range of 360 degrees.
 void geoNormalizeFromLongitude(double longitude)
          Normalizes longitudes into a continuous range containing the longitude.
 IPoint getCenterPoint()
          The center point.
 double getCentralAngle()
          The included (or central) angle.
 double getChordHeight()
          The chord height (assigning preserves endpoints, and orientation unless chord height is < 0).
static String getClsid()
          getClsid.
 int getDimension()
          The topological dimension of this geometry.
 IEnvelope getEnvelope()
          Creates a copy of this geometry's envelope and returns it.
 double getFromAngle()
          The angle, measured from a horizontal line through this circular arc's center point, that defines where this arc starts.
 IPoint getFromPoint()
          The 'from' point of the curve.
 int getGeometryType()
          The type of this geometry.
 void getIDs(int[] fromID, int[] toID)
          Get the IDs on the segment's endpoints.
 double getLength()
          The length of the curve.
 void getMs(double[] fromM, double[] toM)
          Get the Ms on the segment's endpoints.
 double getRadius()
          The radius.
 ISpatialReference getSpatialReference()
          The spatial reference associated with this geometry.
 void getSubcurve(double fromDistance, double toDistance, boolean asRatio, ICurve[] outSubcurve)
          Extracts a portion of this curve into a new curve.
 double getToAngle()
          The angle, measured from a horizontal line through this circular arc's center point, that defines where this arc ends.
 IPoint getToPoint()
          The 'to' point of the curve.
 void getZs(double[] fromZ, double[] toZ)
          Get the Zs on the segment's endpoints.
 int hashCode()
          the hashcode for this object
 void interfaceSupportsErrorInfo(GUID riid)
          interfaceSupportsErrorInfo
 boolean isClosed()
          Indicates if 'from' and 'to' points (of each part) are identical.
 boolean isCounterClockwise()
          Indicates if this circular is oriented counter-clockwise from its 'from' point to its 'to' point.
 boolean isEmpty()
          Indicates whether this geometry contains any points.
 boolean isEqual(IClone other)
          Indicates if the receiver and other have the same properties.
 boolean isIdentical(IClone other)
          Indicates if the receiver and other are the same object.
 boolean isLine()
          Indicates if the arc has degenerated to a line (radius is infinite).
 boolean isMinor()
          Indicates whether this circular arc is a minor arc or a major arc.
 boolean isPoint()
          Indicates if the arc has degenerated to a point (radius is 0).
 void move(double dx, double dy)
          Moves dx units horizontally and dy units vertically.
 void moveVector(ILine v)
          Moves a direction and distance v.
 void project(ISpatialReference newReferenceSystem)
          Projects this geometry into a new spatial reference.
 void putCoords(IPoint center, IPoint from, IPoint to, int arcOrientation)
          Defines this arc by a center point, 'from' and 'to' points, and orientation.
 void putCoordsByAngle(IPoint cp, double fromAngle, double centralAngle, double arcRadius)
          Defines this circular arc by a center point, 'from' angle, signed central angle, and radius.
 void putCoordsEx(IPoint from, IPoint to)
          Sets this segment's endpoints to 'from' and 'to'.
 void putRadiusByPoint(IPoint radialPoint)
          Defines the radius of this circular arc to be the distance from the arc's center point to the input point; other properties remain unchanged.
 void queryCenterPoint(IPoint center)
          Copies the center point of this circular arc to the input point.
 void queryCoords(IPoint center, IPoint from, IPoint to, boolean[] isCCW, boolean[] isMinor)
          Copies the center, 'from' and 'to' points, orientation and major/minor property into the input parameters.
 void queryCoordsByAngle(IPoint center, double[] fromAngle, double[] centerAngle, double[] arcRadius)
          Returns the center point, 'from' angle, signed central angle, and radius.
 void queryCurvature(double distanceAlongCurve, boolean asRatio, double[] curvature, ILine unitVector)
          Finds curvature and unit vector starting at point on segment and directed to embedded circle center.
 void queryEnvelope(IEnvelope outEnvelope)
          Copies this geometry's envelope properties into the specified envelope.
 void queryFilletRadiusRange(ISegment s1, ISegment s2, IPoint hintPoint, double[] minRadius, double[] maxRadius)
          Returns minimum and maximum radius for fillet to touch both input segments.
 void queryFromPoint(IPoint from)
          Copies this curve's 'from' point to the input point.
 void queryNearestPoint(IPoint p, int extension, IPoint nearest)
          Copies into 'nearest' a point on this geometry nearest to the input point.
 void queryNormal(int extension, double distanceAlongCurve, boolean asRatio, double length, ILine normal)
          Constructs a line normal to a curve from a point at a specified distance along the curve.
 void queryPoint(int extension, double distanceAlongCurve, boolean asRatio, IPoint outPoint)
          Copies to outPoint the properties of a point on the curve at a specified distance from the beginning of the curve.
 void queryPointAndDistance(int extension, IPoint inPoint, boolean asRatio, IPoint outPoint, double[] distanceAlongCurve, double[] distanceFromCurve, boolean[] bRightSide)
          Finds the point on the curve closest to inPoint, then copies that point to outPoint; optionally calculates related items.
 void queryPointsAndDistances(int extension, double searchRadius, IPoint inPoint, boolean asRatio, double[] distanceFromCurve, IEnumPointAndDistance[] pointsAndDistances)
          Given an input point, calculates the minimum distance to the geometry and provides an enumerator over all closest points on the geometry, along with additional information.
 void queryTangent(int extension, double distanceAlongCurve, boolean asRatio, double length, ILine tangent)
          Constructs a line tangent to a curve from a point at a specified distance along the curve.
 void queryToPoint(IPoint to)
          Copies the curve's 'to' point into the input point.
 double returnDistance(IGeometry other)
          Returns the minimum distance between two geometries.
 IPoint returnNearestPoint(IPoint p, int extension)
          Creates and returns a point on this geometry nearest to the input point.
 int returnTurnDirection(ISegment otherSegment)
          Finds turn direction between two connected segments.
 void reverseOrientation()
          Reverses the parameterization of the curve ('from' point becomes 'to' point, first segment becomes last segment, etc).
 void rotate(IPoint origin, double rotationAngle)
          Rotates about the specified origin point.
 void scale(IPoint origin, double sx, double sy)
          Scales about the specified origin using seperate horizonal and vertical scales.
 void setCentralAngle(double outCentalAngle)
          The included (or central) angle.
 void setChordHeight(double chordHeight)
          The chord height (assigning preserves endpoints, and orientation unless chord height is < 0).
 void setEmpty()
          Removes all points from this geometry.
 void setFromAngle(double outFromAngle)
          The angle, measured from a horizontal line through this circular arc's center point, that defines where this arc starts.
 void setFromPoint(IPoint from)
          The 'from' point of the curve.
 void setIDs(int fromID, int toID)
          Set the IDs on the segment's endpoints.
 void setIsCounterClockwise(boolean isCCW)
          Indicates if this circular is oriented counter-clockwise from its 'from' point to its 'to' point.
 void setIsMinor(boolean isMinor)
          Indicates whether this circular arc is a minor arc or a major arc.
 void setMs(double fromM, double toM)
          Set the Ms on the segment's endpoints.
 void setRadius(double outRadius)
          The radius.
 void setSpatialReferenceByRef(ISpatialReference spatialRef)
          The spatial reference associated with this geometry.
 void setToAngle(double outToAngle)
          The angle, measured from a horizontal line through this circular arc's center point, that defines where this arc ends.
 void setToPoint(IPoint to)
          The 'to' point of the curve.
 void setZs(double fromZ, double toZ)
          Set the Zs on the segment's endpoints.
 void snapToSpatialReference()
          Moves points of this geometry so that they can be represented in the precision of the geometry's associated spatial reference system.
 void splitAtDistance(double distances, boolean asRatio, ISegment[] fromSegment, ISegment[] toSegment)
          Split segment at specified distance.
 void splitDivideLength(double offset, double length, boolean asRatio, int[] numSplitSegments, ISegment splitSegments)
          Deprecated. This method uses C style arrays which are not supported in the ArcGIS API for Java. It is replaced by GeometryEnvironment.splitDivideLength(com.esri.arcgis.geometry.ISegment, double, double, boolean, int[], com.esri.arcgis.geometry.ISegment[][]).
 void transform(int direction, ITransformation transformation)
          Applies an arbitrary transformation.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef
getJintegraDispatch, release
 

Constructor Detail

CircularArc

public CircularArc()
            throws IOException,
                   UnknownHostException
Constructs a CircularArc using ArcGIS Engine.

Throws:
IOException - if there are interop problems
UnknownHostException - if there are interop problems

CircularArc

public CircularArc(Object obj)
            throws IOException
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
CircularArc theCircularArc = (CircularArc) obj;

Construct a CircularArc using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to CircularArc.

Parameters:
obj - an object returned from ArcGIS Engine or Server
Throws:
IOException - if there are interop problems
Method Detail

getClsid

public static String getClsid()
getClsid.


equals

public boolean equals(Object o)
Compare this object with another

Overrides:
equals in class Object

hashCode

public int hashCode()
the hashcode for this object

Overrides:
hashCode in class Object

queryCoords

public void queryCoords(IPoint center,
                        IPoint from,
                        IPoint to,
                        boolean[] isCCW,
                        boolean[] isMinor)
                 throws IOException,
                        AutomationException
Copies the center, 'from' and 'to' points, orientation and major/minor property into the input parameters.

Description

QueryCoords returns the Center Point, the From Point, the To Point, the value of IsCounterClockwise, and the value of IsMinor for the Circular Arc.

Remarks

These are the necessary inputs for PutCoords, except in special cases (half circle, full circle, and Central Angle = 0) where the ArcOrientation must know which of these cases exists to ensure that the desired Circular Arc is unambiguous.

-isCCW stands for "is counter clockwise"

ICircularArc QueryCoords Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
queryCoords in interface ICircularArc
Parameters:
center - A reference to a com.esri.arcgis.geometry.IPoint (in)
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
to - A reference to a com.esri.arcgis.geometry.IPoint (in)
isCCW - The isCCW (in/out: use single element array)
isMinor - The isMinor (in/out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
ICircularArc.putCoords(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, int)

putCoords

public void putCoords(IPoint center,
                      IPoint from,
                      IPoint to,
                      int arcOrientation)
               throws IOException,
                      AutomationException
Defines this arc by a center point, 'from' and 'to' points, and orientation. If the from and to points do not lie on the same circle, the arc's center point will be adjusted.

Description

Use to create a Circular Arc by specifying the Center Point, From Point, To Point, and ArcOrientation. Care must be taken to ensure that the ArcOrientation is not ambiguous (For half-circles, ArcOrientation must be either Clockwise or CounterClockwise, and when the From Point and To Point are the same, ArcOrientation must be either Minor or Major.).

Remarks

If the FromPoint, ToPoint and CenterPoint specified do not create a circle, the created arc will have its CenterPoint adjusted until the FromPoint and ToPoint can be accomodated on the same circle. Therefore the resultant arcs CenterPoint may not be exactly the same as the input CenterPoint.

ICircularArc PutCoords Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
putCoords in interface ICircularArc
Parameters:
center - A reference to a com.esri.arcgis.geometry.IPoint (in)
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
to - A reference to a com.esri.arcgis.geometry.IPoint (in)
arcOrientation - A com.esri.arcgis.geometry.esriArcOrientation constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
ICircularArc.queryCoords(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean[], boolean[]), ICircularArc.putCoordsByAngle(com.esri.arcgis.geometry.IPoint, double, double, double)

queryCoordsByAngle

public void queryCoordsByAngle(IPoint center,
                               double[] fromAngle,
                               double[] centerAngle,
                               double[] arcRadius)
                        throws IOException,
                               AutomationException
Returns the center point, 'from' angle, signed central angle, and radius.

Description

Returns the Center Point, From Angle, Central Angle, and Radius for the Circular Arc. These are the same parameters used by PutCoordsByAngle to create the Circular Arc.

Remarks

ICircularArc QueryCoordsByAngle Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
queryCoordsByAngle in interface ICircularArc
Parameters:
center - A reference to a com.esri.arcgis.geometry.IPoint (in)
fromAngle - The fromAngle (in/out: use single element array)
centerAngle - The centerAngle (in/out: use single element array)
arcRadius - The arcRadius (in/out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
ICircularArc.putCoordsByAngle(com.esri.arcgis.geometry.IPoint, double, double, double)

putCoordsByAngle

public void putCoordsByAngle(IPoint cp,
                             double fromAngle,
                             double centralAngle,
                             double arcRadius)
                      throws IOException,
                             AutomationException
Defines this circular arc by a center point, 'from' angle, signed central angle, and radius.

Description

PutCoordsByAngle creates a Circular Arc given the Center Point, the From Angle, the Central Angle, and the Radius.

Remarks

PutCoordsByAngle is one of the easiest ways to create a desired Circular Arc. However, due to numeric accuracy limitations of computers and trigonometric functions, the From and To Points may be very slightly offset from the expected coordinates. This is important to keep in mind when attempting to connect the endpoints to other segments.

ICircularArc PutCoordsByAngle Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
putCoordsByAngle in interface ICircularArc
Parameters:
cp - A reference to a com.esri.arcgis.geometry.IPoint (in)
fromAngle - The fromAngle (in)
centralAngle - The centralAngle (in)
arcRadius - The arcRadius (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
ICircularArc.queryCoordsByAngle(com.esri.arcgis.geometry.IPoint, double[], double[], double[])

putRadiusByPoint

public void putRadiusByPoint(IPoint radialPoint)
                      throws IOException,
                             AutomationException
Defines the radius of this circular arc to be the distance from the arc's center point to the input point; other properties remain unchanged.

Description

PutRadiusByPoint sets the Radius of the Circular Arc to be the distance between the Center Point and the input Point. This has the same effect as setting the Radius using the Radius property of the Circular Arc.

Remarks

CircularArc PutRadiusByPoint Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
putRadiusByPoint in interface ICircularArc
Parameters:
radialPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getCenterPoint

public IPoint getCenterPoint()
                      throws IOException,
                             AutomationException
The center point.

Description

Returns the Center Point of the CircularArc. The Center Point is the Point equidistant from all other points on the CircularArc, and it is the point from which the Radius is measured.

Remarks

CircularArc CenterPoint Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getCenterPoint in interface ICircularArc
Returns:
A reference to a com.esri.arcgis.geometry.IPoint
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

queryCenterPoint

public void queryCenterPoint(IPoint center)
                      throws IOException,
                             AutomationException
Copies the center point of this circular arc to the input point.

Description

Returns the Center Point of the CircularArc. The Center Point is the Point equidistant from all other points on the CircularArc, and it is the point from which the Radius is measured.

Remarks

Note: The output geometry must be co-created prior to the query. The output geometry is not co-created by the method; it is populated. This can be used in performance critical situations. For example, creating the geometry only once outside a loop and use the query method could improve performance.

CircularArc QueryCenterPoint Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
queryCenterPoint in interface ICircularArc
Parameters:
center - A reference to a com.esri.arcgis.geometry.IPoint (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getRadius

public double getRadius()
                 throws IOException,
                        AutomationException
The radius.

Description

The radius is the distance from the Center of the circle to the arc. This property can be used to query the current radius of the circular arc or assign a new radius which changes the location of the From and To Points of the Circular Arc, but maintains the From Angle, Central Angle, and Orientation.

Remarks

CircularArc Radius Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getRadius in interface ICircularArc
Returns:
The outRadius
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setRadius

public void setRadius(double outRadius)
               throws IOException,
                      AutomationException
The radius.

Description

The radius is the distance from the Center of the circle to the arc. This property can be used to query the current radius of the circular arc or assign a new radius which changes the location of the From and To Points of the Circular Arc, but maintains the From Angle, Central Angle, and Orientation.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setRadius in interface ICircularArc
Parameters:
outRadius - The outRadius (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getFromAngle

public double getFromAngle()
                    throws IOException,
                           AutomationException
The angle, measured from a horizontal line through this circular arc's center point, that defines where this arc starts.

Description

The FromAngle is the angle from which the CircularArc starts. The FromAngle is measured in radians (there are 2*pi radians in a full circle. 0 Radians is the horizontal line parallel to the unrotated X-Axis extending to the right of the CenterPoint.). The FromAngle is the angle of the line drawn between the CenterPoint and the FromPoint.

Remarks

CircularArc FromAngle Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getFromAngle in interface ICircularArc
Returns:
The outFromAngle
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setFromAngle

public void setFromAngle(double outFromAngle)
                  throws IOException,
                         AutomationException
The angle, measured from a horizontal line through this circular arc's center point, that defines where this arc starts.

Description

The FromAngle is the angle from which the CircularArc starts. The FromAngle is measured in radians (there are 2*pi radians in a full circle. 0 Radians is the horizontal line parallel to the unrotated X-Axis extending to the right of the CenterPoint.). The FromAngle is the angle of the line drawn between the CenterPoint and the FromPoint.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setFromAngle in interface ICircularArc
Parameters:
outFromAngle - The outFromAngle (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getToAngle

public double getToAngle()
                  throws IOException,
                         AutomationException
The angle, measured from a horizontal line through this circular arc's center point, that defines where this arc ends.

Description

The ToAngle is the angle at which the CircularArc ends. The ToAngle is measured in radians (there are 2*pi radians in a full circle. 0 Radians is the horizontal line parallel to the unrotated X-Axis extending to the right of the CenterPoint.). The ToAngle is the angle of the line drawn between the CenterPoint and the ToPoint.

Remarks

CircularArc ToAngle Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getToAngle in interface ICircularArc
Returns:
The outToAngle
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setToAngle

public void setToAngle(double outToAngle)
                throws IOException,
                       AutomationException
The angle, measured from a horizontal line through this circular arc's center point, that defines where this arc ends.

Description

The ToAngle is the angle at which the CircularArc ends. The ToAngle is measured in radians (there are 2*pi radians in a full circle. 0 Radians is the horizontal line parallel to the unrotated X-Axis extending to the right of the CenterPoint.). The ToAngle is the angle of the line drawn between the CenterPoint and the ToPoint.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setToAngle in interface ICircularArc
Parameters:
outToAngle - The outToAngle (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getCentralAngle

public double getCentralAngle()
                       throws IOException,
                              AutomationException
The included (or central) angle.

Description

The CentralAngle describes the span of the CircularArc. The CentralAngle is the angular measure between the FromAngle and the ToAngle. The CentralAngle is measured in Radians and is always between -2*Pi and 2*Pi. If the Central Angle > 0, then the Circular Arc is oriented CounterClockwise. If the Central Angle < 0, then the Circular Arc is oriented Clockwise.

Remarks

CircularArc CentralAngle Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getCentralAngle in interface ICircularArc
Returns:
The outCentalAngle
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setCentralAngle

public void setCentralAngle(double outCentalAngle)
                     throws IOException,
                            AutomationException
The included (or central) angle.

Description

The CentralAngle describes the span of the CircularArc. The CentralAngle is the angular measure between the FromAngle and the ToAngle. The CentralAngle is measured in Radians and is always between -2*Pi and 2*Pi. If the Central Angle > 0, then the Circular Arc is oriented CounterClockwise. If the Central Angle < 0, then the Circular Arc is oriented Clockwise.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setCentralAngle in interface ICircularArc
Parameters:
outCentalAngle - The outCentalAngle (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getChordHeight

public double getChordHeight()
                      throws IOException,
                             AutomationException
The chord height (assigning preserves endpoints, and orientation unless chord height is < 0).

Description

The Chord Height is the positive perpendicular distance measured from the center of the chord to Circular Arc. The chord is the Line defined by the From and To Points of the Circular Arc. Setting the Chord Height redefines the Circular Arc, but maintains the existing From and To Points.

Remarks

CircularArc ChordHeight Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getChordHeight in interface ICircularArc
Returns:
The chordHeight
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setChordHeight

public void setChordHeight(double chordHeight)
                    throws IOException,
                           AutomationException
The chord height (assigning preserves endpoints, and orientation unless chord height is < 0).

Description

The Chord Height is the positive perpendicular distance measured from the center of the chord to Circular Arc. The chord is the Line defined by the From and To Points of the Circular Arc. Setting the Chord Height redefines the Circular Arc, but maintains the existing From and To Points.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setChordHeight in interface ICircularArc
Parameters:
chordHeight - The chordHeight (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isLine

public boolean isLine()
               throws IOException,
                      AutomationException
Indicates if the arc has degenerated to a line (radius is infinite).

Description

IsLine returns TRUE when the Radius of the CircularArc is Infinity.

Remarks

A CircularArc that returns TRUE can be constructed using ConstructThreePoints and three colinear points.

CircularArc IsLine Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
isLine in interface ICircularArc
Returns:
The isLine
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isPoint

public boolean isPoint()
                throws IOException,
                       AutomationException
Indicates if the arc has degenerated to a point (radius is 0).

Description

IsPoint returns TRUE when the Radius equals 0.

Remarks

IsPoint returns FALSE when the Radius > 0, even if the CentralAngle equals 0.

CircularArc IsPoint Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
isPoint in interface ICircularArc
Returns:
The isPoint
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isCounterClockwise

public boolean isCounterClockwise()
                           throws IOException,
                                  AutomationException
Indicates if this circular is oriented counter-clockwise from its 'from' point to its 'to' point.

Description

IsCounterClockwise returns TRUE if the CentralAngle is greater than 0. If the IsCounterClockwise values differ, setting IsCounterClockwise changes the CircularArc to its Complement.

Remarks

IsCCW Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
isCounterClockwise in interface ICircularArc
Returns:
The isCCW
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setIsCounterClockwise

public void setIsCounterClockwise(boolean isCCW)
                           throws IOException,
                                  AutomationException
Indicates if this circular is oriented counter-clockwise from its 'from' point to its 'to' point.

Description

IsCounterClockwise returns TRUE if the CentralAngle is greater than 0. If the IsCounterClockwise values differ, setting IsCounterClockwise changes the CircularArc to its Complement.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setIsCounterClockwise in interface ICircularArc
Parameters:
isCCW - The isCCW (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isMinor

public boolean isMinor()
                throws IOException,
                       AutomationException
Indicates whether this circular arc is a minor arc or a major arc.

Description

IsMinor is TRUE when the CentralAngle < Pi (180 degrees). If the IsMinor values differ, setting IsMinor changes the CircularArc to its Complement.

Remarks

CircularArc IsMinor Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
isMinor in interface ICircularArc
Returns:
The isMinor
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setIsMinor

public void setIsMinor(boolean isMinor)
                throws IOException,
                       AutomationException
Indicates whether this circular arc is a minor arc or a major arc.

Description

IsMinor is TRUE when the CentralAngle < Pi (180 degrees). If the IsMinor values differ, setting IsMinor changes the CircularArc to its Complement.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setIsMinor in interface ICircularArc
Parameters:
isMinor - The isMinor (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

complement

public void complement()
                throws IOException,
                       AutomationException
Changes this arc into its complement; 'from' and 'to' points are unchanged.

Description

The Complement of a CircularArc is the CircularArc between the ToPoint and the FromPoint of the original CircularArc that creates a full circle when combined with the original CircularArc. The Complement maintains the same FromPoint and ToPoint as the original CircularArc, but has the different IsMinor and IsCounterClockwise values.

Remarks

Complement Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
complement in interface ICircularArc
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getLength

public double getLength()
                 throws IOException,
                        AutomationException
The length of the curve.

Description

Returns the length of the entire curve. The length of the curve is the sum of the lengths along each parameterized Segment between vertices along the curve.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getLength in interface ICurve
Returns:
The length
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getFromPoint

public IPoint getFromPoint()
                    throws IOException,
                           AutomationException
The 'from' point of the curve.

Description

Returns or Sets the FromPoint of the first segment of the first part of the curve. While the curve may be composed of many parts and segments each with their own FromPoint, each curve only has a single From Point.

Remarks

FromPoint Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getFromPoint in interface ICurve
Returns:
A reference to a com.esri.arcgis.geometry.IPoint
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IPoint, ICurve.queryFromPoint(com.esri.arcgis.geometry.IPoint), ICurve.getFromPoint(), ICurve.queryToPoint(com.esri.arcgis.geometry.IPoint), ICurve.getToPoint()

setFromPoint

public void setFromPoint(IPoint from)
                  throws IOException,
                         AutomationException
The 'from' point of the curve.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setFromPoint in interface ICurve
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

queryFromPoint

public void queryFromPoint(IPoint from)
                    throws IOException,
                           AutomationException
Copies this curve's 'from' point to the input point.

Description

Used to query the FromPoint of the first Segment of the first part of the curve.

Remarks

Note: The output geometry must be co-created prior to the query. The output geometry is not co-created by the method; it is populated. This can be used in performance critical situations. For example, creating the geometry only once outside a loop and use the query method could improve performance.

QueryFromPoint Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
queryFromPoint in interface ICurve
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IPoint, ICurve.queryFromPoint(com.esri.arcgis.geometry.IPoint), ICurve.getFromPoint(), ICurve.queryToPoint(com.esri.arcgis.geometry.IPoint), ICurve.getToPoint()

getToPoint

public IPoint getToPoint()
                  throws IOException,
                         AutomationException
The 'to' point of the curve.

Description

Returns or Sets the ToPoint of the first Segment of the first part of the curve. While the curve may be composed of many parts and segments each with their own ToPoint, each curve only has a single To Point.

Remarks

ToPoint Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getToPoint in interface ICurve
Returns:
A reference to a com.esri.arcgis.geometry.IPoint
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IPoint, ICurve.queryFromPoint(com.esri.arcgis.geometry.IPoint), ICurve.getFromPoint(), ICurve.queryToPoint(com.esri.arcgis.geometry.IPoint), ICurve.getToPoint()

setToPoint

public void setToPoint(IPoint to)
                throws IOException,
                       AutomationException
The 'to' point of the curve.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setToPoint in interface ICurve
Parameters:
to - A reference to a com.esri.arcgis.geometry.IPoint (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

queryToPoint

public void queryToPoint(IPoint to)
                  throws IOException,
                         AutomationException
Copies the curve's 'to' point into the input point.

Description

Used to query the ToPoint of the first Segment of the first part of the curve.

Remarks

Note: The output geometry must be co-created prior to the query. The output geometry is not co-created by the method; it is populated. This can be used in performance critical situations. For example, creating the geometry only once outside a loop and use the query method could improve performance.

QueryToPoint Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
queryToPoint in interface ICurve
Parameters:
to - A reference to a com.esri.arcgis.geometry.IPoint (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IPoint, ICurve.queryFromPoint(com.esri.arcgis.geometry.IPoint), ICurve.getFromPoint(), ICurve.queryToPoint(com.esri.arcgis.geometry.IPoint), ICurve.getToPoint()

queryPoint

public void queryPoint(int extension,
                       double distanceAlongCurve,
                       boolean asRatio,
                       IPoint outPoint)
                throws IOException,
                       AutomationException
Copies to outPoint the properties of a point on the curve at a specified distance from the beginning of the curve.

Description

Returns the Point at a given distance along the curve or extended curve. If the distance is less than the length of the curve, then the returned point is the point at that distance along the curve. If the distance is less than zero, or greater than the length of the curve, then the returned point is on the curve specified by the extension method. The distance may be specified as a fixed unit of measure or a ratio of the length of the curve.

Remarks

Note: The output geometry must be co-created prior to the query. The output geometry is not co-created by the method; it is populated. This can be used in performance critical situations. For example, creating the geometry only once outside a loop and use the query method could improve performance.

ICurve QueryPoint Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
queryPoint in interface ICurve
Parameters:
extension - A com.esri.arcgis.geometry.esriSegmentExtension constant (in)
distanceAlongCurve - The distanceAlongCurve (in)
asRatio - The asRatio (in)
outPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IPoint, esriSegmentExtension

queryPointAndDistance

public void queryPointAndDistance(int extension,
                                  IPoint inPoint,
                                  boolean asRatio,
                                  IPoint outPoint,
                                  double[] distanceAlongCurve,
                                  double[] distanceFromCurve,
                                  boolean[] bRightSide)
                           throws IOException,
                                  AutomationException
Finds the point on the curve closest to inPoint, then copies that point to outPoint; optionally calculates related items.

Description

Finds the Point on the specified extended curve nearest to the input point and the distance between those points. Also returns information about the side of the curve the input point is on as well as the distance along the curve that the nearest point occurs.

Remarks

AsRatio is an input parameter that only affects the DistanceAlongCurve

distanceFromCurve is an output parameter that represents the minimum distance between the curve and the input point.

DistanceAlongCurve is an output parameter that represents the distance between the Frompoint of the input curve and the returned point on the curve.

bRightSide is an output parameter that tells if the input point is on the right side of the curve. The direction of the curve determines the right and left sides.

Note: The output geometry must be co-created prior to the query. The output geometry is not co-created by the method; it is populated. This can be used in performance critical situations. For example, creating the geometry only once outside a loop and use the query method could improve performance.

QueryPointAndDistance Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
queryPointAndDistance in interface ICurve
Parameters:
extension - A com.esri.arcgis.geometry.esriSegmentExtension constant (in)
inPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)
asRatio - The asRatio (in)
outPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)
distanceAlongCurve - The distanceAlongCurve (in/out: use single element array)
distanceFromCurve - The distanceFromCurve (in/out: use single element array)
bRightSide - The bRightSide (in/out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IPoint

queryTangent

public void queryTangent(int extension,
                         double distanceAlongCurve,
                         boolean asRatio,
                         double length,
                         ILine tangent)
                  throws IOException,
                         AutomationException
Constructs a line tangent to a curve from a point at a specified distance along the curve.

Description

Given a distance along the curve specified either as a ratio of the length or as a specific fixed distance, QueryTangent returns the Line tangent to the Point. The length and method of tangential extension of the tangent line are given by the user. The method of tangential extension determines the direction of the tangent line as though it were being extended at a From point or a To point.

Remarks

QueryTangent Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
queryTangent in interface ICurve
Parameters:
extension - A com.esri.arcgis.geometry.esriSegmentExtension constant (in)
distanceAlongCurve - The distanceAlongCurve (in)
asRatio - The asRatio (in)
length - The length (in)
tangent - A reference to a com.esri.arcgis.geometry.ILine (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
ILine

queryNormal

public void queryNormal(int extension,
                        double distanceAlongCurve,
                        boolean asRatio,
                        double length,
                        ILine normal)
                 throws IOException,
                        AutomationException
Constructs a line normal to a curve from a point at a specified distance along the curve.

Description

Given a distance along the curve specified either as a ratio of the Length or as a specific fixed distance, QueryNormal returns the Line normal to the Point. The length and method of tangential extension of the normal line are given by the user. The method of tangential extension determines the direction of the normal line as though it were being extended at a From point or a To point.

Remarks

QueryNormal Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
queryNormal in interface ICurve
Parameters:
extension - A com.esri.arcgis.geometry.esriSegmentExtension constant (in)
distanceAlongCurve - The distanceAlongCurve (in)
asRatio - The asRatio (in)
length - The length (in)
normal - A reference to a com.esri.arcgis.geometry.ILine (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
ILine

getSubcurve

public void getSubcurve(double fromDistance,
                        double toDistance,
                        boolean asRatio,
                        ICurve[] outSubcurve)
                 throws IOException,
                        AutomationException
Extracts a portion of this curve into a new curve.

Description

Gets the subcurve between the specified points along the original curve and creates a new curve. The elements in the new subcurve are the same type and have the same properties as the elements of the original curve. Which means if:

Input Geometry Output Geometry
Polygon Polyline
Polyline Polyline
Ring Path
Path Path
Segment Segment

If the input geometry is a polygon, you may want to use IRing::GetSubCurveEx which has more capabilities.

Remarks

Subcurve Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getSubcurve in interface ICurve
Parameters:
fromDistance - The fromDistance (in)
toDistance - The toDistance (in)
asRatio - The asRatio (in)
outSubcurve - A reference to a com.esri.arcgis.geometry.ICurve (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IRing.getSubcurveEx(double, double, boolean, boolean, boolean), ICurve.getSubcurve(double, double, boolean, com.esri.arcgis.geometry.ICurve[])

reverseOrientation

public void reverseOrientation()
                        throws IOException,
                               AutomationException
Reverses the parameterization of the curve ('from' point becomes 'to' point, first segment becomes last segment, etc).

Description

ReverseOrientation changes the direction of the curve without changing the spatial position of the curve. The From Point and To Point of each Segment in each part of the curve are interchanged.

Remarks

The ReverseOrientation method works the same way as the Arcedit FLIP command. It reverses the order of the vertices in the Curve.

Caution should be taken in using ReverseOrientation on Polygons. Since ReverseOrientation changes the direction of each Ring within the Polygon, all Exterior Rings become Interior Rings and vice versa.

Reverse Orientation Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
reverseOrientation in interface ICurve
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isClosed

public boolean isClosed()
                 throws IOException,
                        AutomationException
Indicates if 'from' and 'to' points (of each part) are identical.

Description

A curve is closed if the From and To points of each part of the curve are equal.

Remarks

IsClosed may still return TRUE if the curve consists of improperly constructed geometries (ex. non-continuous paths). IsClosed only checks the location of the From and To points of each part, it does not check the internal parts for topological consistency.

ICurve IsClosed Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
isClosed in interface ICurve
Returns:
The isClosed
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getGeometryType

public int getGeometryType()
                    throws IOException,
                           AutomationException
The type of this geometry.

Remarks

esriGeometryNull          = 0
esriGeometryPoint = 1
esriGeometryMultipoint = 2
esriGeometryPolyline = 3
esriGeometryPolygon = 4
esriGeometryEnvelope = 5
esriGeometryPath = 6
esriGeometryAny = 7
esriGeometryMultiPatch = 9
esriGeometryRing = 11
esriGeometryLine = 13
esriGeometryCircularArc = 14
esriGeometryBezier3Curve = 15
esriGeometryEllipticArc = 16
esriGeometryBag = 17
esriGeometryTriangleStrip = 18
esriGeometryTriangleFan = 19
esriGeometryRay = 20
esriGeometrySphere = 21
Geometry Type Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getGeometryType in interface IGeometry
Returns:
A com.esri.arcgis.geometry.esriGeometryType constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getDimension

public int getDimension()
                 throws IOException,
                        AutomationException
The topological dimension of this geometry.

Description

Returns the dimension of the geometry object based on the geometry's type.

Remarks


Note: At 9.0, Multipatches are now considered as two dimensional geometry. esriGeometry3Dimension will be used for an upcoming new geometry type.
Supported esriGeometryDimensions:

-1 esriGeometryNoDimension
1 esriGeometry0Dimension
2 esriGeometry1Dimension
4 esriGeometry2Dimension
5 esriGeometry25Dimension
6 esriGeometry3Dimension

Dimension Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getDimension in interface IGeometry
Returns:
A com.esri.arcgis.geometry.esriGeometryDimension constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getSpatialReference

public ISpatialReference getSpatialReference()
                                      throws IOException,
                                             AutomationException
The spatial reference associated with this geometry.

Description

Returns and sets the Spatial Reference in which the geometry exists. If the spatial reference has not been set the property will return an empty ISpatialReference instance.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getSpatialReference in interface IGeometry
Returns:
A reference to a com.esri.arcgis.geometry.ISpatialReference
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setSpatialReferenceByRef

public void setSpatialReferenceByRef(ISpatialReference spatialRef)
                              throws IOException,
                                     AutomationException
The spatial reference associated with this geometry.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setSpatialReferenceByRef in interface IGeometry
Parameters:
spatialRef - A reference to a com.esri.arcgis.geometry.ISpatialReference (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isEmpty

public boolean isEmpty()
                throws IOException,
                       AutomationException
Indicates whether this geometry contains any points.

Description

IsEmpty returns TRUE when the Geometry object does not contain geometric information beyond its original initialization state. An object may be returned to its original initialization (IsEmpty = TRUE) state using SetEmpty.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
isEmpty in interface IGeometry
Returns:
The isEmpty
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setEmpty

public void setEmpty()
              throws IOException,
                     AutomationException
Removes all points from this geometry.

Description

SetEmpty returns the Geometry to its original initialization state by releasing all data referenced by the Geometry.

Remarks


Use the SetEmpty method to clear geometries and release memory. For example, a polygon with 100 rings will have an internal array of 100 pointers to ring objects. That array will go away and Release will be called on each ring. If that polygon had the only reference on those rings, then they'll go away, which releases all their segments, which may also then go away.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setEmpty in interface IGeometry
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

queryEnvelope

public void queryEnvelope(IEnvelope outEnvelope)
                   throws IOException,
                          AutomationException
Copies this geometry's envelope properties into the specified envelope.

Description

Returns the unique Envelope that binds the Geometry object. This is the smallest Envelope that Contains the object.

Remarks

Note: The output geometry must be co-created prior to the query. The output geometry is not co-created by the method; it is populated. This can be used in performance critical situations. For example, creating the geometry only once outside a loop and use the query method could improve performance.

QueryEnvelope Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
queryEnvelope in interface IGeometry
Parameters:
outEnvelope - A reference to a com.esri.arcgis.geometry.IEnvelope (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getEnvelope

public IEnvelope getEnvelope()
                      throws IOException,
                             AutomationException
Creates a copy of this geometry's envelope and returns it.

Description

Returns the unique Envelope that binds the Geometry object. This is the smallest Envelope that Contains the object.

Remarks

Envelope Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getEnvelope in interface IGeometry
Returns:
A reference to a com.esri.arcgis.geometry.IEnvelope
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

project

public void project(ISpatialReference newReferenceSystem)
             throws IOException,
                    AutomationException
Projects this geometry into a new spatial reference.

Description

To Project, the geometry needs to have a Spatial Reference set, and not have an UnknownCoordinateSystem. The new spatial reference system passed to the method defines the output coordinate system. If either spatial reference is Unknown, the coordinates are not changed. The Z and measure values are not changed by the Project method.

A geometry is not densified before it is projected. This can lead to the output geometries not reflecting the 'true' shape in the new coordinate system. A straight line in one coordinate system is not necessarily a straight line in a different coordinate system. Use IGeometry2::ProjectEx if you want to densify the geometries while they are projected.

The Project method must be applied on high-level geometries only. High-Level geometries are point, multipoint, polyline and polygon. To use this method with low-level geometries such as segments (Line, Circular Arc, Elliptic Arc, Bézier Curve), paths or rings, they must be wrapped into high-level geometry types.

If a geometry is projected to a projected coordinate system that can't represent the geographic area where the geometry is located (or if trying to move an xy coordinate from outside the projected coordinate system back into geographic), the geometry will be set to empty.

Remarks

Note: This method can only be called upon the top level geometries (Points, Multipoints, Polylines and Polygons). If the from/to spatial references have different geographic coordinate systems, the Project method looks for a GeoTransformationsOperationSet. If the set of Geotransformations is present in memory, Project will use it to perform a geographic/datum Transformation. To use a specific geotransformation, use the IGeometry2::ProjectEx method.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
project in interface IGeometry
Parameters:
newReferenceSystem - A reference to a com.esri.arcgis.geometry.ISpatialReference (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

snapToSpatialReference

public void snapToSpatialReference()
                            throws IOException,
                                   AutomationException
Moves points of this geometry so that they can be represented in the precision of the geometry's associated spatial reference system.

Remarks

SnapToSpatialReference rounds all coordinates to the resolution defined by the geometry's spatial reference system. This has a similar effect on the geometry as storing the geometry in a Geodatabase.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
snapToSpatialReference in interface IGeometry
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

geoNormalize

public void geoNormalize()
                  throws IOException,
                         AutomationException
Shifts longitudes, if need be, into a continuous range of 360 degrees.

Remarks

GeoNormalize acts on geometries whose geographic system coordinates are below -180 degrees longitude or over +180 degrees longitude or on geometries that span the +-180 degrees longitude.
This method requires the geometry to have a valid spatial reference (geographic or projected coordinate system).
This method is used internally as part of the projection process for polygons and polylines. It is typically not used by itself.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
geoNormalize in interface IGeometry
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

geoNormalizeFromLongitude

public void geoNormalizeFromLongitude(double longitude)
                               throws IOException,
                                      AutomationException
Normalizes longitudes into a continuous range containing the longitude. This method is obsolete.

Remarks

This method is obsolete. Use IGeometry::GeoNormalize instead.
This method requires the geometry to have a valid spatial reference (geographic or projected coordinate system).

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
geoNormalizeFromLongitude in interface IGeometry
Parameters:
longitude - The longitude (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

move

public void move(double dx,
                 double dy)
          throws IOException,
                 AutomationException
Moves dx units horizontally and dy units vertically.

Description

Moves the Geometry dX units along the X-Axis and dY units along the Y-Axis. Only changes the position of the Geometry without altering any of the other characteristics. Move is a spatial offset.

Remarks

Transform2D Move Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
move in interface ITransform2D
Parameters:
dx - The dx (in)
dy - The dy (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

moveVector

public void moveVector(ILine v)
                throws IOException,
                       AutomationException
Moves a direction and distance v. v can be in a different spatial reference than the geometry being moved.

Description

Moves the Geometry dX units along the X-Axis and dY units along the Y-Axis, where dX and dY are calculated from the input vector Line. Only the Length and Angle of the vector affect the transformation. The location of the vector does not change the transformation. Only changes the position of the Geometry without altering any of the other characteristics. Move is a spatial offset.

Remarks

Transform2D MoveVector Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
moveVector in interface ITransform2D
Parameters:
v - A reference to a com.esri.arcgis.geometry.ILine (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

scale

public void scale(IPoint origin,
                  double sx,
                  double sy)
           throws IOException,
                  AutomationException
Scales about the specified origin using seperate horizonal and vertical scales. The origin point can be in a different spatial reference than the geometry being scaled.

Description

Stretches the Geometry a factor of sX along the X-Axis and a factor of sY along the Y-Axis (where sX is the ratio of Old Width to New Width, and sY is the ratio of Old Height to New Height). The Origin point is the reference Point from which the transformation is performed (Regardless of the location of the Origin point, the Geometry resulting from the transformation is the same, except for a positional offset). The Origin is the only point in the transformation guaranted to remain in the same location after the transformation is complete.

Remarks

Note: Caution must be taken when scaling a CircularArc or a geometry containing CircularArc segments. Unless Abs(ScaleX) = Abs(ScaleY), the resulting CircularArcs will not retain the characteristics of the original geometry (since they remain CircularArcs).

Scale Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
scale in interface ITransform2D
Parameters:
origin - A reference to a com.esri.arcgis.geometry.IPoint (in)
sx - The sx (in)
sy - The sy (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

rotate

public void rotate(IPoint origin,
                   double rotationAngle)
            throws IOException,
                   AutomationException
Rotates about the specified origin point. The angle is in radians. The origin can be in a different spatial reference than the geometry being rotated.

Description

Rotate performs an angular transform (rotation) on the Geometry. The Origin is the only point in the transformation guaranteed to remain in the same location after the transformation is performed. Regardless of the Origin, the transformed Geometry is the same, except for a positional offset. The RotationAngle is measured in radians.

Remarks

An Envelope cannot be Rotated.

Transform2D Rotate Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
rotate in interface ITransform2D
Parameters:
origin - A reference to a com.esri.arcgis.geometry.IPoint (in)
rotationAngle - The rotationAngle (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

transform

public void transform(int direction,
                      ITransformation transformation)
               throws IOException,
                      AutomationException
Applies an arbitrary transformation. In particular, the transformation parameter can be either an affine transformation or a geographic transformation (datum shift).

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
transform in interface ITransform2D
Parameters:
direction - A com.esri.arcgis.geometry.esriTransformDirection constant (in)
transformation - A reference to a com.esri.arcgis.geometry.ITransformation (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

putCoordsEx

public void putCoordsEx(IPoint from,
                        IPoint to)
                 throws IOException,
                        AutomationException
Sets this segment's endpoints to 'from' and 'to'.

Description

PutCoordsEx allows both the fromPoint and the toPoint to be set simultaneously.
A Conformal Transformation based on the original points and the new points
is applied to the curve.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
putCoordsEx in interface ICurve2
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
to - A reference to a com.esri.arcgis.geometry.IPoint (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

queryPointsAndDistances

public void queryPointsAndDistances(int extension,
                                    double searchRadius,
                                    IPoint inPoint,
                                    boolean asRatio,
                                    double[] distanceFromCurve,
                                    IEnumPointAndDistance[] pointsAndDistances)
                             throws IOException,
                                    AutomationException
Given an input point, calculates the minimum distance to the geometry and provides an enumerator over all closest points on the geometry, along with additional information.

Description

This method is similar to QueryPointsAndDistance; but it handles the case where the location of the minimum distance is not unique (See picture below). QueryPointAndDistance returns only the first location, this method returns all locations of minimum distance.

Remarks

AsRatio is an input parameter that only affects the DistanceAlongCurvereturned as part of the output IEnumPointAndDistance enumerator.

distanceFromCurve is an output parameter that represents the minimum distance between the curve and the input point.

IEnumPointAndDistance is an enumerator (it inherits from IEnumVertex) over all nearest points on the curve

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
queryPointsAndDistances in interface ICurve3
Parameters:
extension - A com.esri.arcgis.geometry.esriSegmentExtension constant (in)
searchRadius - The searchRadius (in)
inPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)
asRatio - The asRatio (in)
distanceFromCurve - The distanceFromCurve (in/out: use single element array)
pointsAndDistances - A reference to a com.esri.arcgis.geometry.IEnumPointAndDistance (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

queryCurvature

public void queryCurvature(double distanceAlongCurve,
                           boolean asRatio,
                           double[] curvature,
                           ILine unitVector)
                    throws IOException,
                           AutomationException
Finds curvature and unit vector starting at point on segment and directed to embedded circle center.

Description

Returns the curvature at a specified distance along the segment. The distance can be given explicitly or as a ratio of the entire length of the segment. The curvature is returned as a Line representing a directional unit vector (in the direction going from the From Point to the To Point) and a double representing the magnitude of the vector of curvature.

Remarks

The unit vector returned by QueryCurvature points toward the center of the circle that has the same first and second derivative at the queried point with a curvature value equal to 1 / Radius of that circle.

QueryCurvature Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
queryCurvature in interface ISegment
Parameters:
distanceAlongCurve - The distanceAlongCurve (in)
asRatio - The asRatio (in)
curvature - The curvature (out: use single element array)
unitVector - A reference to a com.esri.arcgis.geometry.ILine (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

returnTurnDirection

public int returnTurnDirection(ISegment otherSegment)
                        throws IOException,
                               AutomationException
Finds turn direction between two connected segments.

Description

Returns the Turn Direction of the Segment immediately following the current Segment. The two segments must be connected between the To Point of the first segment and the From Point of the second segment. ReturnTurnDirection returns a long corresponding to an esriTurnDirectionEnum or a combination of esriNoTurn or esriUTurn and esriRightTurn or esriLeftTurn. If the two segments are tangential at the point of connection and not completely colinear, then a combination of esriTurnDirectionEnums are returned.

Remarks

ReturnTurnDirection is only available for Lines and CircularArcs, not BezierCurves or EllipticArcs.

ReturnTurnDirection Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
returnTurnDirection in interface ISegment
Parameters:
otherSegment - A reference to a com.esri.arcgis.geometry.ISegment (in)
Returns:
The turnDirection
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

splitAtDistance

public void splitAtDistance(double distances,
                            boolean asRatio,
                            ISegment[] fromSegment,
                            ISegment[] toSegment)
                     throws IOException,
                            AutomationException
Split segment at specified distance.

Description

Splits the input Segment at the given distance and returns the Segment between the original From Point and the split point as well as the Segment between the split point and the original To Point. The split distance may be specified as a ratio of the total distance if AsRatio = TRUE, otherwise the distance is in the same units as the Length of the Segment.

Remarks

SplitAtDistance Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
splitAtDistance in interface ISegment
Parameters:
distances - The distances (in)
asRatio - The asRatio (in)
fromSegment - A reference to a com.esri.arcgis.geometry.ISegment (out: use single element array)
toSegment - A reference to a com.esri.arcgis.geometry.ISegment (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

splitDivideLength

public void splitDivideLength(double offset,
                              double length,
                              boolean asRatio,
                              int[] numSplitSegments,
                              ISegment splitSegments)
                       throws IOException,
                              AutomationException
Deprecated. This method uses C style arrays which are not supported in the ArcGIS API for Java. It is replaced by GeometryEnvironment.splitDivideLength(com.esri.arcgis.geometry.ISegment, double, double, boolean, int[], com.esri.arcgis.geometry.ISegment[][]).

Divide segment into smaller segments of the specified length.

Description

Outputs an array of Segments of a desired input length starting at an offset distance along the curve and continuing until the end of the Segment is reached. The offset and length may be specified as a ratio of the total length of the Segment. SplitDivideLength outputs an array of Segments and the number of Segments in that array. All of the output Segments in the array have the desired input length with the exception of the final Segment which has a length less than or equal to the input length (the remainder of the Segment).

Remarks

SplitDivideLength Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
splitDivideLength in interface ISegment
Parameters:
offset - The offset (in)
length - The length (in)
asRatio - The asRatio (in)
numSplitSegments - The numSplitSegments (in)
splitSegments - A reference to a com.esri.arcgis.geometry.ISegment (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

densify

public void densify(int cInSlots,
                    double maxDeviation,
                    int[] pcOutSegments,
                    ILine[] segments)
             throws IOException,
                    AutomationException
Deprecated. This method uses C style arrays which are not supported in the ArcGIS API for Java. It is replaced by GeometryEnvironment.densify(com.esri.arcgis.geometry.ISegment, double, int[], com.esri.arcgis.geometry.ILine[][]).

Densify segment into the specified number of smaller segments. This method is intended for internal use only.

Remarks

Densifying individual segments can be accomplished in client code by add the segment to a temporary polyline, then densifying the polyline using one of the methods on IPolycurve. Alternatively, the IGeometryBridge interface on the GeometryEnvironment object can be used.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
densify in interface ISegment
Parameters:
cInSlots - The cInSlots (in)
maxDeviation - The maxDeviation (in)
pcOutSegments - The pcOutSegments (out: use single element array)
segments - A reference to a com.esri.arcgis.geometry.ILine (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

geographicShift

public void geographicShift(double splitLongitude)
                     throws IOException,
                            AutomationException
Shift longitudes to the right of splitLongitude. This method is obsolete.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
geographicShift in interface ISegment
Parameters:
splitLongitude - The splitLongitude (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

constructEndPointsRadius

public void constructEndPointsRadius(IPoint from,
                                     IPoint to,
                                     boolean isCCW,
                                     double inRadius,
                                     boolean isMinor)
                              throws IOException,
                                     AutomationException
Constructs an arc from the given endpoints and radius.

Description

Constructs a CircularArc given the From Point, To Point, the desired Radius, IsCounterClockwise direction, and IsMinor value.

Remarks

ConstructCircularArc EndPoint Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructEndPointsRadius in interface IConstructCircularArc
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
to - A reference to a com.esri.arcgis.geometry.IPoint (in)
isCCW - The isCCW (in)
inRadius - The inRadius (in)
isMinor - The isMinor (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructEndPointsChordHeight(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructEndPointsRadius(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double, boolean), IConstructCircularArc.constructEndPointsArc(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructEndPointsTangent(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructThreePoints(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean), IConstructCircularArc.constructEndPointsAngle(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double)

constructEndPointsAngle

public void constructEndPointsAngle(IPoint from,
                                    IPoint to,
                                    boolean isCCW,
                                    double centralAngle)
                             throws IOException,
                                    AutomationException
Constructs an arc from the given endpoints and central angle.

Description

Constructs a CircularArc given the From Point, To Point, the desired orientation, and the desired Central Angle. The Central Angle is measured in radians.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc EndPoint Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructEndPointsAngle in interface IConstructCircularArc
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
to - A reference to a com.esri.arcgis.geometry.IPoint (in)
isCCW - The isCCW (in)
centralAngle - The centralAngle (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructEndPointsChordHeight(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructEndPointsRadius(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double, boolean), IConstructCircularArc.constructEndPointsArc(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructEndPointsTangent(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructThreePoints(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean), IConstructCircularArc.constructEndPointsAngle(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double)

constructEndPointsArc

public void constructEndPointsArc(IPoint from,
                                  IPoint to,
                                  boolean isCCW,
                                  double arcDistance)
                           throws IOException,
                                  AutomationException
Constructs an arc from the given endpoints and arc distance.

Description

Constructs a CircularArc given the From Point, To Point, the desired orientation, and the desired CircularArc Length. The Arc Distance must be greater than the distance between the From Point and the To Point, otherwise an error is returned.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc EndPoint Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructEndPointsArc in interface IConstructCircularArc
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
to - A reference to a com.esri.arcgis.geometry.IPoint (in)
isCCW - The isCCW (in)
arcDistance - The arcDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructEndPointsChordHeight(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructEndPointsRadius(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double, boolean), IConstructCircularArc.constructEndPointsArc(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructEndPointsTangent(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructThreePoints(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean), IConstructCircularArc.constructEndPointsAngle(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double)

constructEndPointsTangent

public void constructEndPointsTangent(IPoint from,
                                      IPoint to,
                                      boolean isCCW,
                                      double tangentDistance)
                               throws IOException,
                                      AutomationException
Constructs an arc from the given endpoints and tangent distance.

Description

Constructs a CircularArc given the From Point, To Point, the desired orientation, and the desired Tangent Distance. The Tangent Distance must be greater than half the distance between the From Point and the To Point, otherwise an error is returned.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc EndPoints Example

ConstructCircularArc Tangent Distance Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructEndPointsTangent in interface IConstructCircularArc
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
to - A reference to a com.esri.arcgis.geometry.IPoint (in)
isCCW - The isCCW (in)
tangentDistance - The tangentDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructEndPointsChordHeight(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructEndPointsRadius(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double, boolean), IConstructCircularArc.constructEndPointsArc(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructEndPointsTangent(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructThreePoints(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean), IConstructCircularArc.constructEndPointsAngle(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double)

constructArcDistance

public void constructArcDistance(IPoint center,
                                 IPoint from,
                                 boolean isCCW,
                                 double arcDistance)
                          throws IOException,
                                 AutomationException
Constructs an arc from a center point, a starting point, and an arc length.

Description

Constructs a CircularArc given the Center Point, From Point, the desired orientation, and the desired CircularArc Length. The Arc Distance must be less than 2 * Pi * the Radius (the distance between the From Point and the Center Point), otherwise an error is returned.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc CircularArc Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructArcDistance in interface IConstructCircularArc
Parameters:
center - A reference to a com.esri.arcgis.geometry.IPoint (in)
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
isCCW - The isCCW (in)
arcDistance - The arcDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructChordDistance(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructArcDistance(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructTangentDistance(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double)

constructChordDistance

public void constructChordDistance(IPoint center,
                                   IPoint from,
                                   boolean isCCW,
                                   double chordDistance)
                            throws IOException,
                                   AutomationException
Constructs an arc from a center point, a starting point, and a chord length.

Description

Constructs a CircularArc given the Center Point, From Point, the desired orientation, and the desired Chord Length. The Chord Distance must be less than 2 * the Radius (the distance between the From Point and the Center Point), otherwise an error is returned. Only IsMinor CircularArcs can be constructed.

Remarks

-isCCW stands for "is counter clockwise"

Note : To construct a major CircularArc using the same paramaters use the IConstructCircularcArc2::ConstructChordDistanceEx method with the IsMinor parameter equal to false.

ConstructCircularArc ChordDistance Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructChordDistance in interface IConstructCircularArc
Parameters:
center - A reference to a com.esri.arcgis.geometry.IPoint (in)
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
isCCW - The isCCW (in)
chordDistance - The chordDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructChordDistance(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructArcDistance(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructTangentDistance(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double)

constructTangentDistance

public void constructTangentDistance(IPoint center,
                                     IPoint from,
                                     boolean isCCW,
                                     double tangentDistance)
                              throws IOException,
                                     AutomationException
Constructs an arc from a center point, a starting point, and an tangent length.

Description

Constructs a CircularArc given the Center Point, From Point, the desired orientation, and the desired Tangent Distance.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc TangentDistance Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructTangentDistance in interface IConstructCircularArc
Parameters:
center - A reference to a com.esri.arcgis.geometry.IPoint (in)
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
isCCW - The isCCW (in)
tangentDistance - The tangentDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructChordDistance(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructArcDistance(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructTangentDistance(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double)

constructTangentRadiusArc

public void constructTangentRadiusArc(ISegment segment,
                                      boolean atStart,
                                      boolean isCCW,
                                      double inRadius,
                                      double arcDistance)
                               throws IOException,
                                      AutomationException
Constructs an arc having a common tangent to the input segment, a given radius and an arc length.

Description

Constructs a CircularArc given the Tangent Segment, the desired segment endpoint (the From Point), the desired orientation, the desired Radius, and the desired CircularArc Length. If the Arc Distance is greater than 2 * Pi * Radius, a full circle is constructed.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Tangent Segment Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructTangentRadiusArc in interface IConstructCircularArc
Parameters:
segment - A reference to a com.esri.arcgis.geometry.ISegment (in)
atStart - The atStart (in)
isCCW - The isCCW (in)
inRadius - The inRadius (in)
arcDistance - The arcDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructTangentAndPoint(com.esri.arcgis.geometry.ISegment, boolean, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructTangentAngleTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusAngle(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentArcTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double)

constructTangentRadiusChord

public void constructTangentRadiusChord(ISegment segment,
                                        boolean atStart,
                                        boolean isCCW,
                                        double inRadius,
                                        double chordDistance)
                                 throws IOException,
                                        AutomationException
Constructs an arc with a common tangent to the input segment, a given radius and a chord length.

Description

Constructs a CircularArc given the Tangent Segment, the desired segment endpoint (the From Point), the desired orientation, the desired Radius, and the desired Chord Length. If the Chord Distance is greater than 2 * Radius, a half CircularArc is returned. Only IsMinor CircularArcs can be created.

Remarks

-isCCW stands for "is counter clockwise"

Note : To construct a major CircularArc using the same paramaters use the IConstructCircularcArc2::ConstructTangentRadiusChordEx method with the IsMinor parameter equal to false.

ConstructCircularArc Tangent Segment Example

ConstructCircularArc Chord Distance Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructTangentRadiusChord in interface IConstructCircularArc
Parameters:
segment - A reference to a com.esri.arcgis.geometry.ISegment (in)
atStart - The atStart (in)
isCCW - The isCCW (in)
inRadius - The inRadius (in)
chordDistance - The chordDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructTangentAndPoint(com.esri.arcgis.geometry.ISegment, boolean, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructTangentAngleTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusAngle(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentArcTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double)

constructTangentRadiusTangent

public void constructTangentRadiusTangent(ISegment segment,
                                          boolean atStart,
                                          boolean isCCW,
                                          double inRadius,
                                          double tangentDistance)
                                   throws IOException,
                                          AutomationException
Constructs an arc with a common tangent to the input segment, a given radius and a tangent length.

Description

Constructs a CircularArc given the Tangent Segment, the desired segment endpoint (the From Point), the desired orientation, the desired Radius, and the desired Tangent Distance.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Tangent Segment Example

ConstructCircularArc Tangent Distance Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructTangentRadiusTangent in interface IConstructCircularArc
Parameters:
segment - A reference to a com.esri.arcgis.geometry.ISegment (in)
atStart - The atStart (in)
isCCW - The isCCW (in)
inRadius - The inRadius (in)
tangentDistance - The tangentDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructTangentAndPoint(com.esri.arcgis.geometry.ISegment, boolean, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructTangentAngleTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusAngle(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentArcTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double)

constructTangentRadiusAngle

public void constructTangentRadiusAngle(ISegment segment,
                                        boolean atStart,
                                        boolean isCCW,
                                        double inRadius,
                                        double centralAngle)
                                 throws IOException,
                                        AutomationException
Constructs an arc with a common tangent to the input segment, a given radius and a central angle.

Description

Constructs a CircularArc given the Tangent Segment, the desired segment endpoint (the From Point), the desired orientation, the desired Radius, and the desired Central Angle. The Central Angle is measured in radians. A full CircularArc is constructed if the Central Angle is greater than 2*Pi.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Tangent Segment Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructTangentRadiusAngle in interface IConstructCircularArc
Parameters:
segment - A reference to a com.esri.arcgis.geometry.ISegment (in)
atStart - The atStart (in)
isCCW - The isCCW (in)
inRadius - The inRadius (in)
centralAngle - The centralAngle (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructTangentAndPoint(com.esri.arcgis.geometry.ISegment, boolean, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructTangentAngleTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusAngle(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentArcTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double)

constructTangentAngleArc

public void constructTangentAngleArc(ISegment segment,
                                     boolean atStart,
                                     boolean isCCW,
                                     double centralAngle,
                                     double arcDistance)
                              throws IOException,
                                     AutomationException
Constructs an arc with a common tangent to the input segment, a given central angle and an arc length.

Description

Constructs a CircularArc given the Tangent Segment, the desired segment endpoint (the From Point), the desired orientation, the desired Central Angle, and the desired CircularArc Length. The Central Angle is measured in radians. A full CircularArc is constructed if the Central Angle is greater than 2*Pi.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Tangent Segment Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructTangentAngleArc in interface IConstructCircularArc
Parameters:
segment - A reference to a com.esri.arcgis.geometry.ISegment (in)
atStart - The atStart (in)
isCCW - The isCCW (in)
centralAngle - The centralAngle (in)
arcDistance - The arcDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructTangentAndPoint(com.esri.arcgis.geometry.ISegment, boolean, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructTangentAngleTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusAngle(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentArcTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double)

constructTangentAngleChord

public void constructTangentAngleChord(ISegment segment,
                                       boolean atStart,
                                       boolean isCCW,
                                       double centralAngle,
                                       double chordDistance)
                                throws IOException,
                                       AutomationException
Constructs an arc with a common tangent to the input segment, a given central angle and a chord length.

Description

Constructs a CircularArc given the Tangent Segment, the desired segment endpoint (the From Point), the desired orientation, the desired Central Angle, and the desired Chord Length. The Central Angle is measured in radians. Only IsMinor CircularArcs can be constructed. The Central Angle should be between 0 and Pi (half CircularArc) for the CircularArc to be properly constructed as expected.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Tangent Segment Example

ConstructCircularArc Chord Distance Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructTangentAngleChord in interface IConstructCircularArc
Parameters:
segment - A reference to a com.esri.arcgis.geometry.ISegment (in)
atStart - The atStart (in)
isCCW - The isCCW (in)
centralAngle - The centralAngle (in)
chordDistance - The chordDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructTangentAndPoint(com.esri.arcgis.geometry.ISegment, boolean, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructTangentAngleTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusAngle(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentArcTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double)

constructTangentAngleTangent

public void constructTangentAngleTangent(ISegment segment,
                                         boolean atStart,
                                         boolean isCCW,
                                         double centralAngle,
                                         double tangentDistance)
                                  throws IOException,
                                         AutomationException
Constructs an arc with a common tangent to the input segment, a given central angle and a tangent length.

Description

Constructs a CircularArc given the Tangent Segment, the desired segment endpoint (the From Point), the desired orientation, the desired Central Angle, and the desired Tangent Distance. The Central Angle is measured in radians. If the Central Angle is greater than or equal to Pi (half CircularArc), an empty CircularArc is constructed.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Tangent Segment Example

ConstructCircularArc Tangent Distance Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructTangentAngleTangent in interface IConstructCircularArc
Parameters:
segment - A reference to a com.esri.arcgis.geometry.ISegment (in)
atStart - The atStart (in)
isCCW - The isCCW (in)
centralAngle - The centralAngle (in)
tangentDistance - The tangentDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructTangentAndPoint(com.esri.arcgis.geometry.ISegment, boolean, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructTangentAngleTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusAngle(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentArcTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double)

constructTangentChordArc

public void constructTangentChordArc(ISegment segment,
                                     boolean atStart,
                                     boolean isCCW,
                                     double chordDistance,
                                     double arcDistance)
                              throws IOException,
                                     AutomationException
Constructs an arc with a common tangent to the input segment, a given chord length and an arc length.

Description

Constructs a CircularArc given the Tangent Segment, the desired segment endpoint (the From Point), the desired orientation, the desired Chord Distance, and the desired CircularArc Length. Only IsMinor CircularArcs can be constructed.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Tangent Segment Example

ConstructCircularArc ChordLength Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructTangentChordArc in interface IConstructCircularArc
Parameters:
segment - A reference to a com.esri.arcgis.geometry.ISegment (in)
atStart - The atStart (in)
isCCW - The isCCW (in)
chordDistance - The chordDistance (in)
arcDistance - The arcDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructTangentAndPoint(com.esri.arcgis.geometry.ISegment, boolean, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructTangentAngleTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusAngle(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentArcTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double)

constructTangentChordTangent

public void constructTangentChordTangent(ISegment segment,
                                         boolean atStart,
                                         boolean isCCW,
                                         double chordDistance,
                                         double tangentDistance)
                                  throws IOException,
                                         AutomationException
Constructs an arc with a common tangent to input segment, a given chord length and a tangent length.

Description

Constructs a CircularArc given the Tangent Segment, the desired segment endpoint (the From Point), the desired orientation, the desired Chord Distance, and the desired Tangent Distance. The Tangent Distance must be great than half the Chord Distance, otherwise an error is returned.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Tangent Segment Example

ConstructCircularArc Chord and Tangent Distance Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructTangentChordTangent in interface IConstructCircularArc
Parameters:
segment - A reference to a com.esri.arcgis.geometry.ISegment (in)
atStart - The atStart (in)
isCCW - The isCCW (in)
chordDistance - The chordDistance (in)
tangentDistance - The tangentDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructTangentAndPoint(com.esri.arcgis.geometry.ISegment, boolean, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructTangentAngleTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusAngle(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentArcTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double)

constructTangentArcTangent

public void constructTangentArcTangent(ISegment segment,
                                       boolean atStart,
                                       boolean isCCW,
                                       double arcDistance,
                                       double tangentDistance)
                                throws IOException,
                                       AutomationException
Constructs an arc with a common tangent to the input segment, a given arc length and a tangent length.

Description

Constructs a CircularArc given the Tangent Segment, the desired segment endpoint (the From Point), the desired orientation, the desired CircularArc Length, and the desired Tangent Distance. Only IsMinor CircularArcs can be constructed. The Tangent Distance must be greater than half the Arc Distance, otherwise an error is returned.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Tangent Segment Example

ConstructCircularArc Tangent Distance Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructTangentArcTangent in interface IConstructCircularArc
Parameters:
segment - A reference to a com.esri.arcgis.geometry.ISegment (in)
atStart - The atStart (in)
isCCW - The isCCW (in)
arcDistance - The arcDistance (in)
tangentDistance - The tangentDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructTangentAndPoint(com.esri.arcgis.geometry.ISegment, boolean, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructTangentAngleTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusAngle(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentArcTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double)

constructBearingRadiusAngle

public void constructBearingRadiusAngle(IPoint startPoint,
                                        double inAngle,
                                        boolean isCCW,
                                        double inRadius,
                                        double centralAngle)
                                 throws IOException,
                                        AutomationException
Constructs an arc with the given chord bearing, radius and central angle.

Description

Constructs a CircularArc given the From Point, the Bearing Angle, the desired orientation, the desired Radius, and the desired Central Angle. The Bearing Angle and Central Angle are measured in radians. The Central Angle should not be greater than 2 * Pi.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Bearing Angle Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructBearingRadiusAngle in interface IConstructCircularArc
Parameters:
startPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)
inAngle - The inAngle (in)
isCCW - The isCCW (in)
inRadius - The inRadius (in)
centralAngle - The centralAngle (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructBearingAngleChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusAngle(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructLine(com.esri.arcgis.geometry.ILine), IConstructCircularArc.constructBearingAngleTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingArcTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingAngleArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructThreePoint(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructBearingRadiusChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double, boolean)

constructBearingRadiusArc

public void constructBearingRadiusArc(IPoint from,
                                      double inAngle,
                                      boolean isCCW,
                                      double inRadius,
                                      double arcDistance)
                               throws IOException,
                                      AutomationException
Constructs an arc with the given chord bearing, radius and arc distance.

Description

Constructs a CircularArc given the From Point, the Bearing Angle, the desired orientation, the desired Radius, and the desired CircularArc Length. The Bearing Angle is measured in radians. The Arc Distance should not be greater than 2 * Pi * Radius.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Bearing Angle Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructBearingRadiusArc in interface IConstructCircularArc
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
inAngle - The inAngle (in)
isCCW - The isCCW (in)
inRadius - The inRadius (in)
arcDistance - The arcDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructBearingAngleChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusAngle(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructLine(com.esri.arcgis.geometry.ILine), IConstructCircularArc.constructBearingAngleTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingArcTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingAngleArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructThreePoint(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructBearingRadiusChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double, boolean)

constructBearingRadiusChord

public void constructBearingRadiusChord(IPoint from,
                                        double inAngle,
                                        boolean isCCW,
                                        double inRadius,
                                        double chordDistance,
                                        boolean isMinor)
                                 throws IOException,
                                        AutomationException
Constructs an arc with the given chord bearing, radius and chord distance.

Description

Constructs a CircularArc given the From Point, the Bearing Angle, the desired orientation, the desired Radius, the desired Chord Distance, and the IsMinor orientation. The Bearing Angle is measured in radians. The Chord Distance must be less than twice the Radius, otherwise an error is returned.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Bearing Angle Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructBearingRadiusChord in interface IConstructCircularArc
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
inAngle - The inAngle (in)
isCCW - The isCCW (in)
inRadius - The inRadius (in)
chordDistance - The chordDistance (in)
isMinor - The isMinor (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructBearingAngleChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusAngle(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructLine(com.esri.arcgis.geometry.ILine), IConstructCircularArc.constructBearingAngleTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingArcTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingAngleArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructThreePoint(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructBearingRadiusChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double, boolean)

constructBearingRadiusTangent

public void constructBearingRadiusTangent(IPoint from,
                                          double inAngle,
                                          boolean isCCW,
                                          double inRadius,
                                          double tangentDistance)
                                   throws IOException,
                                          AutomationException
Constructs an arc with the given chord bearing, radius and tangent distance.

Description

Constructs a CircularArc given the From Point, the Bearing Angle, the desired orientation, the desired Radius, and the desired Tangent Distance. The Bearing Angle is measured in radians.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Bearing Angle Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructBearingRadiusTangent in interface IConstructCircularArc
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
inAngle - The inAngle (in)
isCCW - The isCCW (in)
inRadius - The inRadius (in)
tangentDistance - The tangentDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructBearingAngleChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusAngle(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructLine(com.esri.arcgis.geometry.ILine), IConstructCircularArc.constructBearingAngleTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingArcTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingAngleArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructThreePoint(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructBearingRadiusChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double, boolean)

constructBearingAngleArc

public void constructBearingAngleArc(IPoint from,
                                     double inAngle,
                                     boolean isCCW,
                                     double centralAngle,
                                     double arcDistance)
                              throws IOException,
                                     AutomationException
Constructs an arc with the given chord bearing, central angle and arc distance.

Description

Constructs a CircularArc given the From Point, the Bearing Angle, the desired orientation, the desired Central Angle, and the desired CircularArc Length. The Bearing Angle and Central Angle are measured in radians.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Bearing Angle Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructBearingAngleArc in interface IConstructCircularArc
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
inAngle - The inAngle (in)
isCCW - The isCCW (in)
centralAngle - The centralAngle (in)
arcDistance - The arcDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructBearingAngleChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusAngle(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructLine(com.esri.arcgis.geometry.ILine), IConstructCircularArc.constructBearingAngleTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingArcTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingAngleArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructThreePoint(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructBearingRadiusChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double, boolean)

constructBearingAngleChord

public void constructBearingAngleChord(IPoint from,
                                       double inAngle,
                                       boolean isCCW,
                                       double centralAngle,
                                       double chordDistance)
                                throws IOException,
                                       AutomationException
Constructs an arc with the given chord bearing, central angle and chord distance.

Description

Constructs a CircularArc given the From Point, the Bearing Angle, the desired orientation, the desired Central Angle, and the desired Chord Distance. The Bearing Angle and Central Angle are measured in radians.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Bearing Angle Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructBearingAngleChord in interface IConstructCircularArc
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
inAngle - The inAngle (in)
isCCW - The isCCW (in)
centralAngle - The centralAngle (in)
chordDistance - The chordDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructBearingAngleChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusAngle(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructLine(com.esri.arcgis.geometry.ILine), IConstructCircularArc.constructBearingAngleTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingArcTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingAngleArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructThreePoint(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructBearingRadiusChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double, boolean)

constructBearingAngleTangent

public void constructBearingAngleTangent(IPoint from,
                                         double inAngle,
                                         boolean isCCW,
                                         double centralAngle,
                                         double tangentDistance)
                                  throws IOException,
                                         AutomationException
Constructs an arc with the given chord bearing, central angle and tangent distance.

Description

Constructs a CircularArc given the From Point, the Bearing Angle, the desired orientation, the desired Central Angle, and the desired Tangent Distance. The Bearing Angle and Central Angle are measured in radians. The Central Angle should be less than 2 * Pi to ensure proper results. If the Central Angle is greater than Pi, the Tangent Distance is measured opposite the direction of the tangents.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Bearing Angle Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructBearingAngleTangent in interface IConstructCircularArc
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
inAngle - The inAngle (in)
isCCW - The isCCW (in)
centralAngle - The centralAngle (in)
tangentDistance - The tangentDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructBearingAngleChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusAngle(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructLine(com.esri.arcgis.geometry.ILine), IConstructCircularArc.constructBearingAngleTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingArcTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingAngleArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructThreePoint(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructBearingRadiusChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double, boolean)

constructBearingChordArc

public void constructBearingChordArc(IPoint from,
                                     double inAngle,
                                     boolean isCCW,
                                     double chordDistance,
                                     double arcDistance)
                              throws IOException,
                                     AutomationException
Constructs an arc with the given chord bearing, chord distance and arc distance (negative for clockwise orientation).

Description

Constructs a CircularArc given the From Point, the Bearing Angle, the desired orientation, the desired Chord Distance, and the desired CircularArc Length. The Bearing Angle is measured in radians. The Chord Distance must be less than the Arc Distance, otherwise an error is returned.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Bearing Angle Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructBearingChordArc in interface IConstructCircularArc
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
inAngle - The inAngle (in)
isCCW - The isCCW (in)
chordDistance - The chordDistance (in)
arcDistance - The arcDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructBearingAngleChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusAngle(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructLine(com.esri.arcgis.geometry.ILine), IConstructCircularArc.constructBearingAngleTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingArcTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingAngleArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructThreePoint(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructBearingRadiusChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double, boolean)

constructBearingChordTangent

public void constructBearingChordTangent(IPoint from,
                                         double inAngle,
                                         boolean isCCW,
                                         double chordDistance,
                                         double tangentDistance)
                                  throws IOException,
                                         AutomationException
Constructs an arc with the given chord bearing, chord distance and tangent distance.

Description

Constructs a CircularArc given the From Point, the Bearing Angle, the desired orientation, the desired Chord Distance, and the desired Tangent Distance. The Bearing Angle is measured in radians. The Tangent Distance must be greater than half the Chord Distance, otherwise an error is returned.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Bearing Angle Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructBearingChordTangent in interface IConstructCircularArc
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
inAngle - The inAngle (in)
isCCW - The isCCW (in)
chordDistance - The chordDistance (in)
tangentDistance - The tangentDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructBearingAngleChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusAngle(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructLine(com.esri.arcgis.geometry.ILine), IConstructCircularArc.constructBearingAngleTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingArcTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingAngleArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructThreePoint(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructBearingRadiusChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double, boolean)

constructBearingArcTangent

public void constructBearingArcTangent(IPoint from,
                                       double inAngle,
                                       boolean isCCW,
                                       double arcDistance,
                                       double tangentDistance)
                                throws IOException,
                                       AutomationException
Constructs an arc with the given chord bearing, arc distance and tangent distance.

Description

Constructs a CircularArc given the From Point, the Bearing Angle, the desired orientation, the desired CircularArc Length, and the desired Tangent Distance. The Bearing Angle is measured in radians. The Tangent Distance must be greater than half the Arc Distance, otherwise an error is returned.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc Bearing Angle Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructBearingArcTangent in interface IConstructCircularArc
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
inAngle - The inAngle (in)
isCCW - The isCCW (in)
arcDistance - The arcDistance (in)
tangentDistance - The tangentDistance (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructBearingAngleChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusAngle(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructLine(com.esri.arcgis.geometry.ILine), IConstructCircularArc.constructBearingAngleTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingArcTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingAngleArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingChordArc(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructCircularArc.constructBearingRadiusTangent(com.esri.arcgis.geometry.IPoint, double, boolean, double, double), IConstructAngle.constructThreePoint(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructBearingRadiusChord(com.esri.arcgis.geometry.IPoint, double, boolean, double, double, boolean)

constructThreePoints

public void constructThreePoints(IPoint from,
                                 IPoint middle,
                                 IPoint to,
                                 boolean useExistingCenter)
                          throws IOException,
                                 AutomationException
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.

Description

Given a From Point, a Thru Point, and a To Point, the unique CircularArc defined by those points is constructed. The From and To Points become the From and To Points of the CircularArc. The Thru Point is a point that lies somewhere on the CircularArc. For every three points, a single well-defined CircularArc can be created. (The only exception is if all three points are colinear and the Thru Point is not between the From and To Points.)

Remarks

ConstructThreePoints is excellent for creating a CircularArc with exact endpoint coordinates.

The from and to points may be identical, in which case the third point, if it is distinct, will be on the circle and diametrically opposed to the from/to point (orientation will be clockwise).

CircularArc ConstructThreePoints Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructThreePoints in interface IConstructCircularArc
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
middle - A reference to a com.esri.arcgis.geometry.IPoint (in)
to - A reference to a com.esri.arcgis.geometry.IPoint (in)
useExistingCenter - The useExistingCenter (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructEndPointsChordHeight(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructEndPointsRadius(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double, boolean), IConstructCircularArc.constructEndPointsArc(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructEndPointsTangent(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructEndPointsAngle(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double)

constructFilletPoint

public void constructFilletPoint(ISegment s1,
                                 ISegment s2,
                                 IPoint from,
                                 IPoint hintPoint)
                          throws IOException,
                                 AutomationException
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.

Description

A Fillet Arc is a CircularArc constructed between two input segments such that the CircularArc is tangential to both embedded segments at the Fillet Arc endpoints. ConstructFilletPoint constructs a Fillet Arc between two input Segments given a suggested From Point and a Hint Point. The From Point of the Fillet Arc is the nearest point on one of the input segments to the input From Point. The Hint Point determines which Fillet Arc is to be constructed and the region in which the desired Fillet Arc should exist. The To Point of the Fillet Arc lies on the embedded extension of the other segment. If the Hint Point lies in a region in which the Fillet Arc cannot be constructed given the input From Point, an error is returned.

Remarks

ConstructCircularArc Construct Fillet Point Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructFilletPoint in interface IConstructCircularArc
Parameters:
s1 - A reference to a com.esri.arcgis.geometry.ISegment (in)
s2 - A reference to a com.esri.arcgis.geometry.ISegment (in)
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
hintPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructFilletPoint(com.esri.arcgis.geometry.ISegment, com.esri.arcgis.geometry.ISegment, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.queryFilletRadiusRange(com.esri.arcgis.geometry.ISegment, com.esri.arcgis.geometry.ISegment, com.esri.arcgis.geometry.IPoint, double[], double[]), IConstructCircularArc.constructFilletRadius(com.esri.arcgis.geometry.ISegment, com.esri.arcgis.geometry.ISegment, double, com.esri.arcgis.geometry.IPoint)

constructFilletRadius

public void constructFilletRadius(ISegment s1,
                                  ISegment s2,
                                  double inRadius,
                                  IPoint hintPoint)
                           throws IOException,
                                  AutomationException
Constructs an arc of given radius and tangent to two segments. hintPoint can be nil or can be a location near the desired fillet.

Description

A Fillet Arc is a CircularArc constructed between two input segments such that the CircularArc is tangential to both embedded segments at the Fillet Arc endpoints. ConstructFilletRadius constructs a Fillet Arc of a given input Radius between two input Segments given a Hint Point. The Hint Point determines which Fillet Arc is to be constructed. The endpoints of the Fillet Arc lie on the embedded extensions of the input Segments. The From Point always lies on the embedded extension of the first input segment. If the Hint Point lies in a region in which the Fillet Arc cannot be constructed with the given Radius, an error is returned. The input Radius must be greater than 0, otherwise an error is returned. Use QueryFilletRadiusRange to find the range of radii for a given set of inputs such that the constructed Fillet Arc has endpoints on both of the non-extended input segments.

Remarks

ConstructCircularArc Construct Fillet Radius Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructFilletRadius in interface IConstructCircularArc
Parameters:
s1 - A reference to a com.esri.arcgis.geometry.ISegment (in)
s2 - A reference to a com.esri.arcgis.geometry.ISegment (in)
inRadius - The inRadius (in)
hintPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructFilletPoint(com.esri.arcgis.geometry.ISegment, com.esri.arcgis.geometry.ISegment, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.queryFilletRadiusRange(com.esri.arcgis.geometry.ISegment, com.esri.arcgis.geometry.ISegment, com.esri.arcgis.geometry.IPoint, double[], double[]), IConstructCircularArc.constructFilletRadius(com.esri.arcgis.geometry.ISegment, com.esri.arcgis.geometry.ISegment, double, com.esri.arcgis.geometry.IPoint)

queryFilletRadiusRange

public void queryFilletRadiusRange(ISegment s1,
                                   ISegment s2,
                                   IPoint hintPoint,
                                   double[] minRadius,
                                   double[] maxRadius)
                            throws IOException,
                                   AutomationException
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.

Description

A Fillet Arc is a CircularArc constructed between two input segments such that the CircularArc is tangential to both embedded segments at the Fillet Arc endpoints. QueryFilletRadiusRange determines the Maximum and Minimum Fillet Arc Radii in the region of the given Hint Point that can be used in ConstructFilletRadius such that the endpoints of the Fillet Arc lie on both input curves without extension. If no such Radii exist for the given Hint Point, an error is returned.

Remarks

ConstructCircularArc Query Fillet Radius Range Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
queryFilletRadiusRange in interface IConstructCircularArc
Parameters:
s1 - A reference to a com.esri.arcgis.geometry.ISegment (in)
s2 - A reference to a com.esri.arcgis.geometry.ISegment (in)
hintPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)
minRadius - The minRadius (out: use single element array)
maxRadius - The maxRadius (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructFilletPoint(com.esri.arcgis.geometry.ISegment, com.esri.arcgis.geometry.ISegment, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.queryFilletRadiusRange(com.esri.arcgis.geometry.ISegment, com.esri.arcgis.geometry.ISegment, com.esri.arcgis.geometry.IPoint, double[], double[]), IConstructCircularArc.constructFilletRadius(com.esri.arcgis.geometry.ISegment, com.esri.arcgis.geometry.ISegment, double, com.esri.arcgis.geometry.IPoint)

constructTangentAndPoint

public void constructTangentAndPoint(ISegment s,
                                     boolean atFrom,
                                     IPoint p)
                              throws IOException,
                                     AutomationException
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.

Description

Constructs a CircularArc given the Tangent Segment, the desired segment endpoint (the From Point), and the desired To Point. The Center Point of the constructed CircularArc lies on the Normal to the desired segment endpoint on the same side of the extended tangent as the To Point. If the To Point lies on the tangent line from the desired segment endpoint, an IsLine CircularArc is constructed.

Remarks

ConstructCircularArc Tangent Segment Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructTangentAndPoint in interface IConstructCircularArc
Parameters:
s - A reference to a com.esri.arcgis.geometry.ISegment (in)
atFrom - The atFrom (in)
p - A reference to a com.esri.arcgis.geometry.IPoint (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructTangentAndPoint(com.esri.arcgis.geometry.ISegment, boolean, com.esri.arcgis.geometry.IPoint), IConstructCircularArc.constructTangentAngleTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusAngle(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentAngleArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentArcTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentChordArc(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusChord(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double), IConstructCircularArc.constructTangentRadiusTangent(com.esri.arcgis.geometry.ISegment, boolean, boolean, double, double)

constructEndPointsChordHeight

public void constructEndPointsChordHeight(IPoint from,
                                          IPoint to,
                                          boolean isCCW,
                                          double chordHeight)
                                   throws IOException,
                                          AutomationException
Constructs an arc with specified endpoints and and chord height.

Description

Constructs a CircularArc given the From Point, To Point, the desired orientation, and the desired Chord Height.

Remarks

-isCCW stands for "is counter clockwise"

ConstructCircularArc EndPoints Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructEndPointsChordHeight in interface IConstructCircularArc
Parameters:
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
to - A reference to a com.esri.arcgis.geometry.IPoint (in)
isCCW - The isCCW (in)
chordHeight - The chordHeight (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructEndPointsChordHeight(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructEndPointsRadius(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double, boolean), IConstructCircularArc.constructEndPointsArc(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructEndPointsTangent(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double), IConstructCircularArc.constructThreePoints(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean), IConstructCircularArc.constructEndPointsAngle(com.esri.arcgis.geometry.IPoint, com.esri.arcgis.geometry.IPoint, boolean, double)

constructCircle

public void constructCircle(IPoint centerPoint,
                            double radius,
                            boolean isCCW)
                     throws IOException,
                            AutomationException
Constructs a circle of a given radius and orientation.

Description

Constructs a complete circle given the Center Point, the Radius of the circle, and the desired Orientation. The From and To Points are located on the YMax point of the CircularArc.

Remarks

-isCCW stands for "is counter clockwise"

CircularArc ConstructCircle Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructCircle in interface IConstructCircularArc
Parameters:
centerPoint - A reference to a com.esri.arcgis.geometry.IPoint (in)
radius - The radius (in)
isCCW - The isCCW (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
IConstructCircularArc.constructCircle(com.esri.arcgis.geometry.IPoint, double, boolean), ISegmentCollection.setCircle(com.esri.arcgis.geometry.IPoint, double)

constructChordDistanceEx

public void constructChordDistanceEx(IPoint center,
                                     IPoint from,
                                     boolean isCCW,
                                     double chordDistance,
                                     boolean isMinor)
                              throws IOException,
                                     AutomationException
Constructs an arc from a center point, a from point, and a chord length.

Remarks

Please see the ConstructChordDistance method for more details.

-isCCW stands for "is counter clockwise"

-If IsMinor is true the central angle of the output Arc will be smaller or equal than PI (Approx. 3.14 Rad)

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructChordDistanceEx in interface IConstructCircularArc2
Parameters:
center - A reference to a com.esri.arcgis.geometry.IPoint (in)
from - A reference to a com.esri.arcgis.geometry.IPoint (in)
isCCW - The isCCW (in)
chordDistance - The chordDistance (in)
isMinor - The isMinor (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

constructTangentRadiusChordEx

public void constructTangentRadiusChordEx(ISegment segment,
                                          boolean atStart,
                                          boolean isCCW,
                                          double inRadius,
                                          double chordDistance,
                                          boolean isMinor)
                                   throws IOException,
                                          AutomationException
Constructs an arc with a common tangent to the input segment, a given radius and a chord length.

Remarks

Please see the ConstructTangentRadiusChord method for more details.

-isCCW stands for "is counter clockwise"

-If IsMinor is true the central angle of the output Arc will be smaller or equal than PI (Approx. 3.14 Rad)

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
constructTangentRadiusChordEx in interface IConstructCircularArc2
Parameters:
segment - A reference to a com.esri.arcgis.geometry.ISegment (in)
atStart - The atStart (in)
isCCW - The isCCW (in)
inRadius - The inRadius (in)
chordDistance - The chordDistance (in)
isMinor - The isMinor (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

queryNearestPoint

public void queryNearestPoint(IPoint p,
                              int extension,
                              IPoint nearest)
                       throws IOException,
                              AutomationException
Copies into 'nearest' a point on this geometry nearest to the input point.

Description

Queries the nearest point on a geometry to the input point. Depending on the method of segment extension, the nearest point can also be found on an extension of the geometry.

Remarks

QueryNearestPoint Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
queryNearestPoint in interface IProximityOperator
Parameters:
p - A reference to a com.esri.arcgis.geometry.IPoint (in)
extension - A com.esri.arcgis.geometry.esriSegmentExtension constant (in)
nearest - A reference to a com.esri.arcgis.geometry.IPoint (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
esriSegmentExtension, IProximityOperator.returnNearestPoint(com.esri.arcgis.geometry.IPoint, int)

returnNearestPoint

public IPoint returnNearestPoint(IPoint p,
                                 int extension)
                          throws IOException,
                                 AutomationException
Creates and returns a point on this geometry nearest to the input point.

Description

Finds and returns the nearest point on a geometry to the input point. Depending on the method of segment extension, the nearest point can also be found on an extension of the geometry.

Remarks

ReturnNearestPoint Example

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
returnNearestPoint in interface IProximityOperator
Parameters:
p - A reference to a com.esri.arcgis.geometry.IPoint (in)
extension - A com.esri.arcgis.geometry.esriSegmentExtension constant (in)
Returns:
A reference to a com.esri.arcgis.geometry.IPoint
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
esriSegmentExtension, IProximityOperator.queryNearestPoint(com.esri.arcgis.geometry.IPoint, int, com.esri.arcgis.geometry.IPoint)

returnDistance

public double returnDistance(IGeometry other)
                      throws IOException,
                             AutomationException
Returns the minimum distance between two geometries.

Description

Returns the minimum distance between two geometries. If the geometries intersect, the minimum distance is 0. Only returns the distance, and not the nearest points.

Remarks

ReturnDistance Example

The geometry combinations which can be used with ReturnDistance are:

Point: Point, MultiPoint, Envelope, Polyline, Polygon, Line, CircularArc, EllipticArc, BezierCurve.
Multipoint: Point, MultiPoint, Envelope, Polyline, Polygon.
Envelope: Point, MultiPoint, Envelope, Line, CircularArc, EllipticArc, BezierCurve, PolyLine, Polygon.
PolyLine: Point, Multipoint, Envelope, PolyLine, Polygon.
Polygon: Point, Multipoint, Envelope, PolyLine, Polygon.
Line: Point, Envelope, Line, CircularArc, EllipticArc, BezierCurve.
CircularArc: Point, Envelope, Line, CircularArc, EllipticArc (not implemented yet), BezierCurve.
EllipticArc: Point, Envelope, Line, CircularArc (not implemented yet), EllipticArc (not implemented yet), BezierCurve (not implemented yet).
BezierCurve: Point, Envelope, Line, CircularArc, EllipticArc (not implemented yet), BezierCurve.

Note: To get the distance between a segment (Line, CircularArc, EllipticArc, BezierCurve) and a MultiPoint, PolyLine or Polygon, add that segment to a PolyLine.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
returnDistance in interface IProximityOperator
Parameters:
other - A reference to a com.esri.arcgis.geometry.IGeometry (in)
Returns:
The distance
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

interfaceSupportsErrorInfo

public void interfaceSupportsErrorInfo(GUID riid)
                                throws IOException,
                                       AutomationException
interfaceSupportsErrorInfo

Description

Indicates whether the interface supports IErrorInfo.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
interfaceSupportsErrorInfo in interface ISupportErrorInfo
Parameters:
riid - A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

esri_clone

public IClone esri_clone()
                  throws IOException,
                         AutomationException
Clones the receiver and assigns the result to *clone.

Product Availability

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

Specified by:
esri_clone in interface IClone
Returns:
A reference to a com.esri.arcgis.system.IClone
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

assign

public void assign(IClone src)
            throws IOException,
                   AutomationException
Assigns the properties of src to the receiver.

Description

Use Assign method to assign the properties of source object to receiver object. Both objects need to have the same CLSIDs. Both source and receiver objects need to be instantiated.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
assign in interface IClone
Parameters:
src - A reference to a com.esri.arcgis.system.IClone (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isEqual

public boolean isEqual(IClone other)
                throws IOException,
                       AutomationException
Indicates if the receiver and other have the same properties.

Description

IsEqual returns True if the receiver and the source have the same properties. Note, this does not imply that the receiver and the source reference the same object.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
isEqual in interface IClone
Parameters:
other - A reference to a com.esri.arcgis.system.IClone (in)
Returns:
The equal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isIdentical

public boolean isIdentical(IClone other)
                    throws IOException,
                           AutomationException
Indicates if the receiver and other are the same object.

Description

IsIdentical returns true if the receiver and the source reference the same object.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
isIdentical in interface IClone
Parameters:
other - A reference to a com.esri.arcgis.system.IClone (in)
Returns:
The identical
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMs

public void getMs(double[] fromM,
                  double[] toM)
           throws IOException,
                  AutomationException
Get the Ms on the segment's endpoints.

Description

Returns the M attributes held by the From and To point of the segment.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getMs in interface ISegmentM
Parameters:
fromM - The fromM (out: use single element array)
toM - The toM (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setMs

public void setMs(double fromM,
                  double toM)
           throws IOException,
                  AutomationException
Set the Ms on the segment's endpoints.

Description

Sets the M attributes for the From and To points of the segment. These attributes can be set regardless of the attribute awareness of the segment.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setMs in interface ISegmentM
Parameters:
fromM - The fromM (in)
toM - The toM (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getZs

public void getZs(double[] fromZ,
                  double[] toZ)
           throws IOException,
                  AutomationException
Get the Zs on the segment's endpoints.

Description

Returns the Z attributes held by the From and To point of the segment.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getZs in interface ISegmentZ
Parameters:
fromZ - The fromZ (out: use single element array)
toZ - The toZ (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setZs

public void setZs(double fromZ,
                  double toZ)
           throws IOException,
                  AutomationException
Set the Zs on the segment's endpoints.

Description

Sets the Z attributes for the From and To points of the segment. These attributes can be set regardless of the attribute awareness of the segment.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setZs in interface ISegmentZ
Parameters:
fromZ - The fromZ (in)
toZ - The toZ (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getIDs

public void getIDs(int[] fromID,
                   int[] toID)
            throws IOException,
                   AutomationException
Get the IDs on the segment's endpoints.

Description

Returns the PointID attributes held by the From and To point of the segment.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getIDs in interface ISegmentID
Parameters:
fromID - The fromID (out: use single element array)
toID - The toID (out: use single element array)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setIDs

public void setIDs(int fromID,
                   int toID)
            throws IOException,
                   AutomationException
Set the IDs on the segment's endpoints.

Description

Sets the PointID attributes for the From and To points of the segment. These attributes can be set regardless of the attribute awareness of the segment.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setIDs in interface ISegmentID
Parameters:
fromID - The fromID (in)
toID - The toID (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.