Part of #771 and #772. solid.sweep and surface.sweep take orientation (perpendicular, parallel or a direction), twist (up to 4 turns) and end scale (0.01 to 100), applied about the profile's normal through the path's start; default options run the old sweep, so existing sweeps are unchanged. New fields are optional, left out when unset and noted under format 21; twist and scale are model parameters. Both sweep dialogs get Orientation, Twist and End Scale rows; labels in every catalog. Checked on main + this branch: cargo check --workspace, kernel/engine/UI sweep tests, the doc suite and the robustness goldens.
117 lines
4.4 KiB
Rust
117 lines
4.4 KiB
Rust
//! The options Sweep and Surface Sweep share (#771): how the profile turns along the path, a
|
|
//! twist over the path's length and the profile's scale at the end.
|
|
|
|
use serde_json::{Value, json};
|
|
use solidcraft_engine::Sel;
|
|
use solidcraft_engine::doc::{Mat, SweepOrientation};
|
|
use solidcraft_engine::geom::Vec3;
|
|
|
|
use crate::SolveApp;
|
|
use crate::dialogs::{combo, field, row_label};
|
|
use crate::selection::{AXES, EDGES, SelInput};
|
|
|
|
/// The orientation choices, in combo order: perpendicular, parallel, a direction.
|
|
const ORIENTATIONS: [&str; 3] = ["Turn with Path", "Keep as Drawn", "Follow Direction"];
|
|
/// The orientation choice that takes a picked direction.
|
|
const DIRECTION: usize = 2;
|
|
/// A twist field that means no twist.
|
|
const NO_TWIST: &str = "0 deg";
|
|
/// An end scale field that means no scaling.
|
|
const NO_SCALE: &str = "1";
|
|
|
|
/// A sweep dialog's options.
|
|
#[derive(Clone, Debug, PartialEq)]
|
|
pub struct SweepOpts {
|
|
/// An index into [`ORIENTATIONS`].
|
|
pub orientation: usize,
|
|
pub twist: String,
|
|
pub scale: String,
|
|
/// A stored direction (world), used while no direction is picked.
|
|
pub direction: Option<Vec3>,
|
|
}
|
|
|
|
impl Default for SweepOpts {
|
|
fn default() -> Self {
|
|
SweepOpts { orientation: 0, twist: NO_TWIST.into(), scale: NO_SCALE.into(), direction: None }
|
|
}
|
|
}
|
|
|
|
impl SweepOpts {
|
|
/// A feature's stored options as dialog values; `frame` maps the feature's component frame to
|
|
/// the world (a stored direction is in the component's frame). A direction along an origin
|
|
/// axis comes back as a pick of that axis.
|
|
pub fn of(orientation: &SweepOrientation, twist: &Option<String>, scale: &Option<String>, frame: &Mat) -> (SweepOpts, Option<Sel>) {
|
|
let mut o = SweepOpts {
|
|
twist: twist.clone().unwrap_or_else(|| NO_TWIST.into()),
|
|
scale: scale.clone().unwrap_or_else(|| NO_SCALE.into()),
|
|
..SweepOpts::default()
|
|
};
|
|
let mut pick = None;
|
|
match orientation {
|
|
SweepOrientation::Perpendicular => {}
|
|
SweepOrientation::Parallel => o.orientation = 1,
|
|
SweepOrientation::Direction(d) => {
|
|
o.orientation = DIRECTION;
|
|
let world = solidcraft_engine::doc::apply_vector(frame, *d);
|
|
match world.normalized().and_then(world_axis) {
|
|
Some(name) => pick = Some(Sel::Axis { name: name.into() }),
|
|
None => o.direction = Some(world),
|
|
}
|
|
}
|
|
}
|
|
(o, pick)
|
|
}
|
|
}
|
|
|
|
/// The origin axis a direction runs along (its way), if any.
|
|
fn world_axis(d: Vec3) -> Option<&'static str> {
|
|
[("X", Vec3::X), ("Y", Vec3::Y), ("Z", Vec3::Z)].into_iter().find(|(_, a)| d.cross(*a).len() < 1e-9 && d.dot(*a) > 0.0).map(|(n, _)| n)
|
|
}
|
|
|
|
/// The input that picks a Follow Direction sweep's direction: an axis, a sketch line or a
|
|
/// straight edge.
|
|
pub fn direction_input() -> SelInput {
|
|
SelInput::new("Direction", AXES | EDGES, false)
|
|
}
|
|
|
|
/// The option rows; true when Enter was pressed in a field.
|
|
pub fn rows(ui: &mut egui::Ui, o: &mut SweepOpts, id: &str) -> bool {
|
|
let mut enter = false;
|
|
row_label(ui, "Orientation");
|
|
combo(ui, &format!("{id}_orient"), &ORIENTATIONS, &mut o.orientation);
|
|
ui.end_row();
|
|
row_label(ui, "Twist");
|
|
enter |= field(ui, &mut o.twist);
|
|
ui.end_row();
|
|
row_label(ui, "End Scale");
|
|
enter |= field(ui, &mut o.scale);
|
|
ui.end_row();
|
|
enter
|
|
}
|
|
|
|
/// The options as command parameters, added to `p`: the orientation, and the twist and end
|
|
/// scale when they change anything. `picked` is the direction input's selection.
|
|
pub fn params(app: &SolveApp, o: &SweepOpts, picked: Option<&Sel>, p: &mut Value) -> Result<(), String> {
|
|
match o.orientation {
|
|
0 => {}
|
|
1 => p["orientation"] = json!("parallel"),
|
|
_ => {
|
|
let d = match (picked, o.direction) {
|
|
(Some(x), _) => crate::dialogs::axis_of(app, x).ok_or("the direction must be an axis, a sketch line or a straight edge")?.1,
|
|
(None, Some(d)) => d,
|
|
(None, None) => return Err("select a direction (an axis, a sketch line or a straight edge) for the profile to follow".into()),
|
|
};
|
|
p["orientation"] = json!([d.x, d.y, d.z]);
|
|
}
|
|
}
|
|
let twist = o.twist.trim();
|
|
if !twist.is_empty() && twist != NO_TWIST {
|
|
p["twist"] = json!(twist);
|
|
}
|
|
let scale = o.scale.trim();
|
|
if !scale.is_empty() && scale != NO_SCALE {
|
|
p["scale"] = json!(scale);
|
|
}
|
|
Ok(())
|
|
}
|