Struct RunStation 

#[non_exhaustive]
pub struct RunStation {
    pub station: Station,
    pub seam: SeamSide,
    pub seam_window: f64,
    pub basis_end: Option<BasisEnd>,
}

A station of an offset run with the side of a seam it reads and its seam-snapping window (#301): the general form of the plain Station a CurveRelation::OffsetByStations takes, used by CurveRelation::OffsetsAtStations. It may also stand at its basis’s start or end, its distance measured by the kernel (#303).

Built with RunStation::new, RunStation::at_basis_start, RunStation::at_basis_end and the with_ methods, so that fields can be added without breaking callers. See the module documentation for how a run reads the side and the window, and its #303 section for the basis’s ends.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

station: Station

Distance along the basis and offsets in its frame there.

seam: SeamSide

The piece read where the station stands on a seam its run does not decide: SeamSide::Outgoing unless set by Self::with_seam_side. Omitted from the wire format when it is Outgoing.

seam_window: f64

The seam-snapping window (#294): a station within this distance of one seam of the basis stands ON it. 0 unless set by Self::with_seam_window. Omitted from the wire format when it is +0.0.

basis_end: Option<BasisEnd>

The end of the basis the station stands at, its distance measured by the kernel (#303): None, the default, for the stated station.distance; otherwise that distance is 0 and not read (see the module documentation).

Format 1.3 of the graph’s wire format (ADR 0085): omitted when it is None, and an absent end reads as None.

Implementations

impl RunStation

pub const fn new(station: Station) -> RunStation

station, reading the outgoing piece on a seam, with no window.

pub const fn at_basis_start(offsets: StationOffsets) -> RunStation

A station at the basis’s start with offsets (#303): distance 0, reading the outgoing piece, with no window.

pub const fn at_basis_end(offsets: StationOffsets) -> RunStation

A station at the basis’s end with offsets (#303), reading the outgoing piece, with no window: its distance is the basis’s length by the kernel’s own measure, which the caller need not know (see the module documentation).

pub const fn with_seam_side(self, side: SeamSide) -> RunStation

The same station reading side of a seam it stands on, where its run does not decide the side.

pub const fn with_seam_window(self, window: f64) -> RunStation

The same station snapping onto a seam of its basis within window, in the basis’s station measure, by the #294 rule. A negative or non-finite window is refused when the node is pushed.

Trait Implementations

impl Clone for RunStation

fn clone(&self) -> RunStation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RunStation

impl Debug for RunStation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for RunStation

fn deserialize<__D>( __deserializer: __D, ) -> Result<RunStation, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Station> for RunStation

fn from(station: Station) -> RunStation

The plain station: the outgoing piece, no window, what a station of an OffsetByStations means.

impl PartialEq for RunStation

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for RunStation

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for RunStation