Struct SceneItemPaintContext 

pub struct SceneItemPaintContext<'a> {
    pub view_transform: Transform2D,
    pub dirty_scene_rect: Option<Rect>,
    pub text_scale: f32,
    pub theme: &'a Theme,
    pub window_active: bool,
    pub enabled: bool,
}

Context handed to SceneItem::paint.

view_transform is the composed pan/zoom/rotation of the SceneView that’s painting this item; the canvas already has the item’s scene_transform pushed, so paint methods work in local coords without further matrix math.

theme, window_active, and enabled mirror the widget-tier PaintContext so lightweight items can resolve theme-aware colours exactly like widgets do — call some_color_prop.resolve(ctx.theme, ctx.enabled) in paint. theme is already the fully-projected theme for this pass (the render walker swaps in the inactive-window / high-contrast variant before handing it here), so items never call Theme::for_inactive_window themselves; reading ctx.theme grants automatic window-blur desaturation of accent roles.

Fields

view_transform: Transform2D

View pan/zoom/rotation as a single affine. Items rarely need this directly — the canvas’s transform stack already accounts for it — but custom items wanting to draw at a fixed pixel size regardless of zoom can read the zoom factor from here.

dirty_scene_rect: Option<Rect>

Optional scene-coord region the renderer is currently repainting. Items that internally subdivide their geometry can use this to skip work outside the dirty region. None means “full repaint”.

text_scale: f32

Global accessibility text-scale factor (1.0 = 100 %), forwarded from the widget PaintContext. Lightweight text items that opt in (see TextItem::follow_text_scale) multiply their font size by this so they grow with the app-wide “grow all text” setting. Off-by-default because the scene already has its own pan/zoom.

theme: &'a Theme

Fully-projected theme for this paint pass. Already swapped to the inactive-window / high-contrast variant by the render walker — read it directly and never call [Theme::for_inactive_window] yourself. Pass to [ColorProp::resolve] to turn a role/reactive colour into a concrete Color.

window_active: bool

true iff the host window is focused AND not occluded (true in headless tests). Read for behavioural blur cues the accent-desaturation theme swap can’t cover (e.g. hiding a caret / muting a selection).

enabled: bool

Effective enabled state of the item being painted (derived from ItemFlags::IS_ENABLED). Forwarded to [ColorProp::resolve] so a role-based colour picks its disabled variant on a disabled item.

Implementations

impl<'a> SceneItemPaintContext<'a>

pub fn new( view_transform: Transform2D, dirty_scene_rect: Option<Rect>, theme: &'a Theme, ) -> Self

Construct a paint context with the given view transform, optional dirty region, and the active theme. text_scale defaults to 1.0, window_active and enabled to true; use the with_* builders to carry the accessibility scale, window-active state, and per-item enabled state from the widget paint pass.

pub fn with_text_scale(self, text_scale: f32) -> Self

Set the global accessibility text-scale factor carried to opted-in items.

pub fn with_window_active(self, window_active: bool) -> Self

Set whether the host window is currently active (focused and unoccluded).

pub fn with_enabled(self, enabled: bool) -> Self

Set the effective enabled state of the item being painted.

Trait Implementations

impl<'a> Clone for SceneItemPaintContext<'a>

fn clone(&self) -> SceneItemPaintContext<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for SceneItemPaintContext<'a>