SolidCraft: an open-source parametric 3D CAD application built in pure Rust. Desktop, web, and automation through MCP.
Extrude: document which way a positive taper goes (#4098) (#4115)
raykholo59795872f6e8
diff --git a/crates/engine/src/cmd/features.rs b/crates/engine/src/cmd/features.rsindex 2755e2419c..7688f1690f 100644--- a/crates/engine/src/cmd/features.rs+++ b/crates/engine/src/cmd/features.rs@@ -25,7 +25,7 @@ pub static COMMANDS: &[CommandSpec] = &[.key("E").contract(&EXTRUDE_CONTRACT).output(output_schema_for::<FeatureResult>)- .params("distance: expr (or through_all: true); taper?: angle expr; sketch?: id|name (default: active or last sketch); profiles?: all | [index] | [{curves: [ids]}] (the profile whose outer loop is made of exactly these curves, or pieces of them; found again on every recompute, so it follows parameter changes; islands inside are its holes; an error when no profile or several match) | [{point:[x,y]}] (index and point picks are stored by their curves when that finds the same profile); default: every drawn profile, except that a loop inside another is its hole and a loop inside that hole is material again; face?: [x,y,z] (extrude a planar body face instead of a sketch profile); faces?: [[x,y,z],…] (coplanar faces of one body); face_body?: name (whose face, where faces of several bodies meet at the point); direction?: positive|negative|symmetric (distance is total thickness, split evenly around the start plane); convention?: total_distance|legacy_per_side (default total_distance; legacy preserves older symmetric extents); distance2?: expr (Two Sides: a second distance the other way from the first side, which may be through_all or to; with direction: negative the first side goes against the normal and distance2 along it); start_offset?: expr (along the sketch normal, also with direction: negative); to?: [x,y,z] (To Object: a face, vertex or point; to_offset?: expr past it); from?: [x,y,z] (From Object: start at that face or point); operation?: new|join|cut|intersect|auto (cut into a body, otherwise join existing solids; new in an empty component); targets?: [body] (Join from a face, or from a sketch on a body's face, defaults to that face's body; explicit targets or participants override); name?; body_name?; thin?: true (Thin: a wall along sketch curves instead of the profiles) with curves?: [curve ids] (open chains and closed loops, joined where they meet end to end; default: every drawn curve of the sketch), thickness: expr, side?: center|inside|outside|two_sides (a closed loop's inside is the area it encloses, an open chain's the side it bends toward, a straight line's the left of its first curve as drawn; default center), thickness2?: expr (two_sides: the thickness outside); corners are mitred, crossing walls are one"),+ .params("distance: expr (or through_all: true); taper?: angle expr (positive: outward, so the far end is larger along the extrusion direction; negative: inward, so the far end is smaller); sketch?: id|name (default: active or last sketch); profiles?: all | [index] | [{curves: [ids]}] (the profile whose outer loop is made of exactly these curves, or pieces of them; found again on every recompute, so it follows parameter changes; islands inside are its holes; an error when no profile or several match) | [{point:[x,y]}] (index and point picks are stored by their curves when that finds the same profile); default: every drawn profile, except that a loop inside another is its hole and a loop inside that hole is material again; face?: [x,y,z] (extrude a planar body face instead of a sketch profile); faces?: [[x,y,z],…] (coplanar faces of one body); face_body?: name (whose face, where faces of several bodies meet at the point); direction?: positive|negative|symmetric (distance is total thickness, split evenly around the start plane); convention?: total_distance|legacy_per_side (default total_distance; legacy preserves older symmetric extents); distance2?: expr (Two Sides: a second distance the other way from the first side, which may be through_all or to; with direction: negative the first side goes against the normal and distance2 along it); start_offset?: expr (along the sketch normal, also with direction: negative); to?: [x,y,z] (To Object: a face, vertex or point; to_offset?: expr past it); from?: [x,y,z] (From Object: start at that face or point); operation?: new|join|cut|intersect|auto (cut into a body, otherwise join existing solids; new in an empty component); targets?: [body] (Join from a face, or from a sketch on a body's face, defaults to that face's body; explicit targets or participants override); name?; body_name?; thin?: true (Thin: a wall along sketch curves instead of the profiles) with curves?: [curve ids] (open chains and closed loops, joined where they meet end to end; default: every drawn curve of the sketch), thickness: expr, side?: center|inside|outside|two_sides (a closed loop's inside is the area it encloses, an open chain's the side it bends toward, a straight line's the left of its first curve as drawn; default center), thickness2?: expr (two_sides: the thickness outside); corners are mitred, crossing walls are one"),CommandSpec::new("solid.revolve", "Revolve", revolve).at("SOLID", "CREATE").icon("revolve")diff --git a/crates/engine/src/schema/features.rs b/crates/engine/src/schema/features.rsindex 32f89bcda2..5ae99b310b 100644--- a/crates/engine/src/schema/features.rs+++ b/crates/engine/src/schema/features.rs@@ -93,7 +93,8 @@ pub struct ExtrudeParams {/// `"through_all"`, the same as `through_all: true`.#[serde(default)]pub extent: Option<ExtentKeyword>,- /// Draft angle of the side walls.+ /// Draft angle of the side walls (positive: outward, so the far end is larger along the+ /// extrusion direction; negative: inward, so the far end is smaller).#[serde(default)]pub taper: Option<AngleExpr>,/// Which way to extrude. Default: positive.diff --git a/crates/engine/src/tests.rs b/crates/engine/src/tests.rsindex 51bd5252c2..90996ef876 100644--- a/crates/engine/src/tests.rs+++ b/crates/engine/src/tests.rs@@ -3890,6 +3890,32 @@ fn a_pattern_of_a_reduced_fillet_rounds_each_copy_alike() {assert!(rel(volume(&mut s), expect) < 2e-4, "{} vs {expect}", volume(&mut s));}+#[test]+fn extrude_taper_help_explains_both_signs() {+ let mut s = Session::default();+ let help = run(&mut s, "engine.describe", json!({"command": "solid.extrude"}));+ for text in [help["params"].as_str().unwrap(), help["input"]["properties"]["taper"]["description"].as_str().unwrap()] {+ assert!(text.contains("positive: outward") && text.contains("negative: inward"), "{text}");+ }+}++#[test]+fn extrude_taper_sign_sets_far_face_size() {+ for angle in [5.0_f64, -5.0] {+ let mut s = Session::default();+ run(&mut s, "sketch.create", json!({"plane": "XY"}));+ run(&mut s, "sketch.rectangle.two_point", json!({"p0": [0, 0], "p1": [10, 10]}));+ run(&mut s, "sketch.finish", json!({}));+ run(&mut s, "solid.extrude", json!({"distance": 10, "taper": format!("{angle} deg"), "body_name": "Tapered"}));+ let faces = run(&mut s, "model.faces", json!({"body": "Tapered"}));+ let far = faces["faces"].as_array().unwrap().iter().find(|f| (f["centroid"][2].as_f64().unwrap() - 10.0).abs() < 1e-6).unwrap();+ let width = 10.0 + 20.0 * angle.to_radians().tan();+ let area = far["area"].as_f64().unwrap();+ assert!((area - width * width).abs() < 1e-6, "{angle} deg: {far}");+ assert_eq!(area > 100.0, angle > 0.0);+ }+}+/// A taper on a profile of lines and an arc (#546). The D profile (back 9.2, sides 7.4, a/// half-round front R 4.6 tangent to them) grows by d = z · tan 5° with mitred corners:/// A(d) = A₀ + P·d + (2 + π/2)·d², integrated over the 10 mm height.diff --git a/docs/book/src/guide/features.md b/docs/book/src/guide/features.mdindex 1521f9f358..b08d0fc6c3 100644--- a/docs/book/src/guide/features.md+++ b/docs/book/src/guide/features.md@@ -30,6 +30,12 @@ start or end offsets or a From Object input, the target also sets the stored disone-sided direction, so returning to **Distance** keeps that reach. Thin Extrude keeps itsexisting picks. With the setting off, picks only add profiles, as before.+A positive extrude taper slopes the side walls outward, so the profile grows along the+extrusion direction and the far end is larger; a negative taper slopes them inward, making+the far end smaller. For example, a 10 × 10 mm square extruded 10 mm with `taper: "5 deg"`+has an approximately 11.75 × 11.75 mm far face; with `taper: "-5 deg"`, it is approximately+8.25 × 8.25 mm.+A taper slopes the sides of any profile, sketch text included: lines, arcs and spline or coniccurves move in or out together, and a flat tip shorter than the taper closes to a point. Onspline and conic sides the slope is approximate: the moved outline is a curve of the same kind