cubic-bezier-spline 0.21.0

Approximate or interpolate a sequence of points into a sequence of c2-continuous, non-rational cubic Bézier curves.

Non-rational Bezier curves and splines (composite Bezier curves)

This package exists mostly to create C2-continuous, non-rational cubic Bezier splines. In other words, this will approximate or interpolate a sequence of points into a sequence of non-rational cubic Bezier curves.

Should be relatively fast, but this isn't suited for heavy math. This is for taking some points you have and making a nice-looking curve out of them. Specifically, a cubic Bezier spline, which is made from the type of curves used in SVG, fonts, and other vector-base programs. I am only interested in feature requests that directly apply to that purpose. This is not an exercise in completism.

install

pip install cubic_bezier_spline

this package will

• Evaluate, differentiate, elevate, and split non-rational Bezier curves of any degree
• Construct non-rational cubic Bezier splines (open and closed, approximating and interpolating)
• Evaluate and differentiate non-rational Bezier splines of any degree
• Approximate (closely) the length of a curve

this package will not **

• Work with rational Bezier splines, b-splines, NURBS, or any other generalization of Bezier curves
• Decrease curve degree
• Approximate curve intersections
• "Stroke" (move left or right) a curve
  

** much of the "will not" features can be found here: https://github.com/dhermes/bezier

Public classes / functions

# a c2-continuous cubic Bezier spline near the control points
new_open_approximating_spline([(x0, y0), (x1, y1), ...])

# a c2-continuous cubic Bezier spline near the control points
new_closed_approximating_spline([(x0, y0), (x1, y1), ...])

# a c2-continuous cubic Bezier spline through the control points
new_open_interpolating_spline([(x0, y0), (x1, y1), ...])

# a c2-continuous cubic Bezier spline through the control points
new_closed_interpolating_spline([(x0, y0), (x1, y1), ...])

Any of these will return a BezierSpline object. This object has a some of the usual methods (e.g., elevate, derivative, split) to help find path normals or do some light modeling, but you may be most interested in.

# plot the spline at a given point, where time is 0 to
# (number of input points + 1)
def __call__(self,
    time: float,
    derivative: int = 0,
    *,
    normalized: bool | None = None,
    uniform: bool | None = None,
) -> npt.NDArray[np.floating[Any]]:
    """Given x.y, call curve x at time y.

    :param time: x.y -> curve index x and time on curve y
        between 0 and len(curves)
    :param derivative: optional derivative at time
    :param normalized: if True (default False), time is in [0, 1]
        instead of [0, len(curves)]
    :param uniform: if True (default), treat all curves as equal in length,
        else longer curves will take up more of the time interval.
    :return: xth non-rational Bezier at time

    For a spline with 3 curves, spline(3) will return curve 2 at time=1
    """

# an svg data string
# (the d="" attribute of an SVG path object)
spline.svgd

Examples

Some of these use double and triple repeated points to create "knots". This isn't a special function, just a feature of Bezier math. The idea is clearer with a picture.

Most of the math can be found in:

• A Primer on Bezier Curves
  https://pomax.github.io/bezierinfo/
• UCLS-Math-149-Mathematics-of-Computer-Graphics-lecture-notes
  https://www.stkent.com/assets/pdfs/UCLA-Math-149-Mathematics-of-Computer-Graphics-lecture-notes.pdf