Struct MeshHiddenLinesRegistry 

pub struct MeshHiddenLinesRegistry { /* private fields */ }

Ordered executable hidden-line providers.

Only unsupported/unavailable providers permit fallback. Geometry, degeneracy, budget, cancellation, and contract errors fail immediately. A refusal caused by one input mesh names it (HiddenLineError::mesh); a refusal of the whole request does not. hidden_lines names the first refused mesh only; a caller that drops refused meshes and draws the rest learns all of them in one call from audit.

Implementations

impl MeshHiddenLinesRegistry

pub const fn new() -> Self

Empty registry.

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

where P: MeshHiddenLines + 'static,

Register an implementation. Higher priorities run first.

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

where P: MeshHiddenLines + 'static,

Validate a provider with the shared conformance suite before registration.

A provider that claims perspective views (supports_projection) is also run through the perspective suite, and a failure of it is reported as a ReturnedError of the case perspective claim, so a claim is never routed to unverified (ADR 0107).

pub fn register_perspective_conformant<P>( &mut self, priority: i32, provider: P, ) -> Result<(), Box<PerspectiveConformanceReport>>

where P: MeshHiddenLines + 'static,

Validate a provider with the shared suite and the perspective suite before registration (ADR 0107). The claim is the provider’s supports_projection(ViewProjection::Perspective): a provider that does not claim it must refuse perspective views by name, one that does must pass the perspective fixtures. Failures of either suite are in the report.

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

Register a shared implementation. Higher priorities run first.

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

Registered providers in dispatch order.

pub fn audit( &self, request: &HiddenLineRequest<'_>, options: &ExecutionOptions, ) -> Result<Vec<RefusedMesh>, HiddenLineError>

Every input mesh that hidden_lines would refuse, in request order, without searching.

Runs only the per-mesh audit of shape and topology, through the code hidden_lines uses, so a mesh is listed exactly when hidden_lines would refuse a request holding it. An empty list means every mesh passes the audit (a provider can still refuse). A caller that leaves the listed meshes out and calls hidden_lines again draws the rest; no substitute drawing is made. A refusal of the whole request (limits, frame, memory, cancellation, an empty request, a duplicate id or a mesh without triangles) is returned as Err, as it is by hidden_lines.

pub fn hidden_lines( &self, request: &HiddenLineRequest<'_>, options: &ExecutionOptions, ) -> Result<HiddenLineOutcome, HiddenLineError>

Validate and execute one hidden-line request.

Trait Implementations

impl Clone for MeshHiddenLinesRegistry

fn clone(&self) -> MeshHiddenLinesRegistry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MeshHiddenLinesRegistry

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

Formats the value using the given formatter.

impl Default for MeshHiddenLinesRegistry

fn default() -> MeshHiddenLinesRegistry

Returns the “default value” for a type.