Struct InteractionManager 

pub struct InteractionManager { /* private fields */ }

Stateful runtime that interprets raw pointer input and emits high-level InteractionEvents.

Lifecycle

1. Create with InteractionManager::new or InteractionManager::with_config.
2. Each frame, feed input via update_pointer_move, update_pointer_down, update_pointer_up, or update_pointer_leave.
3. Call drain_events to consume emitted events.

The manager borrows &mut MapState during each update call so it can run pick queries and (optionally) mutate feature state.

Implementations

impl InteractionManager

pub fn new() -> Self

Create a new interaction manager with default configuration.

pub fn with_config(config: InteractionConfig) -> Self

Create a new interaction manager with custom configuration.

pub fn config(&self) -> &InteractionConfig

Read-only access to the current configuration.

pub fn config_mut(&mut self) -> &mut InteractionConfig

Mutable access to the configuration.

pub fn hovered(&self) -> Option<&FeatureStateId>

The feature identity that is currently hovered, if any.

pub fn selected(&self) -> Option<&FeatureStateId>

The feature identity that is currently selected, if any.

pub fn cursor(&self) -> ScreenPoint

Current logical cursor position.

pub fn is_dragging(&self) -> bool

Whether the current pointer sequence is being treated as a drag.

pub fn update_pointer_move( &mut self, map: &mut MapState, x: f64, y: f64, time: f64, pointer_kind: PointerKind, modifiers: InteractionModifiers, )

Feed a pointer-move event.

The manager runs a pick query at (x, y), diffs the result against the previous frame, and emits MouseLeave / MouseEnter transitions as needed. A MouseMove event is always emitted.

time is a monotonic timestamp in seconds provided by the host.

pub fn update_pointer_down( &mut self, map: &MapState, x: f64, y: f64, time: f64, button: InteractionButton, pointer_kind: PointerKind, modifiers: InteractionModifiers, )

Feed a pointer-down event.

Records the press position and timestamp for later click-vs-drag classification. Emits a MouseDown event.

time is a monotonic timestamp in seconds provided by the host.

pub fn update_pointer_up( &mut self, map: &mut MapState, x: f64, y: f64, time: f64, button: InteractionButton, pointer_kind: PointerKind, modifiers: InteractionModifiers, )

Feed a pointer-up event.

Emits MouseUp unconditionally. If the pointer did not exceed the drag threshold, also emits Click. If two Clicks occur within the double-click window, also emits DoubleClick.

When auto_select_state is enabled and a Click is produced, the manager updates the "selected" feature-state property.

time is a monotonic timestamp in seconds provided by the host.

pub fn update_pointer_leave( &mut self, map: &mut MapState, pointer_kind: PointerKind, modifiers: InteractionModifiers, )

Notify the manager that the pointer has left the map viewport.

Emits MouseLeave for the current hover target and clears all transient hover state.

pub fn drain_events(&mut self) -> Vec<InteractionEvent>

Drain and return all pending interaction events.

This is the primary output interface. The host calls this once per frame after feeding all input events and iterates the returned Vec to dispatch application-level handlers.

pub fn pending_event_count(&self) -> usize

Number of pending events not yet drained.

Trait Implementations

impl Debug for InteractionManager

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

Formats the value using the given formatter.

impl Default for InteractionManager

fn default() -> Self

Returns the “default value” for a type.