Class Lengthen3

Namespace: GeometryHelper.Core

Assembly: GeometryHelper.dll

Provides static methods that change how long a line segment is while keeping it on the line that carries it: lengthening or shortening it by a distance, extending an end out to a boundary, trimming an end back to one, and trimming or extending two segments until they meet in a corner.

This is the 3D counterpart of Lengthen2 and follows the same rules. Every method that moves one end takes a LineEnd; the other end never moves, and the segment never reverses. TryExtendTo only ever lengthens, TryTrimTo only ever shortens, and an end already on the boundary satisfies both, so TryExtendTo(...) || TryTrimTo(...) fits an end to a boundary from either side the way Tekla Structures fits a part end to a plane.

A boundary is met where the infinite line carrying the segment reaches it. A plane is met where the line pierces it. A polygon, face or solid is met where the line pierces its surface; a line lying in the plane of a polygon or face meets it at its edges instead, and one running parallel beside it never does. Another segment is met only where the line passes within the point tolerance of it: two lines in space usually pass each other, and then there is no crossing to extend to. A point is met at the foot of the perpendicular from it.

public static class Lengthen3

Inheritance: object

Lengthen3

Inherited Members: object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Remarks

Only a segment could be extended or trimmed, which left the one case a reinforcing schedule asks about every day — lengthening a bar's end leg for anchorage — with no answer but rebuilding the chain by hand.

An arc is extended along itself: the radius and the centre stay, the sweep grows, and the distance asked for is arc length and not chord. That is exact, and it is the only reading that leaves the curve where it was. A whole turn is the limit, so an extension that would pass it is refused rather than wrapped.

A chain is extended by its end leg, along that leg: a straight leg carries on straight, a curved one carries on round, keeping its radius. Every other leg is untouched, so the bends and their radii survive. A chain is extended outwards only; shortening one belongs to the cutting family, which keeps the bends, and TryTrimTo below is that cut with the end named rather than the piece.

Methods

Extend(GeoArc3, double, LineEnd): Lengthens an arc along itself at one end.

Extend(GeoArc3, double, LineEnd, Tolerance): Lengthens an arc along itself at one end, within a tolerance.

Extend(GeoArc3, double, double): Lengthens an arc along itself at both ends at once.

Extend(GeoArc3, double, double, Tolerance): Lengthens an arc along itself at both ends at once, within a tolerance.

Extend(GeoLine3, double, LineEnd): Lengthens one end of a segment by a distance, using the default tolerance. A negative distance shortens it.

Extend(GeoLine3, double, LineEnd, Tolerance): Lengthens one end of a segment by a distance, within a tolerance. A negative distance shortens it.

Extend(GeoLine3, double, double): Lengthens both ends of a segment, each by its own distance, using the default tolerance. A negative distance shortens that end. This is the end offset Tekla Structures applies along a beam's axis.

Extend(GeoLine3, double, double, Tolerance): Lengthens both ends of a segment, each by its own distance, within a tolerance. A negative distance shortens that end.

Extend(GeoPolyline3, double, LineEnd): Lengthens a chain along its end leg.

Extend(GeoPolyline3, double, LineEnd, Tolerance): Lengthens a chain along its end leg, within a tolerance.

Extend(GeoPolylineArc3, double, LineEnd): Lengthens a curved chain along its end leg, round if that leg curves.

Extend(GeoPolylineArc3, double, LineEnd, Tolerance): Lengthens a curved chain along its end leg, round if that leg curves, within a tolerance.

ExtendToLength(GeoArc3, double, LineEnd): Lengthens or shortens an arc at one end until it is a given arc length.

ExtendToLength(GeoArc3, double, LineEnd, Tolerance): Lengthens or shortens an arc at one end until it is a given arc length, within a tolerance.

ExtendToLength(GeoLine3, double, LineEnd): Moves one end of a segment so that the segment measures a given length, using the default tolerance. The other end stays, so a length shorter than the segment trims it.

ExtendToLength(GeoLine3, double, LineEnd, Tolerance): Moves one end of a segment so that the segment measures a given length, within a tolerance. The other end stays, so a length shorter than the segment trims it.

ExtendToLength(GeoPolyline3, double, LineEnd): Lengthens a chain along its end leg until the whole chain is a given length.

ExtendToLength(GeoPolyline3, double, LineEnd, Tolerance): Lengthens a chain along its end leg until the whole chain is a given length, within a tolerance.

ExtendToLength(GeoPolylineArc3, double, LineEnd): Lengthens a curved chain along its end leg until the whole chain is a given length.

ExtendToLength(GeoPolylineArc3, double, LineEnd, Tolerance): Lengthens a curved chain along its end leg until the whole chain is a given length, within a tolerance.

TryExtendTo(GeoArc3, GeoPoint3, LineEnd, out GeoArc3): Lengthens an arc at one end until it reaches a point on its circle.

TryExtendTo(GeoArc3, GeoPoint3, LineEnd, out GeoArc3, Tolerance): Lengthens an arc at one end until it reaches a point on its circle, within a tolerance.

TryExtendTo(GeoLine3, GeoFace3, LineEnd, out GeoLine3): Extends one end of a segment until it meets a face, using the default tolerance.

TryExtendTo(GeoLine3, GeoFace3, LineEnd, out GeoLine3, Tolerance): Extends one end of a segment until it meets a face, within a tolerance: where it pierces the material, so a line through a hole passes on, or at an edge of the boundary or of a hole when the segment lies in the plane of the face.

TryExtendTo(GeoLine3, GeoLine3, LineEnd, out GeoLine3): Extends one end of a segment until it meets another segment, using the default tolerance.

TryExtendTo(GeoLine3, GeoLine3, LineEnd, out GeoLine3, Tolerance): Extends one end of a segment until it meets another segment, within a tolerance.

TryExtendTo(GeoLine3, GeoPlane3, LineEnd, out GeoLine3): Extends one end of a segment until it pierces a plane, using the default tolerance.

TryExtendTo(GeoLine3, GeoPlane3, LineEnd, out GeoLine3, Tolerance): Extends one end of a segment until it pierces a plane, within a tolerance.

TryExtendTo(GeoLine3, GeoPoint3, LineEnd, out GeoLine3): Extends one end of a segment to the foot of the perpendicular from a point, using the default tolerance.

TryExtendTo(GeoLine3, GeoPoint3, LineEnd, out GeoLine3, Tolerance): Extends one end of a segment to the foot of the perpendicular from a point, within a tolerance.

TryExtendTo(GeoLine3, GeoPolygon3, LineEnd, out GeoLine3): Extends one end of a segment until it meets a polygon, using the default tolerance.

TryExtendTo(GeoLine3, GeoPolygon3, LineEnd, out GeoLine3, Tolerance): Extends one end of a segment until it meets a polygon, within a tolerance: where it pierces the surface, or at an edge when the segment lies in the plane of the polygon.

TryExtendTo(GeoLine3, GeoSolid3, LineEnd, out GeoLine3): Extends one end of a segment until it meets the surface of a solid, using the default tolerance.

TryExtendTo(GeoLine3, GeoSolid3, LineEnd, out GeoLine3, Tolerance): Extends one end of a segment until it meets the surface of a solid, within a tolerance. An end outside runs in to the face it first reaches; an end inside runs out to where the line leaves.

TryTrimExtendToCorner(GeoLine3, GeoLine3, out GeoLine3, out GeoLine3): Trims or extends two segments so that they meet in a corner, using the default tolerance.

TryTrimExtendToCorner(GeoLine3, GeoLine3, out GeoLine3, out GeoLine3, Tolerance): Trims or extends two segments so that they meet in a corner, within a tolerance.

TryTrimTo(GeoArc3, GeoPoint3, LineEnd, out GeoArc3): Shortens an arc at one end back to a point on it.

TryTrimTo(GeoArc3, GeoPoint3, LineEnd, out GeoArc3, Tolerance): Shortens an arc at one end back to a point on it, within a tolerance.

TryTrimTo(GeoLine3, GeoFace3, LineEnd, out GeoLine3): Trims one end of a segment back to the nearest place it meets a face, using the default tolerance.

TryTrimTo(GeoLine3, GeoFace3, LineEnd, out GeoLine3, Tolerance): Trims one end of a segment back to the nearest place it meets a face, within a tolerance.

TryTrimTo(GeoLine3, GeoLine3, LineEnd, out GeoLine3): Trims one end of a segment back to where another segment crosses it, using the default tolerance.

TryTrimTo(GeoLine3, GeoLine3, LineEnd, out GeoLine3, Tolerance): Trims one end of a segment back to where another segment crosses it, within a tolerance.

TryTrimTo(GeoLine3, GeoPlane3, LineEnd, out GeoLine3): Trims one end of a segment back to where it pierces a plane, using the default tolerance.

TryTrimTo(GeoLine3, GeoPlane3, LineEnd, out GeoLine3, Tolerance): Trims one end of a segment back to where it pierces a plane, within a tolerance.

TryTrimTo(GeoLine3, GeoPoint3, LineEnd, out GeoLine3): Trims one end of a segment back to the foot of the perpendicular from a point, using the default tolerance.

TryTrimTo(GeoLine3, GeoPoint3, LineEnd, out GeoLine3, Tolerance): Trims one end of a segment back to the foot of the perpendicular from a point, within a tolerance.

TryTrimTo(GeoLine3, GeoPolygon3, LineEnd, out GeoLine3): Trims one end of a segment back to the nearest place it meets a polygon, using the default tolerance.

TryTrimTo(GeoLine3, GeoPolygon3, LineEnd, out GeoLine3, Tolerance): Trims one end of a segment back to the nearest place it meets a polygon, within a tolerance.

TryTrimTo(GeoLine3, GeoSolid3, LineEnd, out GeoLine3): Trims one end of a segment back to the nearest place it meets the surface of a solid, using the default tolerance.

TryTrimTo(GeoLine3, GeoSolid3, LineEnd, out GeoLine3, Tolerance): Trims one end of a segment back to the nearest place it meets the surface of a solid, within a tolerance. A segment running out of a body is cut where it leaves it.

TryTrimTo(GeoPolyline3, GeoPoint3, LineEnd, out GeoPolyline3): Shortens a chain at one end back to a point on it.

TryTrimTo(GeoPolyline3, GeoPoint3, LineEnd, out GeoPolyline3, Tolerance): Shortens a chain at one end back to a point on it, within a tolerance.

TryTrimTo(GeoPolylineArc3, GeoPoint3, LineEnd, out GeoPolylineArc3): Shortens a curved chain at one end back to a point on it.

TryTrimTo(GeoPolylineArc3, GeoPoint3, LineEnd, out GeoPolylineArc3, Tolerance): Shortens a curved chain at one end back to a point on it, within a tolerance.

Table of Contents

Class Lengthen3

Remarks

Methods