Merge pull request #1076 from hannobraun/builder

Add builder API for `Vertex

crates/fj-kernel/src/builder/edge.rs

@@ -18,7 +18,7 @@ impl HalfEdgeBuilder {
         Self { surface }
     }
 
-    /// Create a circle from the given radius
+    /// Build a circle from the given radius
     pub fn circle_from_radius(&self, radius: Scalar) -> HalfEdge {
         let curve = {
             let local = CurveKind::Circle(Circle::new(
@@ -68,7 +68,7 @@ impl HalfEdgeBuilder {
         HalfEdge::from_curve_and_vertices(curve, vertices)
     }
 
-    /// Create a line segment from two points
+    /// Build a line segment from two points
     pub fn line_segment_from_points(
         &self,
         points: [impl Into<Point<2>>; 2],

crates/fj-kernel/src/builder/mod.rs

@@ -7,6 +7,7 @@ mod face;
 mod shell;
 mod sketch;
 mod solid;
+mod vertex;
 
 pub use self::{
     curve::{CurveBuilder, GlobalCurveBuilder},
@@ -16,4 +17,5 @@ pub use self::{
     shell::ShellBuilder,
     sketch::SketchBuilder,
     solid::SolidBuilder,
+    vertex::VertexBuilder,
 };

crates/fj-kernel/src/builder/vertex.rs

@@ -0,0 +1,37 @@
+use fj_math::Point;
+
+use crate::objects::{Curve, GlobalVertex, SurfaceVertex, Vertex};
+
+/// API for building a [`Vertex`]
+pub struct VertexBuilder {
+    curve: Curve,
+}
+
+impl VertexBuilder {
+    /// Construct a new instance of `VertexBuilder`
+    ///
+    /// Also see [`Vertex::build`].
+    pub fn new(curve: Curve) -> Self {
+        Self { curve }
+    }
+
+    /// Build a vertex from a curve position
+    pub fn from_point(&self, point: impl Into<Point<1>>) -> Vertex {
+        let point = point.into();
+        let &surface = self.curve.surface();
+
+        let global_form = GlobalVertex::from_position(
+            self.curve
+                .global_form()
+                .kind()
+                .point_from_curve_coords(point),
+        );
+        let surface_form = SurfaceVertex::new(
+            self.curve.kind().point_from_curve_coords(point),
+            surface,
+            global_form,
+        );
+
+        Vertex::new([0.], self.curve, surface_form, global_form)
+    }
+}

crates/fj-kernel/src/objects/vertex.rs

@@ -1,6 +1,8 @@
 use fj_math::Point;
 use pretty_assertions::assert_eq;
 
+use crate::builder::VertexBuilder;
+
 use super::{Curve, Surface};
 
 /// A vertex
@@ -17,6 +19,11 @@ pub struct Vertex {
 }
 
 impl Vertex {
+    /// Build a vertex using [`VertexBuilder`]
+    pub fn build(curve: Curve) -> VertexBuilder {
+        VertexBuilder::new(curve)
+    }
+
     /// Construct an instance of `Vertex`
     ///
     /// Panics, if `curve` and `surface_form` are not defined on the same