ItemFlags

Per-item behavior flags.

Public functions

ItemFlags

Detailed description

ItemFlags is a bitset packed into a u32. Each flag opts an item into a behavior — drag-to-move participation, hit-test response, rendering visibility, transform inheritance — that the Scene and SceneView consult at the relevant pipeline stage.

Defaults: IS_VISIBLE | IS_ENABLED | IS_SELECTABLE. An item constructed via the standard built-in builders gets these defaults; setters layer additional flags on top.

API reference

📖 Full rustdoc API for this module

pub struct ItemFlags

Import: use teksilo_scene::ItemFlags; — add teksilo-scene to [dependencies]: teksilo does not re-export it.

A bitset of per-item behavior flags.

Use ItemFlags::default for the standard "interactive, visible, selectable" baseline. Compose flags with | and toggle them with ItemFlags::set / ItemFlags::contains.

#![allow(unused)]
fn main() {
pub struct ItemFlags(u32);
}

Methods

pub const NONE: Self = Self(0);

Empty bitset — no flags set.

pub const IS_VISIBLE: Self = Self(1 << 0);

Item paints and is hit-tested. Default on. Clearing this is the equivalent of Qt's setVisible(false) — the item is neither painted nor hit-tested. Children of an invisible item are also effectively invisible.

pub const IS_ENABLED: Self = Self(1 << 1);

Item dispatches pointer events. Default on. Disabled items are still painted but pass clicks through to items beneath.

pub const IS_DRAGGABLE: Self = Self(1 << 2);

Item participates in drag-to-move. Default off.

pub const IS_SELECTABLE: Self = Self(1 << 3);

Item is included in marquee box-select results. Default on.

pub const IS_FOCUSABLE: Self = Self(1 << 4);

Item can take keyboard focus. Default off. Declared only: the built-in traversal (SceneView::focus_in_direction) walks every item in insertion order, and a focus_order callback is handed the whole Scene and filters for itself — nothing reads this bit.

pub const ACCEPTS_HOVER: Self = Self(1 << 5);

Item dispatches hover events (Qt setAcceptHoverEvents). Default off. Declared only: the view dispatches hover from the presence of a SceneItemHandlerSet::on_hover callback, and nothing sets or reads this bit.

pub const CLIPS_TO_SHAPE: Self = Self(1 << 6);

Item's paint output is clipped to its local_bounds. Default off.

pub const CLIPS_CHILDREN_TO_SHAPE: Self = Self(1 << 7);

Children are clipped to this item's local_bounds. Default off; mirrors Qt's ItemClipsChildrenToShape.

pub const IGNORES_TRANSFORMATIONS: Self = Self(1 << 8);

Item paints and hit-tests at a fixed pixel size, independent of the view's zoom and rotation. Its anchor (the item's parent-relative scene point) is projected through the view transform like any other point, so the visible position follows pan/zoom and tracks the underlying scene data — but the item itself does not grow with zoom or rotate with the view. Mirrors Qt's ItemIgnoresTransformations. Annotation pins for graph editors, fixed-pixel-size badges over moving content, chart axis labels. Default off.

pub const HAS_NO_CONTENTS: Self = Self(1 << 9);

Item has nothing to paint — the paint walk skips it entirely. Pure logical-only containers (used for AT grouping or hit-test routing) set this. Default off.

pub const IS_RESIZABLE: Self = Self(1 << 11);

Item offers resize handles to a selection transform controller. Default off, like IS_DRAGGABLE.

A resize writes the item's local_bounds, so the item reflows into the new box — a heavyweight card relayouts, a RectItem redraws at the new size, a PathItem fits its geometry to it. Nothing is scaled visually and then baked.

pub const IS_ROTATABLE: Self = Self(1 << 12);

Item offers a rotate handle to a selection transform controller. Default off.

Honoured for the lightweight tier only. A heavyweight entry carrying it is refused, because place_children sizes a card from the AABB of its transformed bounds: a rotation there inflates the layout box and rotates nothing. See SceneView::transform_controller.

pub const ASPECT_LOCKED: Self = Self(1 << 13);

A resize of this item keeps its aspect ratio whatever the controller's keep_ratio setting says. Default off.

pub const fn contains(&self, other: Self) -> bool

Whether the bitset contains every flag in other.

pub const fn intersects(&self, other: Self) -> bool

Whether the bitset shares any flags with other.

pub fn set(&mut self, flag: Self, on: bool)

Set (when on) or clear (when !on) the bits in flag.

pub const fn with(self, flag: Self) -> Self

Set the bits in flag, returning the new bitset.

pub const fn without(self, flag: Self) -> Self

Clear the bits in flag, returning the new bitset.

pub const fn bits(self) -> u32

Raw u32 bits (debug / serialization).

pub const fn from_bits(bits: u32) -> Self

Construct from raw bits.