Crs.IntersectLineSegmentAndCircle Methods
Returns the points where a line segment intersects a circle.
Overload List
| Name | Description | |
|---|---|---|
| Public method | IntersectLineSegmentAndCircle(PointCollection line, LineType lineType, Point center, System.Double radius) | Returns the points where a line segment intersects a circle. |
| Public method | IntersectLineSegmentAndCircle(Point lineStart, Point lineEnd, LineType lineType, Point center, System.Double radius) | Returns the points where a line segment intersects a circle. |
| Public method | IntersectLineSegmentAndCircle(IEnumerable< Point > line, LineType lineType, Point center, System.Double radius) | Returns the points where a line segment intersects a circle. |
IntersectLineSegmentAndCircle(PointCollection line, LineType lineType, Point center, System.Double radius)
Returns the points where a line segment intersects a circle.Syntax
public PointCollection IntersectLineSegmentAndCircle (
PointCollection line,
LineType lineType,
Point center,
System.Double radius
)Parameters
A line segment, represented as a collection of exactly two points.
Specifies the kind of line line is.
The center of the circle, expressed in the Crs.
The radius of the circle, in meters.
Return Value
A collection of the points where the line segment intersects the circle.
Remarks
A line with exactly two points (expressed in the Crs) is given, together with its type (GreatCircle or RhumbLine). A circle is specified by its center (expressed in the Crs), and radius in meters. The returned list of points will contain the points where the line intersects the circle.
If the circle radius is greater than about 10 000 000 meters, so that the circle covers more than half the surface of the Earth, then the method can find a single intersection, but will fail to find the intersections if there are two.
Line type and accuracy
The line type may be RhumbLine or GreatCircle (the GreatCircleApprox is not implemented). The method throws an exception if the Projection is a NonGeoreferencedProjection. Otherwise, the points are unprojected to LongLat, the computation is done on the ellipsoid surface, and the intersection points are finally projected. Disregarding the errors that may be caused by UnprojectToLongLat and ProjectFromLongLat, the intersections are found with submillimeter accuracy. However, before the calculations are done, the line segment is extended by 2 millimeters at both ends. This should ensure that the method will not overlook a valid intersection that is very close to one end of the original segment, although it may report a spurious intersection that really occurs slightly beyond one end of the original segment. This slight overreporting of intersections is usually better than possibly overlooking a valid intersection.
Intersection angle and error propagation
The z value of each intersection point does not mean altitude: it is the angle of intersection in degrees, in the range 0° to 90°. A small intersection angle means that small errors in the radius or input coordinates can cause large errors in the intersection points. See IntersectLineSegments for details.
IntersectLineSegmentAndCircle(Point lineStart, Point lineEnd, LineType lineType, Point center, System.Double radius)
Returns the points where a line segment intersects a circle.Syntax
public PointCollection IntersectLineSegmentAndCircle (
Point lineStart,
Point lineEnd,
LineType lineType,
Point center,
System.Double radius
)Parameters
The start point of the line segment.
The end point of the line segment.
Specifies the kind of line segment.
The center of the circle, expressed in the Crs.
The radius of the circle, in meters.
Return Value
A collection of the points where the line segment intersects the circle.
Remarks
A line segment represented by two points (expressed in the Crs) is given, together with its type (GreatCircle or RhumbLine). A circle is specified by its center (expressed in the Crs), and radius in meters. The returned list of points will contain the points where the line intersects the circle.
If the circle radius is greater than about 10 000 000 meters, so that the circle covers more than half the surface of the Earth, then the method can find a single intersection, but will fail to find the intersections if there are two.
Line types
The line type may be RhumbLine or GreatCircle (the GreatCircleApprox is not implemented).
Accuracy
The method throws an exception if the Projection is a NonGeoreferencedProjection. Otherwise, the points are unprojected to LongLat, the computation is done on the ellipsoid surface, and the intersection points are finally projected. Disregarding the errors that may be caused by UnprojectToLongLat and ProjectFromLongLat, the intersections are found with submillimeter accuracy. However, before the calculations are done, the line segment is extended by 2 millimeters at both ends. This should ensure that the method will not overlook a valid intersection that is very close to one end of the original segment, although it may report a spurious intersection that really occurs slightly beyond one end of the original segment. This slight overreporting of intersections is usually better than possibly overlooking a valid intersection.
Intersection angle and error propagation
The z value of each intersection point does not mean altitude: it is the angle of intersection in degrees, in the range 0° to 90°. A small intersection angle means that small errors in the radius or input coordinates can cause large errors in the intersection points. See IntersectLineSegments for details.
IntersectLineSegmentAndCircle(IEnumerable< Point > line, LineType lineType, Point center, System.Double radius)
Returns the points where a line segment intersects a circle.Syntax
public PointCollection IntersectLineSegmentAndCircle (
IEnumerable< Point > line,
LineType lineType,
Point center,
System.Double radius
)Parameters
A line segment, represented as a collection of exactly two points.
The center of the circle, expressed in the Crs.
The radius of the circle, in meters.
Return Value
A collection of the points where the line segment intersects the circle.
Remarks
A line with exactly two points (expressed in the Crs) is given, together with its type (GreatCircle or RhumbLine). A circle is specified by its center (expressed in the Crs), and radius in meters. The returned list of points will contain the points where the line intersects the circle.
If the circle radius is greater than about 10 000 000 meters, so that the circle covers more than half the surface of the Earth, then the method can find a single intersection, but will fail to find the intersections if there are two.
Line type and accuracy
The line type may be RhumbLine or GreatCircle (the GreatCircleApprox is not implemented). The method throws an exception if the Projection is a NonGeoreferencedProjection. Otherwise, the points are unprojected to LongLat, the computation is done on the ellipsoid surface, and the intersection points are finally projected. Disregarding the errors that may be caused by UnprojectToLongLat and ProjectFromLongLat, the intersections are found with submillimeter accuracy. However, before the calculations are done, the line segment is extended by 2 millimeters at both ends. This should ensure that the method will not overlook a valid intersection that is very close to one end of the original segment, although it may report a spurious intersection that really occurs slightly beyond one end of the original segment. This slight overreporting of intersections is usually better than possibly overlooking a valid intersection.
Intersection angle and error propagation
The z value of each intersection point does not mean altitude: it is the angle of intersection in degrees, in the range 0° to 90°. A small intersection angle means that small errors in the radius or input coordinates can cause large errors in the intersection points. See IntersectLineSegments for details.
Platforms
Windows, Linux, Android