Enum OpticError 

pub enum OpticError {
    NonFinite {
        field: &'static str,
    },
    NegativeLimit {
        field: &'static str,
        value: f64,
    },
    NonPositiveClickSize {
        field: &'static str,
        size: f64,
    },
    ZeroClicksPerRevolution,
    StateOutsideTravel {
        axis: &'static str,
        dialed_mil: f64,
        down_mil: f64,
        up_mil: f64,
    },
    NonPositiveTrackingFactor {
        field: &'static str,
        value: f64,
    },
}

Why an OpticProfile failed validate.

Variants

NonFinite

A field that must be finite was NaN or infinite.

Fields

field: &'static str

NegativeLimit

A travel or hold-bound magnitude was negative.

Fields

field: &'static str

value: f64

NonPositiveClickSize

A click graduation’s size was zero or negative. ClickValue’s fields are pub, so this is reachable by direct construction even though parse_click_value (crate::adjustment) already excludes it on every string-parsed or deserialized click — see that function and ClickValue’s Deserialize impl.

Fields

field: &'static str

size: f64

ZeroClicksPerRevolution

clicks_per_revolution was Some(0). Zero clicks is not a revolution.

StateOutsideTravel

turret_state’s value on axis fell outside that axis’s declared TravelLimits (both measured from the same zero).

Fields

axis: &'static str

dialed_mil: f64

down_mil: f64

up_mil: f64

NonPositiveTrackingFactor

A tracking correction factor (elevation_cf/windage_cf in plan_corrections) was zero, negative, or non-finite (MBA-1348 review fix). plan_corrections divides a TRUE angular correction by the CF to get a DIAL target (see the module’s “CF rule” doc section); a zero or negative CF turns that into infinity, NaN, or a direction-inverting garbage value that would silently propagate into a “plan” that looks like ordinary output. Rejected outright rather than merely warned about – crate::adjustment::tracking_cf_in_range’s tighter (0.5, 1.5) plausibility band is deliberately NOT re-enforced here, matching this crate’s existing precedent (crate::truing::scale_report_dial_values also takes a bare, unchecked dial_cf) of treating that band as an advisory, caller/CLI-level concern, not a hard library-level bound – unlike card::AdaptiveRequest’s hard enforcement of the same band (see its own doc comment): the planner does not enforce it here because plan_corrections’s residual stays honest under a wild CF, while the card engine does enforce it because a large finite CF there would otherwise produce a confident budget_met: true on a card that does not actually meet its stated error budget.

Fields

field: &'static str

value: f64

Implementations

impl OpticError

pub fn failure_details(&self) -> Option<Value>

Structured detail payload for a JSON bridge error envelope, mirroring crate::truing_service::DsfServiceErrorV1::failure_details: an INHERENT method (not a trait impl — a blanket trait impl collides with specific ones under E0119, and this type must keep compiling with the bridge feature off, since optic is unconditional). One stable reason per variant, plus that variant’s own fields, so a wizard can branch on the failure kind without parsing the Display message.

Trait Implementations

impl Clone for OpticError

fn clone(&self) -> OpticError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OpticError

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

Formats the value using the given formatter.

impl Display for OpticError

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

Formats the value using the given formatter.

impl Error for OpticError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for OpticError

fn eq(&self, other: &OpticError) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for OpticError