Struct CuttingConfig 

pub struct CuttingConfig {

    pub kerf_width: f64,
    pub pierce_weight: f64,
    pub max_2opt_iterations: usize,
    pub time_limit_ms: u64,
    pub rapid_speed: f64,
    pub cut_speed: f64,
    pub exterior_direction: CutDirectionPreference,
    pub interior_direction: CutDirectionPreference,
    pub home_position: (f64, f64),
    pub pierce_candidates: usize,
    pub tolerance: f64,
    pub lead_in: LeadInConfig,
    pub bridge: BridgeConfig,
    pub thermal: ThermalConfig,
}

Configuration parameters for cutting path optimization.

Fields

kerf_width: f64

Kerf width (cutting tool width) in the same units as geometry coordinates. Used for kerf compensation. Set to 0.0 to disable.

pierce_weight: f64

Weight factor for pierce count in the cost function. Cost = total_rapid_distance + pierce_weight * pierce_count

max_2opt_iterations: usize

Maximum number of 2-opt improvement iterations. Set to 0 to use only the nearest-neighbor solution.

time_limit_ms: u64

Wall-clock budget (in milliseconds) for the 2-opt improvement phase.

The 2-opt neighborhood is O(n^2) candidate moves per pass, and each pass may repeat up to max_2opt_iterations times, so on large inputs the iteration cap alone can still run for many seconds — blocking the (browser main) thread. When this budget is exceeded the optimizer stops and returns the best sequence found so far; cut-path order is a heuristic, so early termination never invalidates the result.

Set to 0 for no wall-clock limit (bounded only by max_2opt_iterations). Default: 5000 (5 seconds).

rapid_speed: f64

Machine rapid traverse speed (mm/s or units/s). Used only for time estimation, not for optimization.

cut_speed: f64

Machine cutting speed (mm/s or units/s). Used only for time estimation, not for optimization.

exterior_direction: CutDirectionPreference

Default cut direction for exterior contours.

interior_direction: CutDirectionPreference

Default cut direction for interior contours (holes).

home_position: (f64, f64)

Home position for the cutting head (start/end point). Default is (0.0, 0.0).

pierce_candidates: usize

Number of candidate pierce points to evaluate per contour. Higher values give better pierce point selection but slower optimization. Default: 1 (use nearest point on contour to previous endpoint).

tolerance: f64

Tolerance for geometric comparisons.

lead_in: LeadInConfig

Lead-in/lead-out configuration.

bridge: BridgeConfig

Bridge/tab (micro-joint) configuration.

thermal: ThermalConfig

Thermal model configuration.

Implementations

impl CuttingConfig

pub fn new() -> Self

Creates a new default configuration.

pub fn with_kerf_width(self, width: f64) -> Self

Sets the kerf width.

pub fn with_pierce_weight(self, weight: f64) -> Self

Sets the pierce weight factor.

pub fn with_max_2opt_iterations(self, iterations: usize) -> Self

Sets the maximum 2-opt iterations.

pub fn with_time_limit_ms(self, time_limit_ms: u64) -> Self

Sets the wall-clock budget (ms) for the 2-opt phase. 0 = unlimited.

pub fn with_home_position(self, x: f64, y: f64) -> Self

Sets the home position.

pub fn with_pierce_candidates(self, candidates: usize) -> Self

Sets the number of pierce candidates per contour.

pub fn with_lead_in(self, lead_in: LeadInConfig) -> Self

Sets the lead-in/lead-out configuration.

pub fn with_bridge(self, bridge: BridgeConfig) -> Self

Sets the bridge/tab configuration.

pub fn with_thermal(self, thermal: ThermalConfig) -> Self

Sets the thermal model configuration.

Trait Implementations

impl Clone for CuttingConfig

fn clone(&self) -> CuttingConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CuttingConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for CuttingConfig

fn default() -> Self

Returns the “default value” for a type.