Struct ReferenceCurveEvaluator 

pub struct ReferenceCurveEvaluator { /* private fields */ }

Reference curve evaluator.

up is the reference direction the oriented frame is built against. It is carried by the provider rather than passed per call so that one consumer cannot silently place two objects against different conventions on the same alignment.

Implementations

impl ReferenceCurveEvaluator

pub const ID: BackendId

Backend identity.

pub const fn new() -> ReferenceCurveEvaluator

Evaluator whose reference up is global +Z.

The right default for civil and building work, where z is up by construction.

pub fn with_up(up: DVec3) -> Option<ReferenceCurveEvaluator>

Evaluator with an explicit reference up direction.

Returns None for a non-finite or zero vector, which cannot define a roll convention.

pub const fn up(&self) -> DVec3

The reference up direction this evaluator builds frames against.

Trait Implementations

impl Backend for ReferenceCurveEvaluator

fn descriptor(&self) -> BackendDescriptor

Runtime descriptor and capability inventory.

impl Clone for ReferenceCurveEvaluator

fn clone(&self) -> ReferenceCurveEvaluator

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ReferenceCurveEvaluator

impl CurveEvaluator for ReferenceCurveEvaluator

fn determinism(&self) -> Determinism

Bitwise: every path is deterministic floating-point arithmetic with no hashing, threading or iteration-order dependence.

fn point_at_on( &self, curve: &Curve3, at: CurveMeasure, side: SeamSide, ) -> Result<DVec3, GeomError>

On a seam (ADR 0082’s rule, both sides), the point station_section3_on reads there; elsewhere point_at.

fn tangent_at_on( &self, curve: &Curve3, at: CurveMeasure, side: SeamSide, ) -> Result<DVec3, GeomError>

On a seam, the tangent of side’s piece as station_section3_on reads it; elsewhere tangent_at.

fn frame_at_on( &self, curve: &Curve3, at: CurveMeasure, side: SeamSide, ) -> Result<Frame3, GeomError>

On a seam, station_section3_on’s frame of side’s piece in this layout: a banked curve’s rolled section (refused, as by frame_at, for a reference up other than +Z), every other curve’s reference-up frame against this evaluator’s up, which for +Z is the station frame itself. Elsewhere frame_at.

fn path_distance_convention(&self, path: &CurvePath) -> DistanceConvention

The composite’s convention (CompositeBasis::convention), or DistanceConvention::Unsupported for a path CompositeBasis::from_path refuses.

fn path_point_at_on( &self, path: &CurvePath, at: CurveMeasure, side: SeamSide, ) -> Result<DVec3, GeomError>

The point of CompositeBasis::section_on with side.

fn path_tangent_at_on( &self, path: &CurvePath, at: CurveMeasure, side: SeamSide, ) -> Result<DVec3, GeomError>

The tangent of CompositeBasis::section_on with side.

fn path_frame_at_on( &self, path: &CurvePath, at: CurveMeasure, side: SeamSide, ) -> Result<Frame3, GeomError>

CompositeBasis::section_on’s frame with side, in this layout: the station section itself against +Z; against another reference up, the reference-up frame of the section’s point and tangent, except on a banked piece, whose cant is measured against +Z and which is refused, as by frame_at.

fn path_frame_is_exact_at( &self, path: &CurvePath, at: CurveMeasure, side: SeamSide, ) -> bool

CompositeBasis::frame_is_exact_at for a distance along a path CompositeBasis::from_path accepts; false otherwise.

fn path_joint_distances( &self, path: &CurvePath, tolerance: f64, ) -> Result<Vec<DistanceInterval>, GeomError>

CompositeBasis::joint_intervals of the path (#294): exact lengths summed as points, numerical ones bounded by chords and turning or by a certified midpoint rule (crate::station::certify).

fn path_joint_distances_within( &self, path: &CurvePath, around: f64, window: f64, tolerance: f64, ) -> Result<Vec<(usize, DistanceInterval)>, GeomError>

CompositeBasis::joint_intervals_within of the path (#305): the joints whose certified interval meets the window, each bitwise as Self::path_joint_distances gives it, certifying only the pieces before and within the window.

fn distance_convention(&self, curve: &Curve3) -> DistanceConvention

Which distance this provider measures for curve.

fn point_at(&self, curve: &Curve3, at: CurveMeasure) -> Result<DVec3, GeomError>

Position at at along curve.

fn tangent_at( &self, curve: &Curve3, at: CurveMeasure, ) -> Result<DVec3, GeomError>

Unit tangent at at along curve.

fn frame_at( &self, curve: &Curve3, at: CurveMeasure, ) -> Result<Frame3, GeomError>

Oriented frame at at along curve.

fn path_point_at( &self, path: &CurvePath, at: CurveMeasure, ) -> Result<DVec3, GeomError>

Position at at along path, reading a joint from its outgoing piece: path_point_at_on with SeamSide::Outgoing.

fn path_tangent_at( &self, path: &CurvePath, at: CurveMeasure, ) -> Result<DVec3, GeomError>

Unit tangent at at along path, reading a joint from its outgoing piece: path_tangent_at_on with SeamSide::Outgoing.

fn path_frame_at( &self, path: &CurvePath, at: CurveMeasure, ) -> Result<Frame3, GeomError>

Oriented frame at at along path, reading a joint from its outgoing piece: path_frame_at_on with SeamSide::Outgoing.

impl Debug for ReferenceCurveEvaluator

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

Formats the value using the given formatter.

impl Default for ReferenceCurveEvaluator

fn default() -> ReferenceCurveEvaluator

Returns the “default value” for a type.

impl PartialEq for ReferenceCurveEvaluator

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ReferenceCurveEvaluator