Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mattatz/curvo
NURBS curve / surface modeling library for Rust.
https://github.com/mattatz/curvo
3d computer-graphics curve modeling nurbs rust surface
Last synced: about 2 hours ago
JSON representation
NURBS curve / surface modeling library for Rust.
- Host: GitHub
- URL: https://github.com/mattatz/curvo
- Owner: mattatz
- License: mit
- Created: 2024-04-18T13:26:17.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2024-09-12T06:41:16.000Z (21 days ago)
- Last Synced: 2024-09-13T13:09:34.750Z (20 days ago)
- Topics: 3d, computer-graphics, curve, modeling, nurbs, rust, surface
- Language: Rust
- Homepage:
- Size: 529 KB
- Stars: 68
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Curvo
[](https://github.com/mattatz/curvo#license)
[](https://crates.io/crates/curvo)
[](https://docs.rs/curvo/latest/curvo/)
[](https://github.com/mattatz/curvo/actions/workflows/test.yml)
Curvo is a NURBS curve / surface modeling library for Rust.
*Visualization on [Bevy](https://bevyengine.org/)*
This library enables not only the creation of NURBS curves from control points, knot vectors, and weights associated with each control point, but also supports generating curves that precisely pass through the given control points and creating periodic curves. Additionally, it allows for the construction of NURBS surfaces through operations such as _extruding_ and _lofting_ based on NURBS curves as inputs.
The modeling operations for NURBS surfaces supported by this library currently include the following:
- Extrude
- Loft
- Sweep
- Revolve
The supported features also include finding the closest point on NURBS curves, finding intersections between two NURBS curves, and dividing based on arc length.
## Additional features
## Usage
```rust
// Create a set of points to interpolate
let points = vec![
Point3::new(-1.0, -1.0, 0.),
Point3::new(1.0, -1.0, 0.),
Point3::new(1.0, 1.0, 0.),
Point3::new(-1.0, 1.0, 0.),
Point3::new(-1.0, 2.0, 0.),
Point3::new(1.0, 2.5, 0.),
];
// Create a NURBS curve that interpolates the given points with degree 3
// You can also specify the precision of the curve by generic type (f32 or f64)
let interpolated = NurbsCurve3D::::try_interpolate(&points, 3).unwrap();
// NURBS curve & surface can be transformed by nalgebra's matrix
let rotation = Rotation3::from_axis_angle(&Vector3::z_axis(), FRAC_PI_2);
let translation = Translation3::new(0., 0., 3.);
let transform_matrix = translation * rotation; // nalgebra::Isometry3
// Transform the curve by the given matrix (nalgebra::Isometry3 into nalgebra::Matrix4)
let offsetted = interpolated.transformed(&transform_matrix.into());
// Create a NURBS surface by lofting two NURBS curves
let lofted = NurbsSurface::try_loft(
&[interpolated, offsetted],
Some(3), // degree of v direction
).unwrap();
// Tessellate the surface in adaptive manner about curvature for efficient rendering
let option = AdaptiveTessellationOptions {
norm_tolerance: 1e-4,
..Default::default()
};
let tessellation = lofted.tessellate(Some(option));
```
## Dependencies
- [nalgebra](https://crates.io/crates/nalgebra): this library heavily relies on nalgebra, a linear algebra library, to perform its computations.
## References
- [The NURBS Book](https://www.amazon.com/NURBS-Book-Monographs-Visual-Communication/dp/3540615458) by Piegl and Tiller
## Feature development sponsored by VUILD Inc.
The **NURBS boolean operations** feature in this project was developed at the request of [VUILD](https://vuild.co.jp/).
They supported the development as a sponsor by funding the feature's implementation.