Rust bindings providing a high-level API to SFCGAL library and conversion to / from other geometry crates from Rust ecosystem.
Based on the sfcgal-sys crate exposing low-level bindings.
Some of the key features of the underlying library: - Supports ISO 19107 and OGC Simple Features Access 1.2 for 3D operations. - Reads and writes WKT with exact rational number representation of coordinates for 2D and 3D geometries. - Intersection, difference and union. - Straight skeleton, tesselation, Minkovski sum and convex hull.
Example with 3-member tuples for 3d coordinates and WKT: ```rust extern crate sfcgal; use sfcgal::{SFCGeometry, CoordSeq, ToCoordinates, ToSFCGAL};
// create a linestring from WKT: let line_3d = SFCGeometry::new("LINESTRING(-0.5 -0.5 2.5, 0.0 0.0 4.0)")?;
// create a polygon as Vec of 3-member tuples... let coordspolygon = vec![ vec![ // Exterior ring (-1., -1., 3.0), (1., -1., 3.0), (1., 1., 3.0), (-1., 1., 3.0), (-1., -1., 3.0), ], vec![ // 1 interior ring (0.1, 0.1, 3.0), (0.1, 0.9, 3.0), (0.9, 0.9, 3.0), (0.9, 0.1, 3.0), (0.1, 0.1, 3.0), ], ]; // ...by using the CoordSeq enum variants to match the wanted SFCGAL geometry type // (returns a SFCGeometry) let polygon3d = CoordSeq::Polygon(coordspolygon).tosfcgal()?;
// ... let intersection = line3d.intersection3d(&polygon_3d)?;
// Retrieve coordinates of the resulting geometry as 3-member tuples: let coordsintersection: CoordSeq<(f64, f64, f64)> = intersection.tocoordinates()?;
println!("{:?} and {:?} intersects at {:?}", line3d, polygon3d, coords_intersection); ```
Example with geo-types: ```rust extern crate geo_types; extern crate sfcgal;
use geo_types::{LineString, Polygon}; use sfcgal::ToSFCGAL;
// create a geo_types Polygon: let polygon = Polygon::new( LineString::from(vec![(0., 0.), (1., 0.), (1., 1.), (0., 1.,), (0., 0.)]), vec![LineString::from( vec![(0.1, 0.1), (0.1, 0.9,), (0.9, 0.9), (0.9, 0.1), (0.1, 0.1)])]);
// create a geo_types LineString: let line = LineString::from(vec![(-0.5, -0.5), (1.3, 1.), (1.1, 1.9)]);
// convert them to sfcgal geometries: let polygsfc = polygon.tosfcgal().unwrap(); let linesfc = line.tosfcgal().unwrap();
// Use SFCGAL operations: assert!(polygsfc.intersects(&linesfc).unwrap(), true); ```
See examples/skeleton_geojson.rs for an example of working with some other crates from Rust-geo ecosystem.
Needed a SFCGAL feature for a side-project in Rust and I thought it would be a good opportunity to try using bindgen on SFCGAL C API.
In the end a large part of the API was wrapped so maybe it could be reused or improved by someone now it's published on crates.io.
Licensed under either of * Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0) * MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be dual licensed as above, without any additional terms or conditions.