A QuadraticSpline2d is a quadratic Bézier curve
in 2D defined by a start point, control point and end point. This module
contains functionality for
Construct a spline from its start point, inner control point and end point:
exampleSpline =
QuadraticSpline2d.fromControlPoints
(Point2d.meters 1 1)
(Point2d.meters 3 4)
(Point2d.meters 5 1)Get the start point of a spline. Equal to firstControlPoint.
Get the first control point of a spline. Equal to startPoint.
Get the second control point of a spline.
Get the third and last control point of a spline. Equal to endPoint.
Get the end point of a spline. Equal to thirdControlPoint.
Get the start derivative of a spline. This is equal to twice the vector from the spline's first control point to its second.
QuadraticSpline2d.startDerivative exampleSpline
--> Vector2d.meters 4 6Get the end derivative of a spline. This is equal to twice the vector from the spline's second control point to its third.
QuadraticSpline2d.endDerivative exampleSpline
--> Vector2d.meters 4 -6Compute a bounding box for a given spline. It is not guaranteed that the result will be the smallest possible bounding box, since for efficiency the bounding box is computed from the spline's control points (which cover a larger area than the spline itself).
QuadraticSpline2d.boundingBox exampleSpline
--> BoundingBox2d.fromExtrema
--> { minX = Length.meters 1
--> , maxX = Length.meters 5
--> , minY = Length.meters 1
--> , maxY = Length.meters 4
--> }Get the point along a spline at a given parameter value.
Represents a nondegenerate spline (one that has finite, non-zero length).
Attempt to construct a nondegenerate spline from a general
QuadraticSpline2d. If the spline is in fact degenerate (consists of a single
point), returns an Err with that point.
Convert a nondegenerate spline back to a general QuadraticSpline2d.
Get the tangent direction to a nondegenerate spline at a given parameter value.
Get both the point and tangent direction of a nondegenerate spline at a given parameter value.
Convert a spline from one units type to another, by providing a conversion factor given as a rate of change of destination units with respect to source units.
Convert a spline from one units type to another, by providing an 'inverse' conversion factor given as a rate of change of source units with respect to destination units.
These transformations generally behave just like the ones in the Point2d
module.
Reverse a spline so that the start point becomes the end point, and vice versa.
Scale a spline about the given center point by the given scale.
Rotate a spline counterclockwise around a given center point by a given angle.
Translate a spline by a given displacement.
Translate a spline in a given direction by a given distance.
Mirror a spline across an axis.
Take a spline defined in global coordinates, and return it expressed in local coordinates relative to a given reference frame.
Take a spline considered to be defined in local coordinates relative to a given reference frame, and return that spline expressed in global coordinates.
Split a spline into two roughly equal halves. Equivalent to
QuadraticSpline2d.splitAt 0.5.
Split a spline at a particular parameter value, resulting in two smaller splines.
A spline that has been parameterized by arc length.
Build an arc length parameterization of the given spline, with a given accuracy.
Find the total arc length of a spline, to within the accuracy specified
when calling arcLengthParameterized.
For the following evaluation functions, the given arc length will be clamped to the arc length of the spline, so the result will always be on the spline.
Get the point along a spline at a given arc length.
Get the midpoint of a spline. Note that this is the point half way along the spline by arc length, which is not in general the same as evaluating at a parameter value of 0.5.
Get the tangent direction along a spline at a given arc length.
Get the point and tangent direction along a spline at a given arc length.
An ArcLengthParameterized value is a combination of an
ArcLengthParameterization and an
underlying QuadraticSpline2d. If you need to do something fancy, you can
extract these two values separately.
Get the original QuadraticSpline2d from which an ArcLengthParameterized
value was constructed.
You are unlikely to need to use these functions directly, but they are useful if you are writing low-level geometric algorithms.
Get the first derivative of a spline at a given parameter value. Note that the derivative interpolates linearly from end to end.
Get the second derivative of a spline (for a quadratic spline, this is a constant).