Struct OpticProfile 

pub struct OpticProfile {
    pub elevation_click: ClickValue,
    pub windage_click: ClickValue,
    pub clicks_per_revolution: Option<u32>,
    pub zero_stop: bool,
    pub elevation_travel: Option<TravelLimits>,
    pub windage_travel: Option<TravelLimits>,
    pub turret_state: Option<TurretState>,
    pub reticle_hold_bounds: Option<HoldBounds>,
}

A shooter’s complete turret and reticle geometry (MBA-1348).

Every angular field anywhere in this type is in MIL. Turret-related fields (clicks_per_revolution, elevation_travel, windage_travel, turret_state) are in DIAL-space; reticle_hold_bounds is TRUE angular. See the module docs for what that distinction means and why it matters.

Fields

elevation_click: ClickValue

Elevation turret’s click graduation (its engraved size, e.g. 0.1 mil or 1/4 MOA). Serializes as crate::adjustment::ClickValue’s own suffixed string ("0.1mil"), not a structural object. validate requires a positive size.

windage_click: ClickValue

Windage turret’s click graduation. Same serialized form and validate rule as elevation_click.

clicks_per_revolution: Option<u32>

Click detents per full turret revolution, for turrets whose cap marks revolutions at all (many hunting turrets do not, hence Option). Must be at least 1 when present — Some(0) is rejected by validate, since a revolution with zero clicks in it is not a revolution.

zero_stop: bool

Whether the elevation turret hard-stops at elevation_travel.down_mil, so the shooter cannot dial below zero at all. Descriptive metadata about the mechanism: validate does not require elevation_travel to be Some just because zero_stop is true, or vice versa.

elevation_travel: Option<TravelLimits>

Elevation travel remaining in each direction from the current zero setting (not from the mechanical bottom of the turret) — DIAL-space, mil.

windage_travel: Option<TravelLimits>

Windage travel from the current zero — DIAL-space, mil. down_mil is LEFT travel, up_mil is RIGHT travel (see TravelLimits).

turret_state: Option<TurretState>

The turret’s current dialed offset from zero — DIAL-space, mil.

reticle_hold_bounds: Option<HoldBounds>

The reticle’s usable hold extent — TRUE angular, mil. See HoldBounds: this is an EXPLICIT input and is never derived from a crate::reticle::ReticleDescription.

Implementations

impl OpticProfile

pub fn validate(&self) -> Result<(), OpticError>

Checks internal consistency: every angular field is finite, both click sizes are positive, every travel/hold-bound magnitude is non-negative, clicks_per_revolution is a sane count, and — when both are present — turret_state lies within elevation_travel / windage_travel.

This cannot and does not check that the profile matches any real, physical scope; it only rejects shapes that are self-contradictory or would corrupt downstream arithmetic (a zero-length revolution, NaN propagation, a dialed state the turret could not physically reach given its own declared travel, or a zero/negative click size that would turn a later quantize_angle division into infinity or NaN).

Trait Implementations

impl Clone for OpticProfile

fn clone(&self) -> OpticProfile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OpticProfile

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for OpticProfile

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for OpticProfile

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for OpticProfile

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for OpticProfile