Struct SectionAtStation 

#[non_exhaustive]
pub struct SectionAtStation {
    pub profile: NodeId,
    pub station: Station,
    pub tags: Vec<String>,
    pub orientation: StationOrientation,
    pub seam: SeamSide,
    pub seam_window: f64,
}

A section standing at a station, with optional tags and an optional explicit orientation (#246): the general form of StationedSection (closed) and StationedOpenSection (open).

Built with SectionAtStation::new and the with_ methods, so that fields can be added without breaking callers.

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.

profile: NodeId

The profile node: an area profile in a sectioned spine, an open profile in a sectioned surface.

station: Station

Distance along the directrix and offsets of the profile’s origin, in the base frame.

tags: Vec<String>

One tag per vertex, or empty to match by index; see the module documentation.

orientation: StationOrientation

The section’s orientation in the base frame; the default is the base frame.

seam: SeamSide

The piece read where the section stands on a seam its run does not decide (#301): SeamSide::Outgoing unless set by Self::with_seam_side. See the module documentation for where a run reads it.

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

seam_window: f64

The seam-snapping window (#294, #301): a section within this distance of one seam of the directrix stands ON that seam. 0 unless set by Self::with_seam_window, which is the arc-length tolerance alone.

Format 1.2 of the graph’s wire format (ADR 0085): omitted when it is +0.0, and an absent window reads as 0.

Implementations

impl SectionAtStation

pub const fn new(profile: NodeId, station: Station) -> SectionAtStation

profile at station, untagged, in the base frame.

pub fn with_tags<I, T>(self, tags: I) -> SectionAtStation

where I: IntoIterator<Item = T>, T: Into<String>,

The same section with tags, one per vertex.

pub const fn with_orientation( self, orientation: StationOrientation, ) -> SectionAtStation

The same section turned by orientation.

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

The same section reading side of a seam it stands on, where its run does not decide the side (#301; see the module documentation).

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

The same section snapping onto a seam of the directrix within window (#301), in the directrix’s station measure, by the #294 rule. 0 is no window beyond the arc-length tolerance; a negative or non-finite window is refused when the node is pushed.

Trait Implementations

impl Clone for SectionAtStation

fn clone(&self) -> SectionAtStation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SectionAtStation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SectionAtStation

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<StationedOpenSection> for SectionAtStation

fn from(section: StationedOpenSection) -> SectionAtStation

Converts to this type from the input type.

impl From<StationedSection> for SectionAtStation

fn from(section: StationedSection) -> SectionAtStation

Converts to this type from the input type.

impl PartialEq for SectionAtStation

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for SectionAtStation

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 SectionAtStation