9c65a30265
`cargo xtask kernel-cases [--ladder] --export DIR` runs the rig with the kernel's operations traced (`smlib::trace`) and writes one entry per case: the operation, or chain of operations, that made the bodies the case ends with; each operand that came in as a record, as that record; the parameters, with every pick by points also given as the topology index it picked; the fix set; the case's expected values and the rig's result. A case no kernel operation alone accounts for is written too, marked not expressible with its reasons. DIR/manifest.json counts them per area. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01DtL5M41G8Nua7HvuFPZkmJ
629 lines
27 KiB
Rust
629 lines
27 KiB
Rust
//! The solidcore backend: one kernel for the process (SMLib's context is process-global too, and
|
|
//! some of its state, such as the fillet solver's latched step, lives for the whole process),
|
|
//! every call under its lock and a panic guard.
|
|
//!
|
|
//! Upstream fixes ([`fixes`]) are solidcore's opt-in corrections of SMLib defects that the C++
|
|
//! fork fixed in its own sources; each one turned on here says which fork commit it matches.
|
|
|
|
use std::panic::{AssertUnwindSafe, catch_unwind};
|
|
use std::sync::{Mutex, PoisonError};
|
|
|
|
use solidcore::geom::attribute::{AttributeStore, ObjectKey};
|
|
use solidcore::geom::vector3d::Vec3;
|
|
use solidcore::kernel::{Kernel, KernelOptions, UpstreamFixes};
|
|
use solidcore::mass::integrator::properties::{PropertyAttributes, brep_volume};
|
|
use solidcore::primitive::api_primitives as primitives;
|
|
|
|
use crate::{Error, Result};
|
|
|
|
pub(crate) mod blend;
|
|
#[cfg(test)]
|
|
mod blend_tests;
|
|
pub(crate) mod boolean;
|
|
#[cfg(test)]
|
|
mod boolean_tests;
|
|
mod convert;
|
|
#[cfg(test)]
|
|
mod convert_tests;
|
|
pub(crate) mod dump;
|
|
pub(crate) mod file;
|
|
pub(crate) mod history;
|
|
mod measure;
|
|
#[cfg(test)]
|
|
mod measure_tests;
|
|
pub(crate) mod merge;
|
|
#[cfg(test)]
|
|
mod merge_tests;
|
|
pub(crate) mod offset;
|
|
#[cfg(test)]
|
|
mod offset_tests;
|
|
pub(crate) mod picked;
|
|
pub(crate) mod split;
|
|
#[cfg(test)]
|
|
mod split_tests;
|
|
pub(crate) mod ssi;
|
|
pub(crate) mod sweep;
|
|
#[cfg(test)]
|
|
mod sweep_tests;
|
|
pub(crate) mod transform;
|
|
#[cfg(test)]
|
|
mod transform_tests;
|
|
pub(crate) mod trim;
|
|
#[cfg(test)]
|
|
mod trim_tests;
|
|
|
|
pub(crate) use convert::{from_arrays, to_arrays};
|
|
pub(crate) use measure::{area, bounds, check, classify_point, edge_face_distance, is_manifold_solid, mass_properties, solid_count};
|
|
|
|
/// A solidcore body. Its own lock: solidcore's operations take `&mut Brep`, even to measure.
|
|
pub(crate) struct Body(pub(crate) Mutex<solidcore::topology::Brep>);
|
|
|
|
impl Body {
|
|
pub(crate) fn new(b: solidcore::topology::Brep) -> Body {
|
|
Body(Mutex::new(b))
|
|
}
|
|
}
|
|
|
|
/// The fixes this backend runs with: every one of solidcore's opt-in fixes of upstream SMLib
|
|
/// defects (`UpstreamFixes`, each naming its record and issue), whether or not the C++ fork has it,
|
|
/// unless it appears broken. A test checks none is left off but those in `HELD_BACK`, so moving the
|
|
/// solidcore pin to a rev with a new flag fails until it is added here.
|
|
pub(crate) fn fixes() -> UpstreamFixes {
|
|
let mut f = UpstreamFixes::default();
|
|
f.fillet_retry_radius_as_first = true;
|
|
f.fillet_rail_rim_on_face = true;
|
|
f.fillet_refuse_rails_leaving_faces = true;
|
|
f.fillet_refuse_face_consuming_blends = true;
|
|
f.fillet_refuse_non_manifold_result = true;
|
|
f.fillet_vertex_error_diagnostics = true;
|
|
f.fillet_corner_ball_patch = true;
|
|
f.fillet_chamfer_cone_on_arc = true;
|
|
f.fillet_torus_center_on_axis = true;
|
|
f.offset_excess_faces_after_merge = true;
|
|
f.offset_clip_right_side_out = true;
|
|
f.revolution_offset_axis_both_sides = true;
|
|
f.offset_extended_edges_mated = true;
|
|
f.remove_slit_loops_where_solids_touch = true;
|
|
f.keep_operand_uv_trims = true;
|
|
f.proto_vertex_miss_is_false = true;
|
|
f.check_loop_vertex_tolerance = true;
|
|
f.check_loop_projected_seam_ends = true;
|
|
f.trim_boundary_seam_wrap = true;
|
|
f.bspline_check_min_radius = true;
|
|
f.oscillating_skips_failed_guesses = true;
|
|
f.refine_cc_range_ends = true;
|
|
f.flat_corners_test_bits = true;
|
|
f.cylinder_rebuild_mean_radius = true;
|
|
f.planar_path_uncapped_open_profiles = true;
|
|
f.revolve_analytic_profile_faces = true;
|
|
f.revolve_arc_centre_near_axis_is_sphere = true;
|
|
f.taper_pivot_nearest_corner = true;
|
|
f.taper_tangent_corner_planes = true;
|
|
f.revolve_nested_shells_as_cavities = true;
|
|
f.revolve_holed_profile_void = true;
|
|
f.curve_sweep_caps_at_sweep_ends = true;
|
|
f.join_touching_loops = true;
|
|
f.uv_trim_reversal_on_surface = true;
|
|
f.offset_resolve_crossing_loops = true;
|
|
f.offset_walls_touch_refused = true;
|
|
f.offset_analytic_mate_edges = true;
|
|
f.precise_properties_split_at_surface_knots = true;
|
|
f.nurb_cylinder_inside_out_frame = true;
|
|
f.shell_inner_shell_of_statuses = true;
|
|
f.local_operation_offset_status = true;
|
|
f.local_operation_refuses_loose_tangent_edges = true;
|
|
f.torus_major_radius_from_origin = true;
|
|
f.fillet_corner_sphere_from_four_arcs = true;
|
|
f.fillet_nx1_opposite_continuation_side_edge = true;
|
|
f.fillet_trace_rejects_short_step = true;
|
|
f.torus_iso_circle_axis_from_midpoint = true;
|
|
f.torus_keeps_inside_out = true;
|
|
f.internal_pole_row_through_knot = true;
|
|
f.extrusion_origin_scaled_zero = true;
|
|
f.transform_scales_each_tolerance = true;
|
|
f.transform_model_size_from_body_box = true;
|
|
f.offset_collapsed_rounds_mated = true;
|
|
f.offset_missing_surface_fails = true;
|
|
f.fillet_nx1_end_rib_global_merge = true;
|
|
f.uv_trim_corner_end_points_only = true;
|
|
f.bspline_trim_preserves_uv_spans = true;
|
|
f.cone_parallel_line_midpoint = true;
|
|
f.cone_parallel_line_domains = true;
|
|
f.proto_edge_self_loop_on_vertex_degenerate = true;
|
|
f.slice_coincident_faces_sheet_side = true;
|
|
f.boolean_outer_shell_first = true;
|
|
f.edge_reversal_keeps_failed_edge = true;
|
|
f.topology_failed_evaluations_propagate = true;
|
|
f.heal_stage3_failures_propagate = true;
|
|
f.sweep_frame_on_planar_path_normal = true;
|
|
f.cover_refuses_folded_continuation = true;
|
|
f.boolean_vertex_by_best_crossing = true;
|
|
f.boolean_cleanup_removes_slits = true;
|
|
f.classify_edge_interval = true;
|
|
f.ellipse_trim_seam_lines_span_cone_height = true;
|
|
f.degenerate_proto_edge_in_one_vertex = true;
|
|
f.new_edge_vertex_tolerance_covers_gap = true;
|
|
f.torus_signed_gen_curve_interval = true;
|
|
f.sheet_sweep_joins_profile_wires = true;
|
|
f.point_solve_keeps_triangle_guess = true;
|
|
f.fillet_setback_from_start_vertex = true;
|
|
f.imprint_trims_edge_to_proto_vertex = true;
|
|
f.imprint_extends_edge_to_proto_vertex = true;
|
|
f.fillet_point_step_per_point = true;
|
|
f.analytic_copy_keeps_parameterization = true;
|
|
f.fillet_point_bigger_step_retry = true;
|
|
f.fillet_through_extended_rail_end = true;
|
|
f.precise_properties_body_length_scale = true;
|
|
f.offset_extension_from_base = true;
|
|
f.corner_blend_stays_inside_neighbours = true;
|
|
f.fillet_cleanup_keeps_target_faces = true;
|
|
f.fillet_nx1_tangent_side_edge = true;
|
|
f.fillet_3x2_mixed_concave_side_edge = true;
|
|
f.offset_closed_curve_trim_arc = true;
|
|
f.offset_stitch_at_body_tolerance = true;
|
|
f.curve_contacts_at_curve_ends = true;
|
|
f.shell_empty_cavity_fails = true;
|
|
f.fillet_refuse_ball_not_fitting = true;
|
|
f.boolean_lists_virtual_surface_copies = true;
|
|
f.sphere_small_circle_not_touching = true;
|
|
f.ssi_tangent_contact_points = true;
|
|
f.ssi_trace_tangent_curves_once = true;
|
|
f.ssi_singular_start_inside_direction = true;
|
|
f.found_torus_sphere_keep_tested_nurb = true;
|
|
f.boolean_skips_faces_apart = true;
|
|
f.uv_trim_checks_on_surface = true;
|
|
f.loop_orientation_floor_from_loop_box = true;
|
|
f.offset_extends_cones_as_themselves = true;
|
|
f.local_operation_box_holds_new_surfaces = true;
|
|
f.uv_trim_joins_drop_pieces = true;
|
|
f.shell_edges_on_analytics_exact = true;
|
|
f.ssi_no_reverse_of_empty_trace = true;
|
|
f.ssi_pole_point_keeps_its_tangent = true;
|
|
f.iso_curve_sliver_domain_is_degenerate = true;
|
|
f.corner_blend_coons_patch_tangent_to_sides = true;
|
|
f.fillet_patch_keeps_fillet_edges = true;
|
|
f.fillet_corner_ball_center_from_axes = true;
|
|
f.seam_point_solutions_are_one = true;
|
|
f.boolean2d_plane_covers_far_faces = true;
|
|
f.brep_area_between_solid_and_void = true;
|
|
f.boolean_splits_definition_across_split = true;
|
|
f.curve_tight_box_interval_knots = true;
|
|
f.fillet_refuse_overlapping_bands = true;
|
|
f.ssi_tangent_curve_tracer = true;
|
|
f.torus_check_reads_v_interval = true;
|
|
f.torus_check_spindle_apex = true;
|
|
f.local_operation_step_walls = true;
|
|
f.edge_check_orders_tangent_faces = true;
|
|
f.revolve_arc_touching_axis_is_horn_torus = true;
|
|
f.thicken_planar_side_walls = true;
|
|
f.fillet_torus_span_from_start_section = true;
|
|
f.fillet_knife_edge_rounds = true;
|
|
f.taper_wall_closes_at_apex = true;
|
|
f.revolution_round_offset_collapses = true;
|
|
f.fillet_chamfer_cone_stored_as_cone = true;
|
|
f.offset_point_vertex_caps = true;
|
|
f.approximate_surface_bezier_starter = true;
|
|
f.proto_edge_splits_at_captured_vertices = true;
|
|
f.stitch_solid_nests_cavities = true;
|
|
f.local_operation_closes_walls_to_nothing = true;
|
|
f.linear_sweep_arc_to_cylinder_zero = true;
|
|
f.imprint_reuses_coincident_face_edge = true;
|
|
f.boolean_new_face_closure_both_sides = true;
|
|
f.linear_sweep_arc_is_cylinder = true;
|
|
f.offset_closes_loop_gaps = true;
|
|
f.cylinder_plane_tangent_within_tolerance = true;
|
|
f.boolean_wire_edge_keeps_faceuse_shell = true;
|
|
f.fillet_nx1_tangent_corner_edge = true;
|
|
f.fillet_torus_rail_on_axis = true;
|
|
f.loops_go_on_round_the_vertex = true;
|
|
f.revolve_splits_curves_on_axis = true;
|
|
f.cover_wraps_across_closed_seam = true;
|
|
f.imprint_extension_keeps_analytic_curve = true;
|
|
f.fillet_trace_from_tangent_point_toward_next = true;
|
|
f.fillet_tangent_point_one_sided_step = true;
|
|
f.fillet_rails_meet_at_one_end_point = true;
|
|
f.fillet_trace_reaches_rails = true;
|
|
f.delete_vertex_joins_seam_iso_curve = true;
|
|
f.box_face_failures_propagate = true;
|
|
f.ellipse_adjust_step_interval_keeps_turns = true;
|
|
f.fillet_cleanup_removes_input_slits = true;
|
|
f.fillet_rail_end_on_continued_surface = true;
|
|
f.glue_vertices_joins_every_region = true;
|
|
f.fillet_nx1_tangent_side_edge_same_convexity = true;
|
|
f.fillet_removal_takes_ring_fillets = true;
|
|
// The fork's commits that reached `SMLIB_REV` at eaa998a (tangency-labs/smlib#68, #69, #70).
|
|
f.fillet_trim_inside_by_best_dot = true;
|
|
f.fillet_half_degree_crease = true;
|
|
f.fillet_split_edge_keeps_near_half = true;
|
|
f.curve_loop_normal_from_area = true;
|
|
// The fork's commits in `SMLIB_REV` 2fc375f, ported to solidcore since.
|
|
f.fillet_cliff_overflow = true;
|
|
f.fillet_3x2_tangent_side_edge_roles = true;
|
|
f.offset_extension_as_itself = true;
|
|
f.fillet_mitre_concave_face_corners = true;
|
|
f.fillet_mitre_gap_patch = true;
|
|
f.fillet_run_on_past_far_end_only = true;
|
|
f.good_drop_result_distances_in_order = true;
|
|
f.face_tight_box_searches_trim = true;
|
|
f.ssi_low_angle_start_on_probation = true;
|
|
f.fillet_variable_span_follows_fillet = true;
|
|
f.simple_coincidence_crossing_is_point = true;
|
|
f.boolean_temporary_transform_statuses = true;
|
|
f.primitive_path_curve_statuses = true;
|
|
f.planar_path_sweep_statuses = true;
|
|
f.planar_path_profile_placement_statuses = true;
|
|
f.fillet_trim_status = true;
|
|
f.perspective_sphere_offsets = true;
|
|
f.plane_recognition_origin_after_axes = true;
|
|
f.fillet_corner_face_curve_halves = true;
|
|
f.brep_edit_statuses_pass_on = true;
|
|
f.fillet_run_on_bspline_trims = true;
|
|
f.offset_tangent_gap_statuses = true;
|
|
f.ssi_alignment_statuses = true;
|
|
f.fillet_corner_statuses = true;
|
|
f.fillet_edge_curve_domain_statuses = true;
|
|
f.query_statuses_pass_on = true;
|
|
f.sweep_statuses_pass_on = true;
|
|
f.ssi_proto_topology_statuses_pass_on = true;
|
|
f.analytic_inversion_answers_apart = true;
|
|
f.fillet_statuses_pass_on = true;
|
|
f.fillet_corner_per_vertex_fan = true;
|
|
f.fillet_rail_trim_at_near_knot = true;
|
|
f.offset_splits_corner_vertices = true;
|
|
f.offset_keep_cavity_regions = true;
|
|
f.offset_four_face_vertex_split = true;
|
|
f.gap_samples_non_bspline_v_stride = true;
|
|
f.gap_array_append_updates_longest = true;
|
|
f.imprint_skips_collapsed_definition = true;
|
|
f.precise_properties_trim_base_v = true;
|
|
f.fillet_blend_curve_revolved_on_arc = true;
|
|
f.temporary_radius_setup_errors = true;
|
|
f.ellipse_step_interval_checks = true;
|
|
f.corner_patch_face_side_twist = true;
|
|
f.boolean_union_refuses_solid_leak = true;
|
|
f.curve_loop_start_after_previous_end = true;
|
|
f.loop_use_reports_open_gaps = true;
|
|
f.face_points_span_domain = true;
|
|
f.drop_curve_v_domain_degeneracy = true;
|
|
f.mirror_curve_keeps_euclidean_control_points = true;
|
|
f.fillet_corner_variable_radius_rail_on_opposite_fillet = true;
|
|
f.sphere_from_arcs_common_centre = true;
|
|
f.dupin_bottom_hyperbola_axis = true;
|
|
f.extent3d_contains_both_segment_endpoints = true;
|
|
f.translation_sweep_regularize = true;
|
|
f.gap_samples_use_trimmed_spans = true;
|
|
f.twist_simple_duw_sign = true;
|
|
f.offset_swap_uv_extended_distance = true;
|
|
f.circumscribe_axis_map_by_basis = true;
|
|
f.planar_path_profile_in_path_frame = true;
|
|
f.validation_does_not_make_uv_trims = true;
|
|
f.iso_curve_uv_line_both_params = true;
|
|
f.extrusion_step_uses_clamped_uv = true;
|
|
f.analytic_corner_failure_is_false = true;
|
|
f.defeature_refuses_open_base = true;
|
|
f.ssi_start_loop_trace_budget = true;
|
|
f.fillet_refuse_crossing_rails = true;
|
|
f.proto_edge_split_upper_keeps_the_old_max = true;
|
|
f.point_on_start_point_squared_tolerance = true;
|
|
f.bspline_trim_keeps_rational_end_spans = true;
|
|
f.fillet_exact_round_classes = true;
|
|
f.curve_check_zero_speed_tangent_end = true;
|
|
f.cpoly_remove_poly_face_check_member = true;
|
|
f.check_seam_crossing_unclosed = true;
|
|
f.ascii_doubles_round_trip = true;
|
|
f.transform_aligned_bbox_image = true;
|
|
f.bspline_simple_offset_matches_parameterization = true;
|
|
f.offset_edges_keep_source_tolerance = true;
|
|
f.best_fit_line_largest_scatter_eigenvector = true;
|
|
f.circle_silhouette_perspective_center = true;
|
|
f.ellipse_convert_to_2d_uses_both_axes = true;
|
|
f.circle_offset_antiparallel_normal = true;
|
|
f.masked_array_uses_bit_shift = true;
|
|
f.global_solver_identical_prefers_larger_when_maximizing = true;
|
|
f.surface_continuity_checks_last_v_knot = true;
|
|
f.surface_point_solver_propagates_bbox_failure = true;
|
|
f.volume_lift_third_derivative_terms = true;
|
|
f.volume_discontinuity_checks_vw_unaligned = true;
|
|
f.periodic_extent_add_empty_interval = true;
|
|
f.stop_tracking_checks_own_callback = true;
|
|
f.plane_reparameterize_moves_origin = true;
|
|
f.crv_in_volume_mults_by_break_index = true;
|
|
f.curve_bounded_surface_read_uv_type_and_implicit_outer = true;
|
|
f.polar_box_region_to_arc_transposes_domain = true;
|
|
f.point_set_centroid_all_blocks = true;
|
|
f.local_solve1d_unbounded_newton_step = true;
|
|
f.composite_curve_bbox_segment_intervals = true;
|
|
f.knot_vector_valid_requires_span = true;
|
|
f.projected_curve_transform_when_owned = true;
|
|
f.curve_property_gs_branch_bounds = true;
|
|
f.volume_representational_end_continuities = true;
|
|
f.integrator_propagates_failure = true;
|
|
f.precise_properties_span_end_from_below = true;
|
|
f.offset_open_edge_second_trim_point = true;
|
|
f.close_loop_relates_only_coincident_edges = true;
|
|
f.ssi_split_curves_at_singular_points = true;
|
|
f.surface_parallel_to_vector_checks = true;
|
|
f.fillet_round_ends_at_tangent_continuation = true;
|
|
f.geometric_g2_continuity = true;
|
|
f.hash_table_grow_preserves_removed_records = true;
|
|
f.bend_volume_bbox_contains_wide_angle_and_inf_u = true;
|
|
f.bend_volume_trim_param_box_across_period = true;
|
|
f.point_set_tight_pbox_projects_points = true;
|
|
f.degen_param_tiebreak_uses_actual_param = true;
|
|
f.conic_evaluate_uses_computed_second_deriv = true;
|
|
f.cylinder_plane_section_trims_exact = true;
|
|
f.local_surface_intersect_guards_max_boundary_retry = true;
|
|
f.curve_max_distance_single_sample_midpoint = true;
|
|
f.curve_sweep_closed_path_joins_ends = true;
|
|
f.validate_tolerances_fixes_reported_gaps = true;
|
|
f.edgeuse_convexity_propagates_step_off_failure = true;
|
|
f.mark_lock_pair_advances_and_locks_second_context = true;
|
|
f.is_iso_curve_at_propagates_canonical_failure = true;
|
|
f.database_io_byte_swaps_read_boolean_and_u16 = true;
|
|
f.is_point_on_curve_propagates_eval_failure = true;
|
|
f.is_topological_vertex_rejects_cusps_and_tangent_errors = true;
|
|
f.cone_create_canonical_preserves_inside_out_and_checks_height = true;
|
|
f.point_class_gap_3d_propagates_no_drop_error = true;
|
|
f.fillet_surface_plane_curve_on_plane_equation = true;
|
|
f.fillet_gn_section_generator = true;
|
|
f.face_trim_curves_kept_where_exact = true;
|
|
f.swap_uv_keeps_analytic_definition = true;
|
|
f.face_shrink_bound_on_knot = true;
|
|
f.offset_updates_result_tolerances = true;
|
|
f.cone_iso_circle_at_axial_height = true;
|
|
f.boolean_coincident_strip_drops_crossing = true;
|
|
f.fillet_overflow_trim_at_creases = true;
|
|
f.fillet_section_end_trim_at_creases = true;
|
|
f.fillet_refuse_mixed_corner_crossing_rails = true;
|
|
f.fillet_keep_features = true;
|
|
f.fillet_blend_corner = true;
|
|
f.fillet_exact_arc_sections = true;
|
|
f.fillet_exact_arc_spans = true;
|
|
// Held back: see `HELD_BACK`.
|
|
f.fillet_refuse_rounds_breaking_through = false;
|
|
f.cone_unbounded_parameterized_as_nurb = true;
|
|
f.ellipse_open_arc_keeps_end_angle = true;
|
|
f.fillet_round_as_definition = true;
|
|
f.fillet_round_on_round_as_definition = true;
|
|
f.fillet_overflow_crease_along_edge = true;
|
|
f.plane_first_torus_section_exact = true;
|
|
f.keep_exact_pcurves = true;
|
|
f.shell_one_construction = true;
|
|
f
|
|
}
|
|
|
|
/// The fixes held off, each with the case and the numbers that show it broken: a volume or topology
|
|
/// wrong against the analytic value, a check failure, a crash, sound geometry refused that builds
|
|
/// without the flag, or a large slowdown. Differing from the C++ kernel is no such evidence: a fix
|
|
/// the fork doesn't have stays on, and where solidcore builds what SMLib refuses, a result right
|
|
/// against its closed form is a win.
|
|
///
|
|
/// `fillet_refuse_rounds_breaking_through` (WR-707, solidcore#2311): sound geometry refused. With it
|
|
/// on, 11 rig cases that pass with it off, each graded against its closed form or invariants, are
|
|
/// refused as breaking through the part (190-fillet-disc-rim-past-its-2mm-wall fails status 1001
|
|
/// instead): every-hole-top-rim-r12-past-plate-bottom, 1080-chamfer-runs-into-openings-cut-by-them
|
|
/// (3350, its closed form), 1080-fillet-notched-block-top-outline-r8,
|
|
/// 324-fillet-over-hole-cut-by-overlong-cylinder, 324-fillet-over-hole-overlap,
|
|
/// 5158-fillet-adjacent-plate-edges-as-thick-as-plate and the sloped and equal-slope basin rims of
|
|
/// #1080 and #5835. A fix under the same flag is in progress on solidcore.
|
|
#[cfg(test)]
|
|
const HELD_BACK: &[&str] = &["fillet_refuse_rounds_breaking_through"];
|
|
|
|
fn fresh() -> Kernel {
|
|
let mut k = Kernel::new(&KernelOptions::default());
|
|
k.fixes = fixes();
|
|
k
|
|
}
|
|
|
|
pub(crate) static KERNEL: Mutex<Option<Kernel>> = Mutex::new(None);
|
|
|
|
/// Runs `f` on the process's kernel. A panic in solidcore is caught: the kernel, which it may have
|
|
/// left half-updated, is replaced by a fresh one and the call fails with [`Error::Internal`].
|
|
pub(crate) fn run<T: dump::Answer>(call: &'static str, f: impl FnOnce(&mut Kernel) -> std::result::Result<T, solidcore::SolidError>) -> Result<T> {
|
|
run_on(call, &[], f)
|
|
}
|
|
|
|
thread_local! {
|
|
/// How many solidcore calls this thread is inside: a panic now is caught ([`run_on`]).
|
|
static IN_CALL: std::cell::Cell<u32> = const { std::cell::Cell::new(0) };
|
|
}
|
|
|
|
/// Is this thread inside a solidcore call, whose panic [`run_on`] catches? (Crash reports mark such
|
|
/// a panic recovered.)
|
|
pub(crate) fn in_call() -> bool {
|
|
IN_CALL.with(std::cell::Cell::get) > 0
|
|
}
|
|
|
|
/// [`run`] for a call that reads the bodies `inputs`: should it fail while a dump folder is set,
|
|
/// they are left there ([`dump::failed`]).
|
|
pub(crate) fn run_on<T: dump::Answer>(
|
|
call: &'static str,
|
|
inputs: dump::Inputs<'_>,
|
|
f: impl FnOnce(&mut Kernel) -> std::result::Result<T, solidcore::SolidError>,
|
|
) -> Result<T> {
|
|
let mut guard = KERNEL.lock().unwrap_or_else(PoisonError::into_inner);
|
|
let k = guard.get_or_insert_with(fresh);
|
|
// A profiler span per call: where the kernel's time goes.
|
|
let _span = solidcraft_profile::span("solidcore", call);
|
|
dump::set_current(Some(call));
|
|
struct Depth;
|
|
impl Drop for Depth {
|
|
fn drop(&mut self) {
|
|
IN_CALL.with(|d| d.set(d.get().saturating_sub(1)));
|
|
}
|
|
}
|
|
IN_CALL.with(|d| d.set(d.get() + 1));
|
|
let depth = Depth;
|
|
let caught = catch_unwind(AssertUnwindSafe(|| f(k)));
|
|
drop(depth);
|
|
let r = match caught {
|
|
Ok(Ok(v)) => Ok(v),
|
|
Ok(Err(e)) => Err(Error::Solidcore(format!("{call}: {e}"))),
|
|
Err(p) => {
|
|
*guard = Some(fresh());
|
|
let why = p.downcast_ref::<&str>().map(|s| (*s).to_owned()).or_else(|| p.downcast_ref::<String>().cloned()).unwrap_or_default();
|
|
log::warn!(target: "smlib", "solidcore panicked in {call}: {why}");
|
|
Err(Error::Internal(format!("{call}: {why}")))
|
|
}
|
|
};
|
|
dump::set_current(None);
|
|
let why = match &r {
|
|
Ok(v) => v.refusal(),
|
|
Err(e) => Some(e.to_string()),
|
|
};
|
|
if let Some(why) = why {
|
|
// The kernel the call ran on, or the fresh one that replaced it after a panic.
|
|
dump::failed(guard.get_or_insert_with(fresh), call, &why, inputs);
|
|
}
|
|
r
|
|
}
|
|
|
|
/// A call the capi checks for `SM_SUCCESS`, treating any other status as no answer: an error
|
|
/// that stands for an SMLib status exactly ([`SolidError::sm_status`](solidcore::SolidError::sm_status),
|
|
/// solidcore#1452) is `None`. Every other solidcore error
|
|
/// (unported code, invalid input to an adapter, a missing record...) is not a status the C++
|
|
/// path returns, so it fails the call instead of hiding as a skipped entity.
|
|
pub(crate) fn answer<T>(r: std::result::Result<T, solidcore::SolidError>) -> std::result::Result<Option<T>, solidcore::SolidError> {
|
|
match r {
|
|
Ok(v) => Ok(Some(v)),
|
|
Err(e) if e.sm_status().is_some() => Ok(None),
|
|
Err(e) => Err(e),
|
|
}
|
|
}
|
|
|
|
/// Runs `f` on the kernel and `body`, locking the kernel first.
|
|
pub(crate) fn with_body<T: dump::Answer>(
|
|
call: &'static str,
|
|
body: &Body,
|
|
f: impl FnOnce(&mut Kernel, &mut solidcore::topology::Brep) -> std::result::Result<T, solidcore::SolidError>,
|
|
) -> Result<T> {
|
|
// A body a panic interrupted may be half-edited: it is never used again.
|
|
if body.0.is_poisoned() {
|
|
return Err(Error::Internal(format!("{call}: the body was left unfinished by an earlier panic")));
|
|
}
|
|
run_on(call, &[("brep", body)], |k| f(k, &mut body.0.lock().unwrap_or_else(PoisonError::into_inner)))
|
|
}
|
|
|
|
/// An axis-aligned box from its lower corner (`SmApiCreateBox`, as `smlib_make_box` checks it:
|
|
/// every edge length positive).
|
|
pub(crate) fn make_box(origin: [f64; 3], size: [f64; 3]) -> Result<Body> {
|
|
if !origin.iter().chain(&size).all(|x| x.is_finite()) || !size.iter().all(|&s| s > 0.0) {
|
|
return Err(Error::Argument);
|
|
}
|
|
let [x, y, z] = size;
|
|
run("create_box", |k| primitives::create_box(k, Vec3::new(origin[0], origin[1], origin[2]), x, y, z)).map(Body::new)
|
|
}
|
|
|
|
fn point(p: [f64; 3]) -> Result<Vec3> {
|
|
if !p.iter().all(|x| x.is_finite()) {
|
|
return Err(Error::Argument);
|
|
}
|
|
Ok(Vec3::new(p[0], p[1], p[2]))
|
|
}
|
|
|
|
/// A cylinder about +Z from its base centre (`SmApiCreateCylinder`, as `smlib_make_cylinder`
|
|
/// checks it: radius and height positive).
|
|
pub(crate) fn make_cylinder(origin: [f64; 3], radius: f64, height: f64) -> Result<Body> {
|
|
let o = point(origin)?;
|
|
if !(radius > 0.0 && height > 0.0 && radius.is_finite() && height.is_finite()) {
|
|
return Err(Error::Argument);
|
|
}
|
|
run("create_cylinder", |k| primitives::create_cylinder(k, o, radius, height)).map(Body::new)
|
|
}
|
|
|
|
/// A sphere (`SmApiCreateSphere`; radius positive).
|
|
pub(crate) fn make_sphere(center: [f64; 3], radius: f64) -> Result<Body> {
|
|
let o = point(center)?;
|
|
if !(radius > 0.0 && radius.is_finite()) {
|
|
return Err(Error::Argument);
|
|
}
|
|
run("create_sphere", |k| primitives::create_sphere(k, o, radius)).map(Body::new)
|
|
}
|
|
|
|
/// A cone or frustum about +Z (`SmApiCreateCone`; `smlib_make_cone`'s checks: base radius and
|
|
/// height positive, top radius at least 0 and not the base radius).
|
|
pub(crate) fn make_cone(origin: [f64; 3], base_radius: f64, top_radius: f64, height: f64) -> Result<Body> {
|
|
let o = point(origin)?;
|
|
let ok = base_radius > 0.0 && top_radius >= 0.0 && height > 0.0 && top_radius != base_radius;
|
|
if !(ok && base_radius.is_finite() && top_radius.is_finite() && height.is_finite()) {
|
|
return Err(Error::Argument);
|
|
}
|
|
run("create_cone", |k| primitives::create_cone(k, o, base_radius, top_radius, height)).map(Body::new)
|
|
}
|
|
|
|
/// A ring torus about +Z (`SmApiCreateTorus`; major radius > minor radius > 0).
|
|
pub(crate) fn make_torus(center: [f64; 3], major_radius: f64, minor_radius: f64) -> Result<Body> {
|
|
let o = point(center)?;
|
|
if !(minor_radius > 0.0 && minor_radius < major_radius && major_radius.is_finite()) {
|
|
return Err(Error::Argument);
|
|
}
|
|
run("create_torus", |k| primitives::create_torus(k, o, major_radius, minor_radius)).map(Body::new)
|
|
}
|
|
|
|
/// The enclosed volume (`SmApiBrepComputeVolume`), its accuracy clamped as [`mass_properties`]
|
|
/// clamps it.
|
|
pub(crate) fn volume(body: &Body, relative_accuracy: f64) -> Result<f64> {
|
|
let relative_accuracy = measure::accuracy(relative_accuracy)?;
|
|
with_body("brep_volume", body, |k, b| {
|
|
let store = AttributeStore::default();
|
|
let attrs = PropertyAttributes { store: &store, key_of: &|_| ObjectKey(0) };
|
|
brep_volume(k, b, relative_accuracy, &attrs)
|
|
})
|
|
}
|
|
|
|
/// Face, edge and vertex counts.
|
|
pub(crate) fn counts(body: &Body) -> Result<[usize; 3]> {
|
|
with_body("counts", body, |_, b| Ok([b.face_list().len(), b.edge_list().len(), b.vertex_list().len()]))
|
|
}
|
|
|
|
#[cfg(test)]
|
|
mod tests {
|
|
use super::*;
|
|
|
|
#[test]
|
|
fn every_upstream_fix_is_on_unless_shown_broken() {
|
|
let f = fixes();
|
|
let flags: Vec<(&str, bool)> = f.flags().collect();
|
|
let off: Vec<&str> = flags.iter().filter(|(name, on)| !on && !HELD_BACK.contains(name)).map(|(name, _)| *name).collect();
|
|
assert!(off.is_empty(), "UpstreamFixes flags are off: {off:?}");
|
|
for name in HELD_BACK {
|
|
assert!(flags.contains(&(*name, false)), "{name} is on or gone: drop it from HELD_BACK");
|
|
}
|
|
}
|
|
|
|
#[test]
|
|
fn a_box_measures_exactly() {
|
|
let b = make_box([1.0, -2.0, 3.0], [10.0, 20.0, 30.0]).unwrap();
|
|
assert_eq!(counts(&b).unwrap(), [6, 12, 8]);
|
|
let v = volume(&b, 1e-8).unwrap();
|
|
assert!((v - 6000.0).abs() < 6000.0 * 1e-9, "{v}");
|
|
}
|
|
|
|
/// An accuracy finer than 1e-8 or not positive is 1e-8, as `mass_properties` takes it: a
|
|
/// sphere's volume at 0, -1 and 1e-15 is its volume at 1e-8, on its closed form.
|
|
#[test]
|
|
fn a_volume_accuracy_out_of_range_is_clamped() {
|
|
let ball = make_sphere([1.0, 2.0, 3.0], 5.0).unwrap();
|
|
let at = volume(&ball, 1e-8).unwrap();
|
|
assert!((at - 4.0 / 3.0 * std::f64::consts::PI * 125.0).abs() < 1e-6, "{at}");
|
|
for acc in [0.0, -1.0, 1e-15] {
|
|
assert_eq!(volume(&ball, acc).ok(), Some(at), "accuracy {acc}");
|
|
}
|
|
}
|
|
|
|
#[test]
|
|
fn hostile_numbers_are_refused() {
|
|
assert!(make_box([f64::NAN, 0.0, 0.0], [1.0; 3]).is_err());
|
|
assert!(make_box([0.0; 3], [1.0, -1.0, 1.0]).is_err());
|
|
let b = make_box([0.0; 3], [1.0; 3]).unwrap();
|
|
assert!(volume(&b, f64::INFINITY).is_err());
|
|
}
|
|
|
|
#[test]
|
|
fn a_panic_is_an_error_and_the_kernel_is_fresh_after() {
|
|
let r: Result<()> = run("test", |_| panic!("boom"));
|
|
assert!(matches!(r, Err(Error::Internal(ref m)) if m.contains("boom")), "{r:?}");
|
|
assert!(make_box([0.0; 3], [1.0; 3]).is_ok());
|
|
}
|
|
}
|