Struct MeshBooleanRegistry

pub struct MeshBooleanRegistry { /* private fields */ }

Ordered executable providers for one narrow operation.

Fallback happens only for Unsupported or Unavailable; numerical and data failures are returned immediately rather than hidden by another algorithm.

Implementations

impl MeshBooleanRegistry

pub const fn new() -> MeshBooleanRegistry

Empty registry.

pub fn with_execution(self, execution: CpuExecution) -> MeshBooleanRegistry

Scope every dispatched provider call to execution’s local pool.

This bounds whatever parallelism a provider already does; it does not make a single-threaded provider concurrent. With no provider threading it costs nothing but the install call.

pub fn register<B>(&mut self, priority: i32, provider: B)

where B: MeshBoolean + 'static,

Register an implementation. Higher priorities run first.

pub fn register_conformant<B>( &mut self, priority: i32, provider: B, ) -> Result<(), Box<ConformanceReport>>

where B: MeshBoolean + 'static,

Register only if the provider passes the shared conformance suite.

ADR 0017 §6 makes conformance a precondition of registration rather than a test someone might remember to run. A provider that violates the contract is rejected here, with the failing report, instead of being discovered later by a caller receiving wrong geometry.

Self::register remains available for tests and for deliberately partial providers; this is the door production code should use.

Errors

Returns the report when the provider violates any obligation.

pub fn register_arc(&mut self, priority: i32, provider: Arc<dyn MeshBoolean>)

Register a shared trait object.

pub fn providers(&self) -> impl Iterator<Item = &dyn MeshBoolean>

Registered providers in dispatch order.

pub fn boolean( &self, subject: &TriMesh, tool: &TriMesh, operation: BooleanOperator, options: &ExecutionOptions, ) -> Result<BooleanOutcome, GeomError>

Execute according to device policy with narrow fallback semantics.

pub fn subtract_many( &self, subject: &TriMesh, tools: &[TriMesh], options: &ExecutionOptions, ) -> Result<BooleanOutcome, GeomError>

Subtract many tools through one provider dispatch.

pub fn union_many( &self, solids: &[TriMesh], options: &ExecutionOptions, ) -> Result<BooleanOutcome, GeomError>

Union many solids through one provider dispatch.

An empty batch is answered without consulting a provider: the union of nothing is nothing, and there is no operand to validate or size a budget against.

Trait Implementations

impl Clone for MeshBooleanRegistry

fn clone(&self) -> MeshBooleanRegistry

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MeshBooleanRegistry

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

Formats the value using the given formatter.

impl Default for MeshBooleanRegistry

fn default() -> MeshBooleanRegistry

Returns the “default value” for a type.