Struct Scene 

pub struct Scene {
    pub graph: Option<RenderGraph>,
    pub hits: Vec<HitRegion>,
    pub next_hit_z: usize,
    pub node_index: HashMap<usize, usize, RandomState>,
    /* private fields */
}

The retained render graph of a window together with the hit targets built from it.

Fields

graph: Option<RenderGraph>

The retained render graph, or None before the first build.

hits: Vec<HitRegion>

Hit targets in draw order, the last drawn at the end.

next_hit_z: usize

Draw order index that the next pushed hit target receives.

node_index: HashMap<usize, usize, RandomState>

Position in hits of the target of each node, for finding a target by node id.

Implementations

impl Scene

pub fn new() -> Scene

Creates an empty scene with no graph and no hit targets.

pub fn diagnostics(&self) -> &RenderDiagnostics

The diagnostics shared by the scene and its hit targets.

pub fn rebuild_from_applier(&mut self, applier: &MemoryApplier, root: usize)

Rebuilds the retained graph and hit targets from the applier, reusing storage from the previous graph.

pub fn update_from_applier( &mut self, applier: &MemoryApplier, root: usize, updates: SceneUpdates<'_>, refresh_hits: bool, )

Applies content and layer-property changes to the retained graph. Empty updates or an unavailable scoped update rebuild the scene. Hit targets are refreshed when their geometry changes or refresh_hits is true, as required after layout or pointer-handler changes.

pub fn push_hit( &mut self, node_id: usize, capture_path: &[usize], geometry: HitGeometry<'_>, target: HitTargetSpec<'_>, )

Adds an interactive target in draw order, ignoring targets that neither handle a pointer nor name a pointer icon.

pub fn clear_hits(&mut self)

Removes all hit targets and releases their handlers while retaining vector capacity.

pub fn replace_graph(&mut self, graph: RenderGraph)

Replaces the retained render graph and leaves the hit targets as they are.

Trait Implementations

impl Default for Scene

fn default() -> Scene

Returns the “default value” for a type.

impl HitGraphSink for Scene

fn push_hit( &mut self, node_id: usize, capture_path: &[usize], geometry: HitGeometry<'_>, hit: &HitTestNode, )

Records an interactive node. capture_path lists the node first and then its pointer-input ancestors from the nearest outward, and geometry is in window space.

impl RenderScene for Scene

type HitTarget = HitRegion

The hit target type that hit testing returns.

fn clear(&mut self)

Removes the render graph and all hit targets.

fn hit_test(&self, x: f32, y: f32) -> Vec<<Scene as RenderScene>::HitTarget>

Performs hit testing at the given coordinates. Returns hit targets ordered by z-index (top-to-bottom).

fn hit_test_near( &self, x: f32, y: f32, ) -> Option<<Scene as RenderScene>::HitTarget>

The one target a press reaches when it misses every target but lands inside a small target grown to the minimum touch size: the nearest such target, and none when the point is outside every grown target.

fn find_target( &self, node_id: usize, ) -> Option<<Scene as RenderScene>::HitTarget>

Finds a hit target by NodeId with fresh geometry from the current scene.

fn collect_retained_visual_observation_nodes( &self, nodes: &mut HashSet<usize, RandomState>, ) -> bool

Replaces the set with retained visual observation owners, preserving its capacity. Returns whether the scene provides this information.

fn hit_test_nodes(&self, x: f32, y: f32) -> Vec<usize>

Returns NodeIds of all hit regions at the given coordinates. This is a convenience method equivalent to hit_test().map(|h| h.node_id()).