SceneSelectionMode

Selection model for Scene items.

Mirrors the API of teksilo_data::SelectionModel but keyed by ItemId instead of usize — the natural address for scene entries. Click-to-select, Ctrl+click toggle, Shift+click range, and marquee box-select all flow through this single model; SceneView paints a marquee overlay during the drag and commits the result via Scene::items_in_rect.

The selection set is exposed as a Signal<BTreeSet<ItemId>> so SceneItem paint code can render selected items differently by binding their colors / strokes to a derived signal:

# use teksilo_scene::{SceneModel, SceneSelection, SceneSelectionMode};
# use teksilo_canvas::{Point, Rect};
# use teksilo_tokens::Color;
# let model = SceneModel::new();
# let card_id = model.add_item(teksilo_scene::RectItem::new(Rect::new(0.0, 0.0, 100.0, 80.0)), Point::ZERO);
let selection = SceneSelection::new(SceneSelectionMode::Multi);
let selected = selection.selection_signal();
let stroke_color = selected.map(move |s| {
    if s.contains(&card_id) { Color::BLUE } else { Color::TRANSPARENT }
});

Builder methods at a glance

mode, selection_signal, is_selected, selected, count, clear, select_one, toggle, replace, extend, commit_marquee

API reference

📖 Full rustdoc API for this module

pub enum SceneSelectionMode

Selection-mode discriminator. Mirrors teksilo_data::SelectionMode.

#![allow(unused)]
fn main() {
pub enum SceneSelectionMode { /* variants */ }
}

Variants

• None — Selection disabled. Click does nothing, marquee does nothing.
• Single — At most one item selected at a time.
• Multi — Multiple items can be selected; Ctrl+click toggles, Shift+click extends a range from the anchor.

pub struct SceneSelection

Reactive selection state for a Scene.

Cheap-to-clone via Rc internals — all clones share the same underlying signal. Pass clones into widget closures or item register_bindings impls without worrying about ownership.

#![allow(unused)]
fn main() {
pub struct SceneSelection { /* fields */ }
}

Methods

pub fn new(mode: SceneSelectionMode) -> Self

New selection model with the given mode. Initially empty, no anchor.

pub fn mode(&self) -> SceneSelectionMode

The configured selection mode.

pub fn selection_signal(&self) -> Signal<BTreeSet<ItemId>>

Live selection signal. Bind reactive consumers (item paint, status-bar item-count labels) to this.

pub fn is_selected(&self, id: ItemId) -> bool

Whether the given item id is currently selected.

pub fn selected(&self) -> Vec<ItemId>

Selected item ids in sorted order.

pub fn count(&self) -> usize

Number of selected items.

pub fn clear(&self)

Clear the selection. The anchor is also cleared so a subsequent Shift+click extends from a fresh starting point.

pub fn select_one(&self, id: ItemId)

Replace the selection with a single item; sets the anchor for subsequent range extension. No-op in None mode.

pub fn toggle(&self, id: ItemId)

Toggle membership for the given id (Ctrl+click semantic). Sets the anchor on toggle-on; leaves it unchanged on toggle-off. No-op in None mode; in Single mode behaves like select_one if the item is currently unselected, or clear if it is.

pub fn replace(&self, ids: impl IntoIterator<Item = ItemId>)

Replace the selection with the given set of ids. Used by marquee on commit. Anchor is cleared. No-op in None mode; in Single mode keeps at most one (the first id in ids).

pub fn extend(&self, ids: impl IntoIterator<Item = ItemId>)

Add ids to the existing selection (marquee with Ctrl-modifier — additive box-select). No-op in None mode; in Single mode reduces to select_one(last).

pub fn commit_marquee(&self, scene: &Scene, marquee_rect: Rect, additive: bool)

Marquee commit helper: replace (or extend, if additive) the selection with every scene item whose AABB intersects marquee_rect_in_scene. Lightweight items and heavyweight widget entries are both candidates — the spatial index returns ids regardless of kind.