Struct MagnetSnap 

#[non_exhaustive]
pub struct MagnetSnap {
    pub from: MagnetId,
    pub to: MagnetId,
    pub snap_vector: Vec2,
    pub payload: Option<Rc<dyn Any>>,
    pub distance: f32,
}

The chosen snap when a dragged item’s magnet aligns onto another item’s magnet. Returned by Scene::compute_item_snap.

A heavyweight consumer that drives its own drag uses snap_vector to place the item so from lands on to, and resolves from / to via Scene::magnet to build the connection for its own on_connect.

#[non_exhaustive]: the crate hands this to consumer code — a heavyweight consumer driving its own drag reads it. Build one with new.

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.

from: MagnetId

The dragged item’s magnet that is snapping.

to: MagnetId

The stationary magnet it snaps onto.

snap_vector: Vec2

Add this to the drag delta (or the item’s position) so from’s scene position coincides with to’s.

payload: Option<Rc<dyn Any>>

The accepting verdict’s payload, if any.

distance: f32

Scene-space distance between the pair before snapping (the tie-break used to pick the closest accepting pair).

Implementations

impl MagnetSnap

pub fn new( from: MagnetId, to: MagnetId, snap_vector: Vec2, payload: Option<Rc<dyn Any>>, distance: f32, ) -> Self

A snap stated field by field — the constructor #[non_exhaustive] takes the place of a struct literal for. The scene computes its own; this is for a consumer’s own tests.

Trait Implementations

impl Clone for MagnetSnap

fn clone(&self) -> MagnetSnap

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MagnetSnap

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

Formats the value using the given formatter.