Project

## bezier_curve

0.0
No commit activity in last 3 years
No release in over 3 years
A bézier curve library for Ruby, supporting n-dimensional, nth-degree curves
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
Popularity
Development
Primary Language
Ruby
MIT
Dependencies

~> 10.3
~> 0.10

# bezier_curve

A bézier curve library for Ruby, supporting n-dimensional, nth-degree curves

A rather simple and small library that should do pretty much anything you need to do with a bezier curve. It supports arbitrary numbers of dimensions, and arbitrary numbers of control points. Even still, it is pretty easy to use. Here's a simple quadratic (1st degree) bezier curve, in 2-dimensional space:

# create the curve
curve = BezierCurve.new([0,0],[0,1],[1,1])
# determine its points for drawing purposes
curve.points
[[0, 0], [0.00390625, 0.12109375], ... [0.87890625, 0.99609375], 1, 1]

When outputting points, it automatically chooses a suitable angle tolerance which would make the resulting poly-line appear relatively smooth (no angle changes more than about 3 degrees). But you can choose your own tolerance:

# Extreme precision, less than 1 degree tolerance
curve.points(tolerance: Math::PI/180)
# just give me 5 points, quick:
curve.points(count: 5)

You can easily split a curve into two, at a given value of t

# split the curve at its midpoint
curve.split_at(0.5)
#=> [BezierCurve([0, 0], [0.0, 0.5], [0.25, 0.75]), BezierCurve([0.25, 0.75], [0.5, 1.0], [1, 1])]

You can also specify n-dimensional curves:

# a 4-dimensional curve of 2nd order
curve = BezierCurve.new([0,0,0,0], [1,1,2,2], [4,5,9,3])
# get its points
curve.points(count:3)
#=> [[0.0, 0.0, 0.0, 0.0], [1.5, 1.75, 3.25, 1.75], [4.0, 5.0, 9.0, 3.0]]

You can also specify any degree/order of curve you like:

# 2d curve, 6th degree
curve = BezierCurve.new([0,0],[1,1],[2,-1],[3,1],[4,-1],[5,1],[6,-1])
curve.degree
#=> 6
curve.points.size
#=> 35

Note that the complexity goes up exponentially for higher degree curves, so performance may suffer if used extensively; but the capability is there if you need it. In fact, if you want, you can really slow things down and do a 18-dimensional curve of the 300th order. The sky is the limit. Well, your processor and memory are the limit, but you get the idea.

I am interested in making this the most useful ruby library for working with bezier curves. If you need help, or have a suggestion for improvement, feel free to file an issue on Github (https://github.com/marcuserronius/bezier_curve/), or contact me directly.