RectItem

RectItem — filled / stroked rectangle in local item coords.

RectItem is the simplest and cheapest lightweight scene item: a rectangle in local item coordinates with an optional fill and/or stroke. It uses the default AABB hit-test (exact for a rectangle) and has zero arena overhead.

Like all lightweight items, RectItem is constructed with its geometry relative to a local origin (Rect::new(0.0, 0.0, w, h)) and placed in the scene by Scene::add_item(item, scene_pos), where scene_pos becomes the item's anchor in scene coordinates.

Fill and stroke colours are ColorProps, so they accept a plain Color, a theme role (SurfaceRole / TextRole / BorderRole), a reactive Signal<Color>, or a Signal<Role> — resolved against the active theme at paint time (so role-based fills desaturate automatically in an inactive window). Change a colour live via SceneModel::set_item_fill / set_item_stroke.

When to use

Use RectItem for background tiles, card backgrounds, selection highlights, grid cells, or any rectangular decoration in the lightweight tier. For arbitrary shapes, use PathItem; for interactive content needing focus or event handlers, embed a full widget with Scene::add_widget.

Example

use teksilo_scene::{SceneModel, RectItem};
use teksilo_canvas::{Point, Rect};
use teksilo_tokens::Color;
use teksilo_i18n::lit;

let model = SceneModel::new();

let item = RectItem::new(Rect::new(0.0, 0.0, 120.0, 80.0))
    .fill(Color::new(0.9, 0.95, 1.0, 1.0))
    .corner_radius(8.0)
    .stroke_cosmetic(Color::new(0.6, 0.7, 0.85, 1.0), 1.0)
    .label(lit!("Card background"))
    .draggable(true);

model.add_item(item, Point::new(40.0, 40.0));

Builder methods at a glance

fill, stroke, stroke_cosmetic, stroke_styled, corner_radius, label, draggable

API reference

📖 Full rustdoc API for this module

`pub struct RectItem`

A rectangle with optional fill and stroke, in local item coordinates.

Construct with RectItem::new(Rect::new(0.0, 0.0, w, h)) and place in the scene via Scene::add_item(rect, local_pos).

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

Methods

`pub fn new(local_bounds: Rect) -> Self`

A rectangle of the given size in local item coordinates. The passed local_bounds is stored verbatim — typically Rect::new(0.0, 0.0, w, h). No fill, no stroke — set at least one or the item is invisible.

`pub fn fill(mut self, color: impl Into<ColorProp>) -> Self`

Fill colour. Accepts a plain Color, a theme role, a Signal<Color>, or a Signal<Role> — resolved against the active theme at paint time.

`pub fn stroke(mut self, color: impl Into<ColorProp>, width: f32) -> Self`

Stroke colour and width in scene-coordinate pixels — the border scales with the view zoom (a 1px border becomes 2px at 2× zoom).

`pub fn stroke_cosmetic(mut self, color: impl Into<ColorProp>, width: f32) -> Self`

Cosmetic stroke: the border holds a constant device-pixel width at any zoom (a hairline that never thins out or thickens). Ideal for grid cells and card outlines in a pannable/zoomable scene.

`pub fn stroke_styled(mut self, color: impl Into<ColorProp>, style: StrokeStyle) -> Self`

Stroke with an explicit StrokeStyle — dashed, dotted, or custom caps / joins. E.g. .stroke_styled(color, StrokeStyle::dashed(2.0, 6.0, 4.0)) for a dashed outline, or StrokeStyle::dotted(1.5, 3.0) for a dotted guide. The style is stored verbatim, so all of StrokeStyle's knobs (dash pattern/offset, Logical vs Device space) apply.

Teksilo Documentation