stroke

Crates.iostroke
lib.rsstroke
version0.2.0
sourcesrc
created_at2021-02-22 20:49:15.284696
updated_at2023-06-07 21:49:26.241651
descriptionA zero-allocation library providing const-generic implementations of Bézier curves, B-Spline curves and specialized implementations of up to cubic Bézier curves in N-dimensional euclidean space. It is intended for general/embedded/wasm use supporting #![no_std] environments written in 100% safe Rust.
homepage
repositoryhttps://github.com/dorianprill/stroke
max_upload_size
id359178
size132,157
(dorianprill)

documentation

README

stroke

Rust
A zero-allocation library providing const-generic implementations of Bézier curves, B-Spline curves and specialized implementations of up to cubic Bézier curves in N-dimensional euclidean space. It is intended for general/embedded/wasm use supporting #![no_std] environments written in 100% safe Rust with minimal dependencies.

The library makes heavy use of const-generics and some related unstabilized features, so the nightly compiler is required.
It comes with a const-generic N-dimensional Point type so you can use the library without any other dependencies.
Should you want to integrate with types provided by another library, you are able to do so by implementing the small Point trait that the library relies upon (given it makes no distinction between a point and its position vector).

A Cubic Bézier Curve with Bounding Box and Convex Hull rendered by plotters.rs

made with plotters.rs

Right now, the generic versions don't implement all methods that the specialized versions do (as the algorithms get a bit more complicated) but should reach parity eventually.

Goals

  • Provide generic Bézier curves and B-Splines. Due to their frequent usage, further provide lines, quadratic and cubic Bézier curves
  • Support no-std for all targets
  • Extensive unit testing and code coverage
  • Integration tests for other generic math libraries (TBD - maybe optimath, aljabar, micromath, nalgebra) since Point types are replicated in many libraries

Non-Goals

  • Focus on use for rendering or highest performance (no GPU)

Features

These are the main supported features. Some further utility methods are exposed where useful.

Quadratic and Cubic Bézier Curves

  • evaluation (De Casteljau, direct)
  • split
  • derivative
  • arc length (linear approx.)
  • arc length (Legendre-Gauss)
  • curvature/radius (Frenet-Serret Frame)
  • bounding box
  • tight box

Generic Bézier Curves

  • evaluation (De Casteljau)
  • split
  • derivative
  • arc length (linear approx.)
  • arc length (Legendre-Gauss)
  • curvature/radius (Frenet-Serret Frame)
  • bounding box
  • tight box

Generic B-Splines

  • evaluation (De Boor)
  • split
  • derivative
  • arc length (linear approx.)
  • arc length (Legendre-Gauss)
  • curvature/radius (Frenet-Serret Frame)
  • bounding box
  • tight box

Related

If you're looking for a published crate for rendering with gpu support you should check out Lyon from which I draw some inspiration, it's really good. It features lines, quadratic and cubic Béziers, in addition to arcs, triangles, and other geometric objects but no general Bézier curves or B-Splines. It also does seem to support wasm.

Also, there's Twinklebear/bspline which is a very clean and useful library for just bsplines. However, it depends on std and its simple Interpolate trait defines no way to access the individual dimensions of the points and hence implements no derivatives in the library.

This clear online book A Primer on Bézier Curves helped me with a lot of the algorithms involved.

Commit count: 132

cargo fmt